MCP pour agents IA

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

https://<domaine-plateforme>/mcp

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

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

Claude

Pour Claude Code, ajoutez un serveur HTTP MCP :

claude mcp add --transport http tealband https://<domaine-plateforme>/mcp

Ouvrez Claude Code et exécutez /mcp, puis passez par OAuth dans le navigateur. Si nécessaire, démarrez la connexion depuis le terminal avec :

claude mcp login tealband

Codex

Ajoutez un serveur HTTP Streamable :

codex mcp add tealband --url https://<domaine-plateforme>/mcp

Ensuite, connectez-vous via OAuth :

codex mcp login tealband

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": {
    "tealband": {
      "type": "remote",
      "url": "https://<domaine-plateforme>/mcp",
      "enabled": true
    }
  }
}

Lors de la première utilisation, OpenCode proposera de s'authentifier. Vous pouvez lancer OAuth manuellement ainsi :

opencode mcp auth tealband

OpenClaw

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

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

Démarrez la connexion et vérifiez la connectivité :

openclaw mcp login tealband
openclaw mcp doctor tealband --probe

Si login a renvoyé un code de confirmation, terminez la connexion avec :

openclaw mcp login tealband --code <code>

Si vous éditez la configuration manuellement, le format est le suivant :

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

Hermes

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

mcp_servers:
  tealband:
    url: "https://<domaine-plateforme>/mcp"
    auth: oauth

Lancez Hermes. Lors de la première connexion, il ouvrira OAuth dans le navigateur et sauvegardera 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 n'obtient que les scopes confirmés :

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

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

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 des données anonymisées et des 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 destiné aux agents IA qui ont besoin d'outils, de ressources, d'invites, d'OAuth et de scopes spécifiques.