MCP et IA

Le MCP direct d'une installation

Chaque logiciel a son propre serveur MCP, ouvert aux clés d'API de son compte — pour Claude Code, Cursor, n8n et vos scripts.

En plus de la passerelle de votre espace, chaque logiciel sert son propre serveur MCP. On s'y connecte avec une clé d'API du logiciel : les outils visibles sont ceux que les droits de la clé ouvrent (une clé « Lecture seule » ne voit que les outils de lecture).

Logiciel	Adresse	Clé
Lead Empire	`https://<votre-installation>/mcp`	`le_…`, créée dans Réglages → Compte et équipe → Clés API
Media Empire	`https://media.successarchitect.fr/mcp`	`yft_…`, créée dans Réglages → API
Mail Empire	`https://<votre-installation>/mcp`	`me_…`, créée dans Paramètres → API

Claude Code#

Terminal

claude mcp add --transport http lead-empire https://votre-installation.example/mcp \
  --header "Authorization: Bearer le_..."

claude mcp add --transport http media-empire https://media.successarchitect.fr/mcp \
  --header "Authorization: Bearer yft_..."

claude mcp add --transport http mail-empire https://votre-installation.example/mcp \
  --header "Authorization: Bearer me_..."

L'adresse de Mail Empire est celle de votre installation Mail Empire (« Ouvrir Mail Empire » dans votre espace), différente de celle de votre Lead Empire.

Cursor#

JSON

{
  "mcpServers": {
    "lead-empire": {
      "url": "https://votre-installation.example/mcp",
      "headers": { "Authorization": "Bearer ${env:LEAD_EMPIRE_KEY}" }
    },
    "media-empire": {
      "url": "https://media.successarchitect.fr/mcp",
      "headers": { "Authorization": "Bearer ${env:MEDIA_EMPIRE_KEY}" }
    },
    "mail-empire": {
      "url": "https://votre-installation.example/mcp",
      "headers": { "Authorization": "Bearer ${env:MAIL_EMPIRE_KEY}" }
    }
  }
}

n8n et vos scripts#

Un client MCP « HTTP streamable » avec l'en-tête Authorization. Exemple d'appel brut à Lead Empire, révision 2026-07-28 :

Terminal

curl -s -X POST "$LE_URL/mcp" \
  -H "Authorization: Bearer $LE_CLE" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: tools/call" -H "Mcp-Name: lead_search_local" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lead_search_local","arguments":{"department":"69","naf":"10.71"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Le protocole#

Transport : Streamable HTTP, POST seulement, sans état (aucune session attribuée), réponses JSON. GET et DELETE répondent 405.
Révisions : 2026-07-28 (avec server/discover) et, pour les clients plus anciens, 2025-11-25, 2025-06-18 et 2025-03-26 (avec initialize).
Méthodes : server/discover, initialize, ping, tools/list, tools/call. Un message par requête (pas de lot).
En-têtes de la révision 2026-07-28 : MCP-Protocol-Version, Mcp-Method et Mcp-Name (pour tools/call) sont obligatoires et doivent correspondre au corps.

Les erreurs#

Erreur	Quand
HTTP `401`, en-tête `WWW-Authenticate: Bearer`	Clé absente ou refusée
HTTP `403`	Origine web non admise, compte inactif, « Tout arrêter », droit insuffisant (`insufficient_scope`)
HTTP `429`, `Retry-After`	Trop d'appels
`-32020` (HTTP 400)	Un en-tête MCP manque ou ne correspond pas au corps
`-32022` (HTTP 400)	Révision non prise en charge ; la liste des révisions acceptées est rendue
`-32601`	Méthode inconnue
`-32602`	Outil inconnu, ou paramètres invalides (un paramètre non déclaré est refusé)

Un refus métier — droit manquant, plafond du jour, quota, liste introuvable — n'est pas une erreur de protocole : le résultat de l'outil porte isError: true et un message clair, pour que votre IA puisse vous l'expliquer.

Les limites#

Lead Empire : 120 appels par minute au plus par clé, 3 000 appels d'outils par jour et par compte, plus les plafonds de l'IA réglés par l'Admin.
Media Empire : le débit de la clé (60 par minute par défaut), plus les plafonds de l'IA réglés par l'administrateur.
Mail Empire : le débit de la clé (60 par minute par défaut, de 10 à 600), 3 000 appels d'outils par jour et par espace, 50 actions en attente d'un clic au plus, plus les plafonds « sans clic » réglés par l'Admin. Voir l'API de Mail Empire.

Les règles de ce que l'IA peut faire seule sont les mêmes que par la passerelle : voir les garde-fous.