Présentation du protocole MCP

Ce document présente la compatibilité du protocole MCP (Model Context Protocol) dans API Gateway.

API Gateway peut servir de serveur MCP distant, ce qui vous permet d'exposer vos API REST existantes aux agents d'IA et aux LLM sans réécrire vos services de backend.

Arrière-plan

Le protocole MCP (Model Context Protocol) est une norme ouverte qui vous permet de créer des agents IA directement sur votre infrastructure existante. Au lieu d'écrire du code d'intégration personnalisé pour chaque outil ou API, MCP fournit aux modèles d'IA un moyen standard de découvrir et d'appeler des fonctionnalités dans votre environnement.

Lorsqu'elle est configurée en tant que serveur MCP, API Gateway agit en tant que proxy. Il traduit les messages du protocole JSON-RPC MCP standard envoyés par les systèmes agentiques en requêtes HTTP REST standards vers vos backends existants.

Fonctionnalités compatibles

Pendant la version Preview publique, API Gateway prend en charge les fonctionnalités MCP suivantes :

  • Serveur MCP à distance : la passerelle API agit en tant que serveur à distance et reçoit les requêtes MCP via HTTP (POST).
  • Intégration OpenAPI 3.x : la configuration MCP est directement dérivée de votre spécification OpenAPI 3.x à l'aide d'extensions personnalisées.
  • Méthodes de cycle de vie MCP compatibles :
    • initialize : établit la version et les fonctionnalités du protocole.
    • notifications/initialized : confirme l'établissement de la connexion.
    • tools/list : permet aux clients de découvrir les outils disponibles et leurs schémas.
    • tools/call : permet aux clients d'appeler un outil avec des arguments.

Limites

Les limites suivantes s'appliquent à la compatibilité avec MCP dans API Gateway :

  • Les ressources (resources/*) et les requêtes (prompts/*) ne sont pas acceptées.
  • Le transport Stdio n'est pas accepté.
  • OpenAPI 2.0 n'est pas compatible.
  • Les appels d'outils de streaming ou de longue durée ne sont pas acceptés.
  • Exclusion mutuelle du routage de modèle : vous ne pouvez pas activer à la fois MCP et le routage de modèle dans la même configuration d'API. Si x-google-api-management.mcp est activé, x-google-model-router ne peut pas être utilisé.

Pour obtenir la liste complète des limites techniques, consultez Limites des fonctionnalités OpenAPI 3.x.

Cas d'utilisation

  • Exposer les API REST existantes en tant qu'outils MCP : transformez vos API existantes en outils compatibles avec l'IA sans modifier le code de backend.
  • Sélectionner des outils par opération : choisissez explicitement les chemins et méthodes d'API qui sont exposés aux agents.
  • Protéger la surface de l'outil : appliquez les règles de sécurité API Gateway existantes (comme les clés API ou OAuth) à votre point de terminaison MCP.

Processus de requête

Le chemin canonique pour les requêtes MCP est <basepath>/mcp, où <basepath> est dérivé de l'URL ou de la configuration x-google-endpoint de votre passerelle.

Le schéma suivant illustre le flux de requête pour une requête MCP tools/call :

  1. Un client MCP (par exemple, un agent d'IA) envoie une requête JSON-RPC au point de terminaison MCP de la passerelle (par exemple, POST /mcp ou POST /v1/mcp si un préfixe de version est utilisé).
  2. La passerelle valide la requête et vérifie l'authentification.
  3. La passerelle inspecte la charge utile pour déterminer l'outil appelé.
  4. La passerelle traduit la charge utile MCP en requête HTTP standard (chemin d'accès, paramètres, corps) en fonction du mappage défini dans la configuration de l'API.
  5. La passerelle transfère la requête au service de backend.
  6. Le backend renvoie une réponse HTTP standard.
  7. La passerelle traduit la réponse HTTP en réponse MCP JSON-RPC et la renvoie au client.

Découverte via le hub d'API et l'Agent Registry

Si vous intégrez votre passerelle au hub d'API, votre passerelle compatible avec MCP est publiée dans le hub d'API en tant que serveur MCP avec des métadonnées MCP spécifiques supplémentaires. Elle apparaît également automatiquement dans Agent Registry.

Pour les passerelles sans MCP activé, les métadonnées d'API standards sont publiées. Seules les passerelles pour lesquelles MCP est activé affichent ces configurations MCP supplémentaires dans le hub d'API.

Aucune étape d'enregistrement distincte n'est nécessaire. Les agents peuvent ensuite découvrir le serveur et ses outils dans l'un ou l'autre catalogue.

Pour interroger Agent Registry, activez son API dans votre projet :

gcloud services enable agentregistry.googleapis.com

Étapes suivantes