Aller au contenu

Transformer une API REST en serveur MCP en 5 minutes

Mis à jour le 24 octobre 2026 · Publié le 24 octobre 2026

Pour transformer une API REST en serveur MCP, importez son fichier OpenAPI dans Voozeo MCP, vérifiez les outils générés, testez-en un dans le bac à sable et collez l'URL du serveur et la clé dans votre client d'IA. Ce guide détaille chaque étape.

Avant de commencer

Il vous faut un compte Voozeo (gratuit, créé en une minute depuis l'écran d'inscription), une description OpenAPI 3.0 ou 3.1 de votre API (JSON ou YAML, en fichier ou à une adresse HTTPS publique) et un client d'IA compatible MCP. La spec peut peser jusqu'à 5 Mo. Un fichier Swagger 2.0 est rejeté avec UNSUPPORTED_SPEC_VERSION : convertissez-le d'abord en OpenAPI 3.

Voici une spec minimale qui produit deux outils, listProducts et getOrder :

openapi: 3.0.3
info:
  title: Shop
  version: 1.0.0
servers:
  - url: https://api.example.com
paths:
  /products:
    get:
      operationId: listProducts
      summary: List the products
      responses:
        "200": { description: OK }
  /orders/{id}:
    get:
      operationId: getOrder
      summary: Read an order by its identifier
      parameters:
        - name: id
          in: path
          required: true
          schema: { type: string }
      responses:
        "200": { description: OK }

Étape 1 : créer le serveur

  1. Dans « Mes serveurs », cliquez sur « Créer un serveur ».
  2. Saisissez un nom et, si vous le souhaitez, une description, puis cliquez sur « Créer ».
  3. Copiez la clé MCP de la fenêtre « Votre clé MCP » dans un gestionnaire de mots de passe. Elle n'est affichée qu'une seule fois.

Étape 2 : importer le fichier OpenAPI

  1. Ouvrez l'onglet « Sources » et cliquez sur « Importer une spec OpenAPI ».
  2. Choisissez « Fichier » et sélectionnez votre fichier, ou choisissez « URL » et saisissez l'adresse HTTPS publique de la spec.
  3. Cliquez sur « Importer ».

Un message indique le nombre d'outils générés. Le serveur devient « active » après le premier import réussi. Les avertissements éventuels sont listés dans l'onglet « Sources ». Voir importer une API OpenAPI.

Étape 3 : vérifier les outils

Ouvrez l'onglet « Outils ». Chaque opération est un outil que vous pouvez activer ou désactiver, renommer et décrire. De bonnes descriptions aident l'IA à choisir le bon outil :

  • nommez avec un verbe et un objet, comme list_orders ;
  • dites quand utiliser l'outil, et quand ne pas l'utiliser ;
  • précisez les unités et les formats des paramètres.

Votre offre fixe le nombre d'outils actifs par serveur : 50 avec l'offre Gratuit. Désactivez les outils d'écriture et de suppression dont votre IA n'a pas besoin. Voir choisir et décrire les outils.

Étape 4 : renseigner l'API cible

Dans l'onglet « API cible », vérifiez l'URL de base. Elle vient de la spec ; vous pouvez saisir la vôtre, qu'un nouvel import n'écrase jamais. Choisissez ensuite l'authentification attendue par votre API : aucune, clé d'API, jeton Bearer, Basic ou OAuth 2.0. Le secret est stocké chiffré et n'est plus jamais affiché. 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. Voir API cible et authentification.

Étape 5 : tester, puis connecter

  1. Dans l'onglet « Test », choisissez un outil, renseignez ses arguments et cliquez sur « Exécuter ». Le résultat indique le statut, la durée et le code HTTP de votre API. Le bac à sable fonctionne même avant de connecter une IA.
  2. Dans l'onglet « Connexion », copiez le bloc de votre client et collez-le au bon endroit : Claude, ChatGPT, Cursor ou VS Code.
  3. Demandez à votre IA d'utiliser l'outil. L'appel apparaît dans l'onglet « Journal ».

Et ensuite

  • Réimportez la spec chaque fois que votre API change : vos personnalisations sont conservées pour les opérations qui existent toujours.
  • Surveillez la consommation : le quota se compte en appels par mois, et l'offre Gratuit en comprend 1 000. Voir les tarifs.
  • Lisez comment sécuriser l'accès d'une IA à votre API.
Commencer