MCP et Payload CMS : brancher Claude sur votre back-office sans lui donner les clés
Brancher Claude sur un back-office Payload CMS par le Model Context Protocol (MCP) prend une journée avec le plugin officiel. Le faire sans risque demande un peu plus de réflexion : décider ce que l'assistant a le droit de lire et d'écrire, le traiter comme un utilisateur du CMS plutôt que comme un administrateur, et tracer chacune de ses actions. Voici les deux façons de faire que nous utilisons en production, avec le code qui va avec.
Cet article prolonge notre présentation de Payload CMS comme back-office sur mesure. Il s'adresse aux équipes qui veulent passer à l'acte : responsables de site, directions marketing, développeurs.
Les deux cas de cet article
edyma.fr utilise le plugin MCP officiel de Payload. BatiSalon, l'annuaire des professionnels du bâtiment, a un serveur MCP écrit sur mesure. Les deux tournent sur Payload 3, Next.js et PostgreSQL. EDYMA, qui édite BatiSalon, est par ailleurs partenaire de Yuukoo.
MCP en deux minutes
Le Model Context Protocol est un protocole ouvert, publié par Anthropic fin 2024 et repris depuis par la plupart des assistants. Il sépare deux rôles. Le client est l'assistant — Claude, ou un agent que vous avez construit. Le serveur est l'application qui expose des outils : ici, votre CMS.
Le dialogue est simple. L'assistant demande la liste des outils, avec pour chacun un nom, une description et les paramètres attendus. Quand l'utilisateur lui demande « ajoute l'actualité de ce fabricant à partir de son communiqué », l'assistant choisit les outils utiles, les appelle dans l'ordre et lit les réponses. Il ne touche jamais la base de données : il ne voit que ce que le serveur lui montre.
C'est cette frontière qui rend MCP intéressant pour un CMS. L'assistant ne reçoit pas un accès à la base, mais un ensemble de gestes autorisés, que le serveur contrôle un par un.
Pourquoi Payload s'y prête particulièrement
Brancher un assistant sur un CMS revient à lui donner un compte. Encore faut-il que le CMS sache restreindre finement ce compte. Payload a quatre propriétés qui font l'essentiel du travail :
- Le contrôle d'accès est écrit en code, collection par collection et champ par champ. Une règle comme « ce champ n'est modifiable que sur un brouillon » tient en quelques lignes et s'applique à tous les points d'entrée, MCP compris.
- Les clés d'API sont natives. Une collection d'utilisateurs peut s'authentifier par clé, sans mot de passe ni accès à l'interface d'administration.
- Les hooks s'exécutent avant et après chaque opération. C'est là qu'on force un brouillon, qu'on refuse une publication ou qu'on écrit dans un journal.
- Les versions et les brouillons sont intégrés : l'assistant peut proposer, un humain relit et publie.
Voie 1 : le plugin officiel, sur edyma.fr
EDYMA voulait que son équipe puisse demander à Claude de rédiger un article, d'enrichir une FAQ ou de préparer une fiche de réalisation, sans jamais laisser l'assistant publier. C'est un besoin éditorial classique : le plugin @payloadcms/plugin-mcp y répond directement.
La configuration
On déclare les collections exposées et, pour chacune, les opérations permises. Trois collections sont ouvertes en lecture et en écriture, deux en lecture seule, et la suppression est fermée partout :
const lectureEcriture = { find: true, create: true, update: true, delete: false }
const lectureSeule = { find: true, create: false, update: false, delete: false }
export const configMCP: MCPPluginConfig = {
userCollection: 'users',
collections: {
articles: { enabled: lectureEcriture, description: 'Articles de fond…' },
faq: { enabled: lectureEcriture, description: 'Questions fréquentes, réponses courtes.' },
realisations: {
enabled: lectureEcriture,
description: 'Cas clients. Jamais de chiffre ni de citation inventés.',
},
metiers: { enabled: lectureSeule, description: 'Les six métiers d’EDYMA (lecture seule).' },
pages: { enabled: lectureSeule, description: 'Pages du site (lecture seule).' },
},
}
Les descriptions ne sont pas décoratives : l'assistant les lit pour savoir quoi faire. « Jamais de chiffre ni de citation inventés » est une consigne de rédaction donnée au modèle, au plus près de l'outil qu'il utilise.
Une clé liée à un compte « assistant IA »
Le plugin gère une collection de clés MCP. Nous l'avons resserrée : seule l'équipe crée ou révoque une clé, et chaque clé doit être liée à un utilisateur au rôle « assistant IA ». Une clé ne peut donc jamais porter les droits d'un membre de l'équipe. Ce compte, lui, ne peut pas se connecter à l'interface d'administration.
Le brouillon forcé, par hook
Le plugin applique les droits de la collection. Pour aller plus loin, deux hooks Payload suffisent. Le premier transforme toute écriture de l'assistant en brouillon, même s'il demande autre chose. Le second refuse toute tentative de publication :
export const forcerBrouillonIA: CollectionBeforeOperationHook = ({ args, operation, req }) => {
if (estAssistantIA(req) &&
(operation === 'create' || operation === 'update' || operation === 'restoreVersion')) {
return { ...args, draft: true }
}
return args
}
export const interdirePublicationIA: CollectionBeforeChangeHook = ({ data, req }) => {
if (estAssistantIA(req) && data?._status === 'published') throw new Forbidden(req.t)
return data
}
Un troisième hook inscrit chaque création ou modification dans un journal que personne, pas même l'équipe, ne peut modifier. Le résultat : l'assistant prépare, un humain relit et publie, et l'on sait toujours qui a écrit quoi.
Ce que le plugin fait moins bien
Les outils générés sont génériques : chercher, créer, modifier un document d'une collection. L'assistant doit comprendre seul la structure des données et les règles du métier. Pour un blog ou une FAQ, ce n'est pas un problème. Pour un annuaire de plusieurs centaines d'entreprises, où créer un doublon coûte cher, il faut des gestes plus précis.
Voie 2 : un serveur sur mesure, sur BatiSalon
BatiSalon présente les fabricants du bâtiment comme un salon permanent. L'équipe y ajoute des exposants, des actualités et des salons professionnels. Les risques ne sont pas éditoriaux mais structurels : une même entreprise créée deux fois, une adresse publique modifiée par erreur, une actualité publiée en double. Nous avons donc écrit un serveur MCP propre au métier.
Des outils qui parlent le métier
| Outil | Ce qu'il fait |
|---|---|
chercher_stand | Cherche une fiche exposant par nom, ville ou adresse. À appeler avant toute création. |
enregistrer_stand | Crée une fiche, ou met à jour une fiche existante si sa référence est fournie. |
completer_brouillon | Complète les champs administratifs, uniquement sur une fiche en brouillon. |
placer_stand_sur_salon | Rattache un exposant à un salon. Rejouer l'appel ne crée rien en double. |
enregistrer_actualite | Publie l'actualité d'un exposant. |
illustrer_actualite | Génère le visuel de l'actualité côté serveur. |
enregistrer_salon | Crée ou met à jour un salon professionnel. |
statistiques_stand | Consulte les statistiques d'une fiche, en lecture seule. |
Chaque description dit à l'assistant comment se comporter, pas seulement ce que fait l'outil. Celle de chercher_stand commence par « À APPELER SYSTÉMATIQUEMENT avant enregistrer_stand ». Les instructions générales du serveur, que l'assistant reçoit à la connexion, rappellent la même règle et précisent que les adresses publiques ne sont jamais modifiables.
Des refus qui apprennent au modèle à se corriger
Quand l'assistant tente de créer une entreprise qui ressemble à une fiche existante, le serveur refuse et renvoie les candidats, avec la marche à suivre :
Création refusée : « Durand Menuiserie » ressemble à 2 fiche(s) existante(s).
- Durand Menuiseries SARL — reference: "durand-menuiseries", Lyon
- Menuiserie Durand — reference: "menuiserie-durand", Annecy
Si c'est l'une d'elles, rappeler enregistrer_stand avec son « reference ».
Si c'est bien une entreprise différente, le préciser dans « nom »
de façon distinctive (raison sociale complète, ville).
L'exemple est fictif, la formulation est celle du serveur. Ce refus est renvoyé comme une erreur d'outil, pas comme une panne : l'assistant le lit, choisit la bonne fiche et rappelle l'outil. C'est la différence entre un garde-fou qui bloque et un garde-fou qui guide.
Le protocole, sans dépendance
Le serveur tient dans une route Next.js, /api/mcp. Il n'implémente que ce dont il a besoin : l'initialisation, la liste des outils, leur appel et le ping. Le cœur métier — les outils et leurs règles — reste dans le code du projet, à côté des collections qu'il manipule. Quand le protocole évolue, une seule route est à mettre à jour.
Les garde-fous de BatiSalon
- Un compte par agent. Une collection
agentss'authentifie uniquement par clé d'API, sans connexion à l'administration. Chaque agent a un statut actif ou non, une liste de collections autorisées et un plafond d'écritures par heure. - Les droits du CMS s'appliquent. Chaque écriture passe par le contrôle d'accès de Payload avec l'agent comme utilisateur, jamais en contournant les règles.
- Des champs fermés. L'adresse publique d'une fiche n'est jamais modifiable par un agent. L'offre commerciale et les identifiants légaux ne le sont que tant que la fiche est un brouillon.
- Aucune suppression. Un agent ne peut rien effacer.
- Les erreurs coûteuses refusées. Doublons de fiches, actualité au même titre dans les trente derniers jours : refusés. Une fiche trop incomplète part en brouillon, et une mise à jour ne dépublie jamais une fiche en ligne.
- Tout est tracé. Chaque contenu sait s'il vient d'un humain, d'un import ou d'un agent, et un journal que personne ne peut modifier garde chaque action, refus compris.
Contrairement à EDYMA, les agents de BatiSalon peuvent publier une fiche complète. C'est un choix de l'éditeur : sur un annuaire, une fiche vérifiée doit être en ligne vite, et ce sont les règles du serveur, plus que la relecture, qui garantissent sa qualité.
Plugin officiel ou serveur sur mesure ?
| Plugin officiel | Serveur sur mesure | |
|---|---|---|
| Mise en place | Rapide : une configuration | Plus longue : chaque outil est écrit |
| Outils | Génériques, par collection | Gestes métier, nommés comme l'équipe parle |
| Règles métier | Par les droits et les hooks Payload | Dans les outils eux-mêmes, avec des refus explicites |
| Adapté à | Articles, FAQ, pages, cas clients | Annuaires, catalogues, données structurées à fort enjeu |
| Maintenance | Suit les versions de Payload | Une route et des outils à faire évoluer |
Les deux ne s'excluent pas. Un même site peut exposer ses contenus éditoriaux par le plugin et ses opérations sensibles par quelques outils écrits à la main.
La liste de contrôle avant d'ouvrir l'accès
- Un compte dédié à l'assistant, avec sa propre clé, révocable à tout moment.
- Aucun accès à l'interface d'administration pour ce compte.
- Les droits du CMS appliqués à chaque écriture, sans exception.
- La suppression fermée, et les champs sensibles protégés (adresses publiques, prix, identifiants légaux).
- Le brouillon par défaut, ou une décision explicite de laisser publier, collection par collection.
- Un plafond d'écritures, pour qu'une boucle mal engagée ne remplisse pas la base.
- Un journal que personne ne peut réécrire.
- Des descriptions d'outils et des instructions de serveur rédigées comme des consignes de travail.
- Des refus formulés pour que le modèle se corrige, pas seulement pour qu'il s'arrête.
Ce que ça change pour l'équipe
Le gain n'est pas d'avoir un robot qui écrit à la place de l'équipe. Il tient à la disparition de la saisie : copier un communiqué dans le bon champ, retrouver une fiche, rattacher un exposant à un salon, préparer un brouillon d'article à partir de notes. L'équipe décrit ce qu'elle veut à Claude ; les règles du site garantissent que le résultat reste propre.
Ce n'est pas magique pour autant. Un assistant peut se tromper de fiche ou rédiger un texte approximatif. Les garde-fous ne rendent pas l'erreur impossible ; ils la rendent visible, réversible et rare. C'est la même logique que nos agents IA métier : l'IA fait la saisie, l'humain garde la main sur ce qui engage l'entreprise.
Par où commencer
Si votre site tourne déjà sur Payload 3, commencez par le plugin officiel, sur une seule collection, en brouillon forcé. Observez une semaine ce que l'assistant produit et ce que l'équipe en fait. Vous saurez alors si des outils sur mesure se justifient.
Si votre site n'est pas sur Payload, la question est plutôt de savoir si votre back-office mérite d'être repensé : c'est le sujet de notre offre de création et refonte de sites. Et si vous voulez en parler sur votre cas précis, réservez 30 minutes avec nous.