Les tools MCP comme API Contracts : documentez ce que vos agents peuvent faire
Il y a quelques mois, nous avons lancé les API Contracts : les specs OpenAPI, gRPC, GraphQL et AsyncAPI, liées directement aux éléments C4 qui les implémentent et les consomment. L'idée était simple — la description précise et lisible par une machine d'une interface a sa place à l'intérieur de votre architecture, pas dans une page Notion que personne ne met à jour.
Il restait une interface que nous n'avions pas couverte. La plus récente. Celle que vos services exposent de plus en plus, non pas à d'autres services, mais aux agents IA : MCP.
Un serveur MCP publie un ensemble de tools — chacun avec un nom, une description et un JSON Schema pour ses entrées. C'est un contrat. C'est le contrat qui décide de ce qu'un agent a le droit de faire à votre système. Et jusqu'à aujourd'hui, il était totalement invisible dans votre documentation d'architecture.
Plus maintenant. MCP est désormais un type d'API Contract à part entière dans Archyl — le cinquième, aux côtés de HTTP, gRPC, GraphQL et AsyncAPI.
Le point difficile : les tools MCP ne vivent pas dans un fichier
Les quatre autres types de contrats partagent une hypothèse — il existe un fichier de spec dans un dépôt. openapi.yaml. schema.graphql. Vous pointez Archyl dessus et nous l'affichons.
MCP casse ce modèle. Les tools d'un serveur MCP sont définis dans le code, et la liste complète et faisant autorité n'existe qu'au runtime, quand un client appelle tools/list et reçoit le schéma de chaque tool. Il n'y a pas de mcp.yaml universel à pointer.
Nous avons donc construit deux entrées.
Deux façons d'ajouter un contrat MCP
Collez-le. Si vous avez déjà votre sortie tools/list, collez-la. Archyl la valide et affiche chaque tool — sa description, et ses paramètres d'entrée sous forme de tableau lisible.
Ou donnez-nous simplement l'URL. Indiquez à Archyl où se trouve votre serveur MCP, ajoutez éventuellement un token d'accès (en header ou en paramètre d'URL), et cliquez sur Découvrir les tools. Archyl se connecte, effectue le handshake, et récupère automatiquement chaque tool et paramètre. Pas de copier-coller, pas de fichier maintenu à la main.
Comment fonctionne la découverte live — et pourquoi c'est sûr
La découverte se fait dans votre navigateur, pas sur nos serveurs. Quand vous cliquez sur Découvrir les tools, votre navigateur parle directement à votre serveur MCP.
Ce choix compte :
- Votre token ne quitte jamais votre navigateur. Archyl stocke les tools découverts et les détails de connexion — l'URL, le transport, où va le token — mais jamais le token lui-même.
- Aucun accès côté serveur à votre réseau. Comme l'appel provient de votre machine, impossible de le détourner vers les services internes de quelqu'un d'autre. Toute la catégorie de risques de type SSRF n'existe tout simplement pas ici.
- Il atteint localhost et les serveurs privés. Vous testez un serveur qui tourne sur votre poste ou dans votre réseau ? Ça marche, parce que c'est votre navigateur qui le voit.
Le seul compromis, c'est le CORS : un serveur tiers doit autoriser l'origine d'Archyl pour que votre navigateur puisse lire la réponse. Pour les serveurs que vous contrôlez, c'est une ligne de config ; pour les autres, l'option « coller » est toujours là.
Lié à votre architecture, comme tout autre contrat
Une fois en place, un contrat MCP se comporte comme les autres. Liez-le au container ou au composant qui héberge le serveur. Parcourez chaque tool et son schéma d'entrée. Re-découvrez-le quand le serveur change. Il apparaît à côté de vos contrats REST et GraphQL, parce que pour les agents qui l'appellent, c'est une API tout aussi réelle.
Cela transforme votre contrat MCP en quelque chose de véritablement nouveau : une carte de ce que vos agents IA ont le droit de faire à une partie donnée de votre système — documentée, liée et relisible.
Nous l'utilisons sur nous-mêmes
Archyl est lui-même un serveur MCP — 178 tools qui vous permettent de piloter votre architecture depuis Claude Code, Cursor ou n'importe quel client MCP. Le premier contrat MCP que nous avons créé était le nôtre : pointer Archyl vers son propre endpoint, découvrir les 178 tools, le lier à la plateforme. Notre surface d'agent se documente désormais elle-même.
Essayez
Ouvrez un projet, allez dans API Contracts, créez-en un nouveau, et choisissez MCP. Collez votre tools/list, ou déposez une URL et cliquez sur Découvrir les tools.
Vos services parlent déjà aux agents. Maintenant votre architecture sait ce qu'ils se disent.