--- title: 'MCP pour les agents IA' description: 'Comment connecter Claude, Codex, OpenCode, OpenClaw ou Hermes à la plateforme via MCP.' type: doc locale: fr canonical: 'https://yoseno.com/fr/docs/integrations/mcp-agent' updated: '2026-07-30' --- # MCP pour les agents IA Comment connecter Claude, Codex, OpenCode, OpenClaw ou Hermes à la plateforme via MCP. 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 : ```txt https:///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 : ```bash claude mcp add --transport http platform https:///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 : ```bash claude mcp login platform ``` ## Codex Ajoutez un serveur Streamable HTTP : ```bash codex mcp add platform --url https:///mcp ``` Puis effectuez l'authentification OAuth : ```bash codex mcp login platform ``` Dans Codex CLI, l'état de la connexion est visible via `/mcp`. ## OpenCode Ajoutez le serveur dans `opencode.json` : ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "platform": { "type": "remote", "url": "https:///mcp", "enabled": true } } } ``` À la première utilisation, OpenCode proposera de vous authentifier. Vous pouvez lancer OAuth manuellement ainsi : ```bash opencode mcp auth platform ``` ## OpenClaw Enregistrez le serveur MCP en tant que Streamable HTTP et activez OAuth : ```bash openclaw mcp add platform \ --url https:///mcp \ --transport streamable-http \ --auth oauth ``` Lancez la connexion et vérifiez l'état de la connexion : ```bash openclaw mcp login platform openclaw mcp doctor platform --probe ``` Si `login` renvoie un code de confirmation, terminez la connexion avec la commande : ```bash openclaw mcp login platform --code ``` Si vous modifiez le fichier de configuration manuellement, le format est le suivant : ```json { "mcp": { "servers": { "platform": { "url": "https:///mcp", "transport": "streamable-http", "auth": "oauth" } } } } ``` ## Hermes Ajoutez le serveur dans `~/.hermes/config.yaml` : ```yaml mcp_servers: platform: url: "https:///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 : ```txt /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](https://yoseno.com/fr/docs/integrations/api-tokens.md). MCP est précisément destiné aux agents IA, pour lesquels les tools, resources, prompts, OAuth et des scopes spécifiques sont importants. ## Pages liées - [Jetons API](https://yoseno.com/fr/docs/integrations/api-tokens.md) — Jetons personnels et accès bearer à \`/api/v1\`. - [Crédits et limites](https://yoseno.com/fr/docs/account/billing-plans.md) — Crédits, achats, abonnement et comportement des fonctionnalités IA en cas de solde insuffisant. - [REST API](https://yoseno.com/fr/docs/integrations/rest-api.md) — Jetons, accès Bearer, exemple de requête et liens vers la référence OpenAPI. ## À lire ensuite - [REST API](https://yoseno.com/fr/docs/integrations/rest-api.md) — Jetons, accès Bearer, exemple de requête et liens vers la référence OpenAPI.