
Mettre à jour dix fiches, publier un article préparé la veille, ranger des médias dans la bonne catégorie : ce sont de petits gestes, mais ils s'accumulent. Le MCP Payload 4 change la donne : votre assistant IA se branche sur le site et fait ces gestes lui-même, dans le cadre que vous avez fixé. Ce guide montre comment le brancher, ce que l'assistant a le droit de faire, et quelles consignes il lit avant d'écrire.
Chez Beease, nous activons le MCP sur presque tous les projets clients, surtout les nouveaux. C'est même devenu un des arguments qui comptent le plus quand nous présentons un site. Voici le réglage que nous utilisons.
Ce que vous faites faire à un assistant avec le MCP Payload 4
En une phrase : le MCP permet à votre assistant d'appeler votre site Payload directement.
Concrètement, l'assistant peut lire la structure de vos contenus, chercher des documents, en créer, les modifier et déposer des fichiers. Il ne devine pas la forme d'une page : il demande au site le schéma de la collection, puis il remplit les champs comme le ferait un rédacteur dans l'admin.
Pour une direction marketing, le bénéfice est simple : une demande en langage naturel (« mets à jour les dates de l'événement sur les trois pages concernées ») devient une action sur le site, sans copier-coller entre un document et l'admin. Pour un chef de projet, c'est un moyen de faire passer des lots de contenu (import, corrections en série, traductions à relire) sans reprise à la main.
L'assistant ne contourne pas le CMS. Il passe par les mêmes collections, les mêmes champs, les mêmes règles que vos rédacteurs. C'est ce qui rend le résultat propre.
Ce qui change par rapport au MCP de Payload 3
Si vous avez déjà utilisé le MCP sur un site Payload 3, la logique reste la même. La mise en place, elle, est beaucoup plus légère.
Dans la version 3, chaque collection s'activait à la main, avec ses propres outils et une clé à créer. Les consignes pour l'assistant se rédigeaient dans la config, donc côté développeur.
Dans Payload 4, tout passe par des outils génériques valables pour toutes les collections et tous les globals : getConfigInfo, getCollectionSchema, findDocuments, createDocuments, updateDocument, deleteDocuments, getUploadInstructions, getGlobalSchema, findGlobal, updateGlobal. L'assistant découvre le site au lieu de dépendre d'une liste préparée à la main.
Payload 3
Payload 4
MCP
Activation
Collection par collection dans la config
mcpPlugin({}) couvre collections et globals
Nom des outils
Un outil par collection (findPosts…)
Outils génériques (findDocuments…)
Clé / connexion
Collection API Keys, header Bearer
Connexion OAuth, ou clé portée par l'utilisateur
Instructions
Descriptions dans la config du plugin
llmInstructions, modifiables dans l'admin
Fichiers
Pas de flux d'upload dédié
L'agent dépose les fichiers lui-même
Deux changements comptent au quotidien : les instructions se modifient dans l'admin, et l'agent peut maintenant déposer des fichiers lui-même.
Brancher le plugin et votre client
Côté site, une ligne suffit dans la config Payload :
1
2
3
4
5
6
7
import { buildConfig } from 'payload'
import { mcpPlugin } from '@payloadcms/plugin-mcp'
export default buildConfig({
// collections, globals, db…
plugins: [mcpPlugin({})],
})Côté assistant, on déclare un serveur MCP de type http. Sur un poste de développement, le client pointe vers le site local :
1
2
3
4
5
6
7
8
{
"mcpServers": {
"payload": {
"type": "http",
"url": "http://127.0.0.1:3000/api/mcp?overrideAccess=true"
}
}
}Le paramètre overrideAccess=true fait sauter le contrôle d'accès : pratique en local, sans clé à créer. C'est le mode que nous utilisons volontiers pendant la construction d'un site, et il nous convient tel quel.
Sur le site en ligne, on retire ce paramètre (le serveur refuse cette URL hors développement). La personne se connecte alors normalement. Sans authentification, le serveur propose une connexion OAuth, active par défaut : vous vous connectez à l'admin Payload, vous autorisez le client, et le jeton reçu ne sert qu'au MCP.
Si vous préférez une clé, elle se porte désormais sur l'utilisateur, avec auth.useAPIKey sur la collection d'authentification. Le client envoie alors le header Authorization: users API-Key suivi de la clé, où users est le slug de cette collection. Il n'y a plus de collection séparée pour les clés MCP.
Pour résumer : la personne passe du poste de dev au site réel, et la connexion change avec elle.
Ouvrir le contenu, fermer la suppression et les comptes
C'est là que les tutoriels s'arrêtent et que le réglage fait la différence.
Par défaut, mcpPlugin({}) expose toutes les collections. Notre réflexe chez Beease n'est pas de tout restreindre par prudence. C'est l'inverse : ouvrir un maximum de ce qui relève du contenu, pour que l'agent fasse le geste lui-même. Une collection fermée, c'est une action qui reviendra à quelqu'un, à la main.
La règle Beease : ouvrir le contenu le plus largement possible (pages, articles, médias, catégories, réglages éditoriaux) pour que l'agent publie, mette à jour et range sans reprise manuelle. Fermer souvent la suppression et la collection des comptes.
En pratique, cela donne une config de ce type :
1
2
3
4
5
6
7
8
9
10
mcpPlugin({
collections: {
pages: { tools: { delete: false } },
posts: { tools: { delete: false } },
users: {
tools: { create: false, update: false, delete: false },
// login, auth, forgotPassword… restent fermés tant qu'on ne les passe pas à true
},
},
})Pourquoi fermer delete ? Parce qu'une suppression est rarement urgente, et qu'elle se fait très bien dans l'admin. L'agent crée, corrige, enrichit ; la décision de retirer un contenu reste humaine.
Pourquoi la collection users ? Parce qu'elle ne contient pas de contenu éditorial. Les outils d'authentification (login, auth, forgotPassword, resetPassword, unlock, verify) sont déjà fermés tant qu'on ne les active pas : on ne les active pas.
L'option access reste un réglage possible, ni obligatoire, ni notre réglage habituel.
Écrire les instructions que l'agent lit avant d'agir
Un assistant bien branché mais mal briefé produit du contenu techniquement valide et éditorialement à côté. Le champ llmInstructions règle ce problème.
Il se pose sur une collection ou un global, en Markdown. Quand l'agent appelle getCollectionSchema ou getGlobalSchema, il reçoit ces instructions avec le schéma. Il doit donc les lire avant de créer ou de modifier quoi que ce soit.
1
2
3
4
5
6
7
8
9
10
11
12
13
import type { CollectionConfig } from 'payload'
export const Posts: CollectionConfig = {
slug: 'posts',
llmInstructions: `
- Garder les blocs de mise en page prévus pour les articles, ne pas en inventer.
- Titres courts, un seul message par titre.
- Remplir l'extrait et les champs SEO à chaque création.
`,
fields: [
// …
],
}La valeur posée dans le code sert de point de départ. Ensuite, l'équipe contenu les ajuste directement dans l'admin, via « Edit LLM instructions ». C'est le bon endroit pour votre charte éditoriale appliquée à chaque collection : ton, longueur des titres, blocs autorisés, champs à ne jamais laisser vides.
Créer, modifier, déposer un fichier
Une fois branché, l'agent crée des contenus, les corrige et dépose des fichiers. Il peut en traiter plusieurs d'un coup, ou chercher une série de pages et les mettre à jour une par une.
Votre site est multilingue ? Il lit et écrit dans la langue demandée, selon votre contenu multilingue.
Pour un fichier, une URL déjà en ligne ou une pièce jointe suffit : l'agent le dépose dans la médiathèque et le rattache au contenu.
Le faire installer sur votre site
Le MCP Payload 4 tient en peu de configuration. Ce qui fait la différence, ce sont les choix autour : quelles collections ouvrir, ce qu'on ferme, comment passer du local au site en ligne, et surtout quelles instructions donner à l'agent pour que le contenu produit respecte votre charte.
C'est ce que nous réglons sur nos projets, et nous pouvons le faire sur le vôtre : une démo pour voir un assistant agir sur un site Payload, ou l'installation et le réglage du MCP directement chez vous.
Vous envisagez une refonte ou un nouveau site ? Découvrez notre accompagnement pour les sites sur Payload CMS, avec le MCP prévu dès la mise en ligne.


