Convertisseur OpenAPI vers MCP

D'un document OpenAPI à un serveur MCP qui fonctionne

Collez ci-dessus un document OpenAPI (ou Swagger) en JSON : le convertisseur associe chaque opération à un outil MCP. L'opération devient le nom de l'outil, son résumé devient la description que lit le modèle, et les paramètres de chemin, de requête et de corps sont aplatis en un seul schéma JSON d'entrée. Vous obtenez les définitions d'outils séparément, plus un serveur FastMCP en Python construit autour, qui tourne dès que vous ajoutez l'authentification.

Toute la conversion se déroule dans votre navigateur. Aucune requête n'est émise, rien n'est envoyé et rien n'est conservé — ce qui compte, car un document OpenAPI décrit très souvent une API interne qui n'a rien à faire sur le serveur de quelqu'un d'autre. Vous pouvez le vérifier dans l'onglet réseau de votre navigateur.

L'erreur que presque tout le monde commet d'abord

Convertir l'API entière est le réflexe évident, et c'est généralement le mauvais. Les définitions d'outils d'un serveur MCP sont envoyées au modèle à chaque tour : quatre-vingts endpoints deviennent donc quatre-vingts descriptions et quatre-vingts schémas dans la fenêtre de contexte de chaque requête, et la capacité du modèle à choisir le bon outil chute nettement à mesure que cette liste grandit.

Commencez par la poignée d'opérations dont un agent a réellement besoin. N'ajoutez que lorsqu'il manque quelque chose. Vous pouvez mesurer précisément ce que coûte une liste d'outils avec le calculateur de tokens MCP.

Ce que le code généré fait, et ne fait pas

• L'authentification n'est pas incluse. Le squelette appelle votre API sans identifiants ; c'est à vous d'ajouter l'en-tête, le jeton ou le flux OAuth.
• Les paramètres de chemin sont des espaces réservés. Ils sont interpolés dans le chemin de la requête, mais vérifiez que chacun substitue bien l'argument attendu.
• Les corps de requête derrière un $ref sont émis comme objet générique plutôt que développés, car les résoudre demande la section components. C'est signalé dans la sortie au lieu de disparaître discrètement.
• JSON uniquement. Un analyseur YAML ne peut être chargé ici sans script tiers, et ce site n'en charge aucun. Exportez d'abord votre spécification en JSON — la plupart des outils le font en une commande.

Outils et guides associés

• Transformer une API REST en serveur MCP — le guide complet, authentification et déploiement compris.
• MCP Inspector — une fois déployé, vérifiez qu'il expose bien ce que vous attendez.
• Scanner de sécurité MCP — une API convertie hérite souvent de paramètres qui méritent un second regard.
• Sécuriser un serveur MCP

Un serveur généré est un point de départ, pas une démonstration

Qu'il tourne prouve que la conversion a fonctionné. Cela n'aide personne d'autre à comprendre à quoi sert le serveur — et un client qui évalue votre intégration MCP ne sait pas lire un fichier Python. Déployez-le, pointez MCP Showcase sur l'URL, et vous obtenez un playground en direct avec une documentation générée par outil, où un prospect essaie la chose dans son navigateur au lieu de devoir vous croire sur parole.