Convertir une API OpenAPI en serveur MCP
Mis à jour le 24 octobre 2026
Voozeo MCP convertit une spécification OpenAPI 3.0 ou 3.1 en serveur MCP hébergé : chaque opération de l'API devient un outil que Claude, ChatGPT, Cursor ou tout client MCP peut appeler, sans code à écrire ni serveur à exploiter.
Comment fonctionne la conversion
- Créez un serveur dans Voozeo et ouvrez son onglet « Sources ».
- Choisissez « Importer une spec OpenAPI », puis envoyez le fichier ou indiquez l'adresse HTTPS publique de la spec.
- Voozeo lit la spec et génère un outil par opération, avec son nom, sa description et ses paramètres.
- Vérifiez les outils, renseignez l'API cible et son authentification, puis essayez un outil dans le bac à sable.
- Collez l'URL du serveur et la clé MCP dans votre client d'IA. Voir comment connecter votre IA.
Réimportez une version plus récente de la spec à tout moment : vos outils renommés et vos descriptions réécrites sont conservés pour les opérations qui existent toujours. Voir mettre à jour la spec.
Ce qui devient un outil
| Dans la spec OpenAPI | Dans le serveur MCP |
|---|---|
Opération (operationId, ou méthode et chemin) | Un outil |
summary, puis description | Description de l'outil, que vous pouvez réécrire |
| Paramètres de chemin, de requête, d'en-tête et de corps JSON | Arguments de l'outil |
| GET, HEAD, OPTIONS | Outil en lecture seule |
| POST, PUT, PATCH | Outil d'écriture, signalé comme modifiant des données |
| DELETE | Outil de suppression, signalé comme destructif |
Seuls les corps de requête JSON sont exposés. Les indications d'écriture et de suppression sont transmises au client d'IA sous forme d'annotations MCP, ce qui l'incite à demander une confirmation. Voir choisir et décrire les outils.
Ce que Voozeo accepte
| Élément | Valeur |
|---|---|
| Versions de spécification | OpenAPI 3.0.x et 3.1.x (Swagger 2.0 est rejeté avec UNSUPPORTED_SPEC_VERSION) |
| Formats de fichier | JSON ou YAML (.json, .yaml, .yml) |
| Taille maximale | 5 Mo, pour un fichier ou une URL |
Références ($ref) | Références locales uniquement, comme #/components/schemas/Order |
| Spec depuis une URL | Adresse HTTPS publique ; les adresses privées et internes sont refusées (UNSAFE_URL) |
Une spec invalide ou vide échoue avec INVALID_SPEC. Un fichier au-dessus de la taille maximale échoue avec FILE_TOO_LARGE. Les avertissements qui ne bloquent pas l'import, comme une référence externe ignorée, sont listés dans l'onglet « Sources ». Voir importer une API OpenAPI.
Comment votre API est appelée
Quand une IA utilise un outil, Voozeo appelle votre API depuis l'URL de base trouvée dans la spec (ou celle que vous saisissez dans l'onglet « API cible ») et renvoie la réponse à l'IA.
| Authentification | Ce que vous fournissez |
|---|---|
| Aucune | Rien, pour les API publiques |
| Clé d'API | Le nom de l'en-tête ou du paramètre de requête, et le secret |
| Jeton Bearer | Le jeton, envoyé dans l'en-tête Authorization |
| Basic | Nom d'utilisateur et mot de passe |
| OAuth 2.0 | L'application OAuth créée chez le fournisseur de votre API : client ID, client secret, URL d'autorisation et du jeton, scopes |
| Transmis par l'appelant | Seulement un nom d'en-tête : la valeur vient de chaque appel MCP, par exemple d'une passerelle OAuth, et rien n'est stocké |
Avec OAuth 2.0, chaque personne se connecte avec son propre compte chez le fournisseur de votre API et aucune clé MCP n'est nécessaire ; Voozeo appelle votre API avec le jeton de cette personne. Le secret est stocké chiffré, ne peut plus jamais être relu et n'est jamais transmis à l'IA. Les réponses de plus de 100 Ko sont tronquées avant d'atteindre l'IA. Pour donner à chaque utilisateur son propre identifiant sans OAuth chez le fournisseur, voir les identifiants par utilisateur avec une passerelle OAuth. Voir API cible et authentification.
Limites selon l'offre
Le nombre d'outils actifs par serveur dépend de votre offre.
| Offre | Serveurs | Outils actifs par serveur |
|---|---|---|
| Gratuit | 1 | 50 |
| Starter | 3 | 100 |
| Pro | 10 | 300 |
| Business | 30 | 500 |
Quand une spec compte plus d'opérations que votre offre ne le permet, les premiers outils dans l'ordre de la spec sont activés et les autres désactivés. Voir les tarifs pour toutes les limites.
Pour aller plus loin
- Essayez d'abord un serveur prêt à l'emploi avec un modèle.
- Suivez le guide d'une API REST à un serveur MCP en 5 minutes.
- Lisez comment sécuriser l'accès d'une IA à votre API.
- Le protocole est nouveau pour vous ? Lisez qu'est-ce que MCP.