Connecteurs HTTP

Toutes les API que vous souhaitez appeler ne disposent pas d'un serveur MCP prêt à l'emploi. Les connecteurs HTTP vous permettent de vous connecter à n'importe quelle API HTTP et d'exposer ses endpoints sous forme d'outils que les agents et les workflows peuvent appeler — en important la spécification OpenAPI de l'API dans Studio.

Cette page détaille la création d'un connecteur HTTP, en prenant l'API de Spotify comme exemple.

Avant de commencer

Rassemblez les informations suivantes sur l'API à laquelle vous souhaitez vous connecter :

1. URL du serveur — l'URL de base de l'API (par exemple, https://api.spotify.com/v1).
2. Méthode d'authentification — l'API fonctionne-t-elle sans authentification, avec une clé API ou avec OAuth ?
   • Si OAuth : trouvez le fichier de métadonnées du serveur OAuth de l'API (généralement à l'emplacement .well-known/oauth-authorization-server), ou rassemblez l'endpoint d'autorisation, l'endpoint de token et les scopes requis.
3. Spécification OpenAPI — une URL ou un fichier pointant vers la spécification OpenAPI de l'API (JSON ou YAML). Par exemple, Spotify publie la sienne à l'adresse https://developer.spotify.com/reference/web-api/open-api-schema.yaml.

Créer le connecteur HTTP

1. Dans Studio, accédez à Connecteurs et cliquez sur + Ajouter un connecteur.
2. Choisissez Ajouter un connecteur personnalisé.
3. Sélectionnez le protocole HTTP et saisissez l'URL du serveur (par exemple, https://api.spotify.com/v1).
4. Sélectionnez la méthode d'authentification :
   • Aucune — l'API ne nécessite pas d'authentification.
   • Clé API — indiquez le nom et la valeur de la clé.
   • OAuth — le panneau Paramètres OAuth avancés s'ouvre. Vous pouvez soit renseigner chaque champ manuellement (endpoint d'autorisation, endpoint de token, scopes, etc.), soit coller un bloc JSON de métadonnées du serveur OAuth.

Si vous avez choisi OAuth, collez les métadonnées du serveur OAuth de l'API au format suivant. Tous les champs OAuth sont ainsi remplis en une seule fois :

{
  "issuer": "https://accounts.spotify.com",
  "authorization_endpoint": "https://accounts.spotify.com/authorize",
  "token_endpoint": "https://accounts.spotify.com/api/token",
  "revocation_endpoint": "https://accounts.spotify.com/oauth2/revoke/v1",
  "device_authorization_endpoint": "https://accounts.spotify.com/oauth2/device/authorize",
  "response_types_supported": ["code"],
  "grant_types_supported": [
    "authorization_code",
    "refresh_token",
    "client_credentials"
  ],
  "code_challenge_methods_supported": ["S256"],
  "token_endpoint_auth_methods_supported": [
    "none",
    "client_secret_basic",
    "client_secret_post"
  ],
  "scopes_supported": [
    "user-read-email",
    "user-read-private",
    "user-read-playback-state",
    "user-modify-playback-state",
    "playlist-read-private",
    "playlist-modify-public"
  ]
}

{
  "issuer": "https://accounts.spotify.com",
  "authorization_endpoint": "https://accounts.spotify.com/authorize",
  "token_endpoint": "https://accounts.spotify.com/api/token",
  "revocation_endpoint": "https://accounts.spotify.com/oauth2/revoke/v1",
  "device_authorization_endpoint": "https://accounts.spotify.com/oauth2/device/authorize",
  "response_types_supported": ["code"],
  "grant_types_supported": [
    "authorization_code",
    "refresh_token",
    "client_credentials"
  ],
  "code_challenge_methods_supported": ["S256"],
  "token_endpoint_auth_methods_supported": [
    "none",
    "client_secret_basic",
    "client_secret_post"
  ],
  "scopes_supported": [
    "user-read-email",
    "user-read-private",
    "user-read-playback-state",
    "user-modify-playback-state",
    "playlist-read-private",
    "playlist-modify-public"
  ]
}

5. Cliquez sur Créer. Vous êtes redirigé vers l'écran de consentement OAuth de l'API pour autoriser la connexion.

Importer la spécification OpenAPI

Après avoir créé le connecteur, la page du connecteur affiche une entrée de fichier et une entrée d'URL au lieu de la liste d'outils habituelle — car les outils des connecteurs HTTP proviennent d'une spécification OpenAPI.

1. Accédez à la page du connecteur.
2. Collez l'URL de la spécification OpenAPI (par exemple, https://developer.spotify.com/reference/web-api/open-api-schema.yaml), ou téléchargez un fichier.
3. La boîte de dialogue Importation des outils depuis OpenAPI s'ouvre et affiche :
   • Un extrait de la spécification OpenAPI.
   • Des erreurs générales si la spécification ne peut pas être traitée.
   • Les endpoints qui seront convertis en outils et ceux qui ne peuvent pas être traités.
4. Vérifiez, puis cliquez sur Accepter.

Utiliser le connecteur

Votre connecteur HTTP est maintenant prêt. Vous pouvez :

• L'utiliser dans les agents et les workflows comme n'importe quel autre connecteur ou serveur MCP.
• Activer ou désactiver chaque outil depuis la page de gestion du connecteur.

Aller plus loin