MCP Playground : exécutez les tools de vos agents en live, depuis la doc
La semaine dernière, nous avons fait des tools MCP un API Contract à part entière : pointez Archyl vers un serveur MCP en live, et il découvre chaque tool et son schéma d'entrée, documenté et lié à votre modèle C4 comme n'importe quel contrat REST ou GraphQL.
Cela répondait à la première question : que peuvent faire mes agents ?
Aujourd'hui, nous répondons à la seconde : est-ce que ça fait vraiment ça ?
Voici le MCP Playground — un nouvel onglet sur chaque contrat MCP live qui vous permet d'invoquer n'importe quel tool contre le vrai serveur et d'inspecter le vrai résultat. Pas de client à configurer, pas de JSON-RPC à la main, sans quitter votre documentation d'architecture.
Du schéma au formulaire, automatiquement
Ouvrez un contrat MCP live et vous trouverez un onglet Playground à côté du schéma. Choisissez un tool dans la liste — la même liste consultable que vous avez documentée — et Archyl transforme son inputSchema en formulaire :
- Les chaînes, nombres et booléens deviennent des champs typés.
- Les enums deviennent des listes déroulantes avec les valeurs autorisées.
- Les paramètres obligatoires sont marqués, et validés avant tout envoi.
- Les objets imbriqués et les tableaux ont un champ JSON brut, validé à la soumission.
Remplissez, cliquez sur Exécuter le tool, et le résultat revient avec sa durée — affiché comme un résultat mérite de l'être. Une vue Formaté montre la réponse en JSON propre et indenté. Une vue Arborescence rend les grosses payloads navigables : repliez ce qui ne vous intéresse pas, dépliez le reste. Texte, images et ressources retournés par un tool s'affichent nativement.
Si le tool retourne une erreur, vous voyez exactement ce qu'un agent verrait — le flag d'erreur et la payload, affichés en rouge, jamais avalés.
Votre token ne quitte jamais votre navigateur
Le Playground suit le même modèle de sécurité que la découverte live, et cela mérite d'être répété parce que c'est tout l'intérêt :
Chaque appel part de votre navigateur. Quand vous cliquez sur Exécuter le tool, votre navigateur parle directement à votre serveur MCP. Le backend d'Archyl n'est pas dans le chemin.
- Le token n'est jamais stocké. Vous le saisissez pour la session ; il vit dans la page et nulle part ailleurs.
- Les résultats ne sont jamais persistés. Ce qui revient est affiché, lu, et disparaît quand vous fermez l'onglet.
- Aucun accès côté serveur à votre réseau. Comme la requête part de votre machine, le playground atteint
localhostet les serveurs privés — et il n'existe aucun chemin de requête côté serveur à détourner.
Le seul compromis, comme pour la découverte, c'est le CORS : le serveur cible doit autoriser l'origine d'Archyl. Pour les serveurs que vous contrôlez, c'est une ligne de configuration.
Pourquoi c'est important
Les tools MCP sont l'interface que vos agents IA utilisent réellement. Jusqu'ici, en vérifier un signifiait configurer un client, fabriquer une enveloppe JSON-RPC, ou simplement… faire confiance à la description.
Désormais, la documentation est le banc d'essai :
- Vous passez en revue une surface d'agent ? Exécutez les tools et voyez les vraies formes de réponse, pas celles décrites.
- Vous déboguez l'échec d'un appel d'agent ? Reproduisez-le en deux clics avec exactement les mêmes arguments.
- Vous onboardez quelqu'un sur un service ? Envoyez-lui le contrat — il peut lire chaque tool et l'essayer.
C'est ce que nous entendons par documentation vivante. Une spec qui peut être exécutée ne dérive pas en silence ; elle est démasquée à l'instant où elle ment.
Dogfoodé, comme toujours
Archyl est lui-même un serveur MCP — 181 tools cette semaine. Le premier utilisateur du Playground a été notre propre contrat : nous exécutons list_projects, get_project_c4_model et compagnie contre notre propre endpoint, depuis notre propre doc, tous les jours. La capture ci-dessus, c'est exactement ça.
Essayez-le
Ouvrez un projet → API Contracts → n'importe quel contrat MCP avec un endpoint live → Playground. Saisissez votre token, choisissez un tool, exécutez-le.
Votre documentation d'architecture vient d'apprendre à s'exécuter.