Connecter un autre client MCP

iyedy sert ses 24 outils par le Model Context Protocol. Claude, ChatGPT et les assistants de code (Codex, VS Code avec GitHub Copilot, Zed, Cursor, Gemini CLI) se connectent par OAuth sur son adresse. Tout autre client MCP se connecte à l’adresse de votre organisation avec un jeton d’accès personnel envoyé dans un en-tête.

Deux portes d’entrée

Les deux adresses parlent MCP en Streamable HTTP : sans état, POST seulement, réponses en JSON. Elles offrent les mêmes 24 outils et appliquent les mêmes règles : vos rôles, le plafond de classification, la politique MCP de l’organisation.

Avant de commencer

• Un client MCP capable d’envoyer un en-tête à chaque requête vers un serveur distant en Streamable HTTP.
• Un jeton d’accès personnel avec les portées dont votre client a besoin : cartouche.read pour les outils de lecture, cartouche.graph pour la recherche et l’impact, cartouche.propose pour prévisualiser et soumettre des propositions. Voir Créer et gérer des jetons d’API et Portées.
• Dans une organisation Team ou Enterprise, MCP activé par le support à la demande d’un propriétaire : Claude et MCP pour votre organisation.

Se connecter avec un jeton d’accès personnel

1. Trouver l’identifiant de votre organisation

   Demandez à l’API à qui appartient le jeton. Tout jeton peut appeler cette route :

   GET /v1/token HTTP/1.1
   Host: app.iyedy.com
   Authorization: Bearer crt_pat_…
   

   La réponse donne l’organisation du jeton dans tenantId, et liste les espaces de travail qu’il atteint dans workspaces, chacun avec son id, son name et votre role.

2. Ajouter le serveur à votre client

   Dans les réglages de votre client, ajoutez un serveur MCP distant en HTTP avec :

   • l’adresse https://app.iyedy.com/v1/t/{tenantId}/mcp, où {tenantId} est la valeur de l’étape 1 ;
   • l’en-tête Authorization: Bearer crt_pat_…, avec votre jeton.

   Gardez le jeton dans le coffre à secrets de votre client ou dans une variable d’environnement, jamais dans un fichier que vous versionnez.

3. Vérifier la connexion

   Demandez à votre agent de lister les espaces de travail iyedy, ou appelez l’outil list_workspaces depuis le client.

   C’est prêt quand la réponse liste les espaces de travail de l’étape 1, avec votre rôle dans chacun.

Ce que le jeton peut faire, et ce qu’il ne peut pas faire

• Il agit en tant que vous. Les portées du jeton se combinent à votre rôle : une portée cartouche.propose sur le compte d’un lecteur n’enregistre rien. Un schéma que vous ne pouvez pas lire répond « not found ».
• Il ne modifie jamais un modèle. Par MCP, les seules écritures sont une proposition et son retrait ; une personne applique les propositions dans iyedy. Voir Comment les propositions arrivent à votre équipe.
• Il lit jusqu’au plafond. Confidentiel dans un espace personnel, Interne en Team et Enterprise. Les listes et les recherches restent aussi en dessous.
• Il est refusé dès qu’il est révoqué ou expiré, à la requête suivante. Le révoquer est la façon de déconnecter le client.

Si cela ne fonctionne pas

Pour aller plus loin : Limites de débit et erreurs.