Développement web 9 novembre 2026 · 11 min

MCP et Payload CMS : brancher Claude sur votre back-office sans lui donner les clés

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

OutilCe qu'il fait
chercher_standCherche une fiche exposant par nom, ville ou adresse. À appeler avant toute création.
enregistrer_standCrée une fiche, ou met à jour une fiche existante si sa référence est fournie.
completer_brouillonComplète les champs administratifs, uniquement sur une fiche en brouillon.
placer_stand_sur_salonRattache un exposant à un salon. Rejouer l'appel ne crée rien en double.
enregistrer_actualitePublie l'actualité d'un exposant.
illustrer_actualiteGénère le visuel de l'actualité côté serveur.
enregistrer_salonCrée ou met à jour un salon professionnel.
statistiques_standConsulte 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 agents s'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 officielServeur sur mesure
Mise en placeRapide : une configurationPlus longue : chaque outil est écrit
OutilsGénériques, par collectionGestes métier, nommés comme l'équipe parle
Règles métierPar les droits et les hooks PayloadDans les outils eux-mêmes, avec des refus explicites
Adapté àArticles, FAQ, pages, cas clientsAnnuaires, catalogues, données structurées à fort enjeu
MaintenanceSuit les versions de PayloadUne 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.

Les questions fréquentes sur MCP et Payload CMS

C'est un point d'accès que le CMS expose pour qu'un assistant IA comme Claude puisse y travailler. Le Model Context Protocol (MCP) décrit une liste d'outils — chercher une fiche, créer un brouillon, mettre à jour un article — que l'assistant découvre puis appelle en langage naturel. Le serveur reste maître de ce qui est permis : il authentifie l'assistant, applique les droits du CMS et refuse ce qui sort de son périmètre.

Oui, @payloadcms/plugin-mcp, publié par l'équipe de Payload. On y déclare les collections exposées et, pour chacune, les opérations permises : lecture, création, modification, suppression. Le plugin génère les outils correspondants, gère les clés d'accès et sert le point d'entrée /api/mcp. C'est la voie la plus rapide quand l'assistant doit surtout rédiger et mettre à jour des contenus éditoriaux.

Seulement quand le métier l'exige. Le plugin expose des opérations génériques sur les collections ; un serveur sur mesure expose des gestes métier, comme « chercher une fiche avant d'en créer une » ou « placer un exposant sur un salon », avec des refus explicites quand l'action est risquée. Sur un annuaire ou un catalogue où les doublons coûtent cher, le sur-mesure se justifie. Sur un blog, le plugin suffit.

En la traitant comme un utilisateur du CMS, pas comme un administrateur. Elle se connecte avec sa propre clé, liée à un compte au rôle limité ; ses écritures passent par le contrôle d'accès de Payload ; des hooks forcent le brouillon ou interdisent la publication ; certains champs et la suppression lui sont fermés ; et chaque action est inscrite dans un journal que personne ne peut modifier.

Parlons de votre projet

Nous répondons à tous les messages sérieux en moins de 3 heures ouvrées. Pas d'assistant, pas de formulaire qui disparaît dans le vide.