MCP pour les agents IA

MCP donne à un agent IA externe un accès opérationnel à la plateforme : consulter les analyses, aider à mener les enquêtes et effectuer des actions au nom de l'utilisateur. La connexion se fait via l'endpoint Streamable HTTP :

https://<domaine-de-la-plateforme>/mcp

À la première requête, l'agent ouvre l'authentification OAuth dans le navigateur. Vous voyez quel client demande l'accès et quels scopes il demande. Après confirmation, le client MCP stocke lui-même le jeton ; il n'est pas nécessaire de copier manuellement le secret.

Un seul endpoint fonctionne pour toutes vos organisations. L'organisation active est issue de la session authentifiée ; si l'agent prend en charge le changement d'organisation, il pourra sélectionner une autre organisation disponible.

Claude

Pour Claude Code, ajoutez un serveur MCP HTTP :

claude mcp add --transport http platform https://<domaine-de-la-plateforme>/mcp

Ouvrez Claude Code et exécutez /mcp, puis effectuez l'authentification OAuth dans le navigateur. Si vous devez lancer la connexion depuis le terminal, utilisez :

claude mcp login platform

Codex

Ajoutez un serveur Streamable HTTP :

codex mcp add platform --url https://<domaine-de-la-plateforme>/mcp

Puis effectuez l'authentification OAuth :

codex mcp login platform

Dans Codex CLI, l'état de la connexion est visible via /mcp.

OpenCode

Ajoutez le serveur dans opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "platform": {
      "type": "remote",
      "url": "https://<domaine-de-la-plateforme>/mcp",
      "enabled": true
    }
  }
}

À la première utilisation, OpenCode proposera de vous authentifier. Vous pouvez lancer OAuth manuellement ainsi :

opencode mcp auth platform

OpenClaw

Enregistrez le serveur MCP en tant que Streamable HTTP et activez OAuth :

openclaw mcp add platform \
  --url https://<domaine-de-la-plateforme>/mcp \
  --transport streamable-http \
  --auth oauth

Lancez la connexion et vérifiez l'état de la connexion :

openclaw mcp login platform
openclaw mcp doctor platform --probe

Si login renvoie un code de confirmation, terminez la connexion avec la commande :

openclaw mcp login platform --code <code>

Si vous modifiez le fichier de configuration manuellement, le format est le suivant :

{
  "mcp": {
    "servers": {
      "platform": {
        "url": "https://<domaine-de-la-plateforme>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes

Ajoutez le serveur dans ~/.hermes/config.yaml :

mcp_servers:
  platform:
    url: "https://<domaine-de-la-plateforme>/mcp"
    auth: oauth

Lancez Hermes. Lors de la première connexion, il ouvrira OAuth dans le navigateur et enregistrera les jetons pour les sessions suivantes. Après avoir modifié la configuration dans une session déjà ouverte, exécutez :

/reload-mcp

Accès

L'agent ne reçoit que les scopes autorisés :

analytics:read — consulter les enquêtes, résultats, analyses et axes d'amélioration ;
surveys:write — créer, modifier et publier des enquêtes ;
org:manage — gérer les organisations, paramètres et membres.

Les scopes ne remplacent pas le rôle de l'utilisateur. Si votre rôle ne permet pas d'effectuer une action dans l'organisation, l'agent ne pourra pas non plus l'effectuer.

Limites de requêtes

Les appels à MCP sont protégés par des limites de fréquence :

L'endpoint opérationnel /mcp : 300 requêtes par minute par jeton ou par IP.
Authentification OAuth : 20 requêtes par paire IP + client_id toutes les 5 minutes (120 requêtes par IP).

En cas de dépassement, le serveur renvoie l'erreur rate_limited avec l'indication du temps de pause (retryAfter).

Confidentialité

MCP ne divulgue pas les réponses des participants en contournant les règles de la plateforme. Personne ne voit les réponses brutes ; seules les données anonymisées et les agrégats sont exposés lorsque le nombre de réponses est suffisant (au moins 5). Si les données sont insuffisantes, l'agent obtiendra un résultat limité.

Pour les scripts classiques et les intégrations serveur, utilisez les jetons API. MCP est précisément destiné aux agents IA, pour lesquels les tools, resources, prompts, OAuth et des scopes spécifiques sont importants.