Cette page s'applique à Apigee et à Apigee hybrid.
Consultez la documentation d'
Apigee Edge.
Cette page explique comment utiliser Apigee pour exposer vos API en tant qu'outils MCP aux applications agentives. La MCP dans Apigee est disponible pour les organisations avec abonnement, paiement à l'usage et évaluation, y compris les organisations pour lesquelles la résidence des données est activée. Depuis la version 1.17.0 d'Apigee hybrid, MCP est également disponible pour Apigee hybrid. Le plan de données d'exécution s'exécute dans votre propre cluster Kubernetes plutôt que sur une infrastructure gérée par Google. Consultez Activer MCP dans Apigee hybrid pour connaître le processus d'installation et de configuration spécifique à Hybrid.
Qu'est-ce que MCP ?
Le Model Context Protocol (MCP) est un protocole Open Source développé par Anthropic qui standardise la façon dont les applications d'IA se connectent aux sources de données, aux workflows et aux outils.
Les applications d'IA peuvent utiliser le MCP pour accéder aux services Google Cloud et Apigee en tant qu'outils. Dans ce contexte, il est utile de comprendre les termes MCP suivants :
- Hôte MCP : application ou environnement d'IA qui interagit avec l'utilisateur. L'hôte MCP utilise des grands modèles de langage (LLM) pour traiter les requêtes qui peuvent nécessiter des données ou des outils externes.
- Client MCP : composant de l'hôte MCP qui aide le LLM et le serveur MCP à communiquer entre eux. Il traduit les requêtes du LLM pour le serveur MCP et convertit les réponses du serveur MCP pour le LLM. Il recherche et utilise également les serveurs MCP disponibles.
- Serveur MCP : service externe qui fournit le contexte, les données ou les capacités au LLM, en agissant comme un proxy entre le LLM et le client MCP.
Fonctionnement de MCP dans Apigee
Les points de terminaison MCP pour Google, Google Cloudet Apigee implémentent la spécification du serveur MCP. Cela permet aux clients MCP conformes d'y accéder pour :
- Découvrez les points de terminaison disponibles.
- Répertoriez les outils disponibles sur un point de terminaison.
- S'authentifier auprès d'un point de terminaison
- Appeler des outils conformément aux règles d'accès définies
Tout client MCP compatible avec les points de terminaison MCP distants via HTTP/S peut accéder à ces outils.
Comme les points de terminaison sont gérés, vous n'avez pas besoin d'installer ni de gérer des serveurs MCP locaux, des serveurs MCP distants ou une infrastructure supplémentaire pour permettre aux applications agentives d'accéder à vos services.
Le protocole MCP dans Apigee est compatible avec JSON-RPC pour les méthodes tools/list et tools/call, ainsi que pour la méthode server/discover dans le protocole MCP sans état. Vous pouvez personnaliser votre point de terminaison MCP avec des paramètres de visibilité, de sécurité, de disponibilité réseau et d'observabilité. Pour connaître les versions du protocole MCP compatibles avec Apigee, consultez Versions du protocole MCP compatibles.
Modèles de déploiement
MCP est disponible dans deux modèles de déploiement Apigee :
- Apigee (SaaS) : le plan de données MCP est hébergé sur une infrastructure gérée par Google. Vous déployez le proxy de découverte MCP, et le point de terminaison est immédiatement disponible.
- Apigee hybrid (auto-hébergé, à partir d'Apigee hybrid
1.17.0) : le plan de données MCP s'exécute dans votre propre cluster Kubernetes. Le plan de contrôle Apigee génère la configuration de l'outil MCP à partir de votre spécification OpenAPI, et votre cluster récupère cette configuration selon son propre calendrier. Le trafic des requêtes MCP ne quitte jamais votre cluster. Consultez Activer MCP dans Apigee hybrid.
Architecture du plan de données MCP dans Apigee hybrid
Le schéma suivant montre comment les composants MCP sont répartis entre le plan de contrôle Apigee et votre cluster Apigee hybrid.
Deux propriétés de cette architecture sont importantes pour la planification et l'examen de la sécurité :
- Le trafic des requêtes MCP reste dans votre cluster. Les clients MCP accèdent à votre entrée Apigee existante à la même URL qu'ils utiliseraient pour n'importe quel autre proxy Apigee. Votre processeur de messages achemine ensuite la requête vers le plan de données MCP dans le même cluster. Aucune requête ni réponse MCP ne franchit la limite vers Google Cloud au moment de la requête.
- La configuration est extraite, et non transmise. La configuration de l'outil MCP est générée par le plan de contrôle Apigee et récupérée par un composant de votre cluster selon une planification. Le plan de contrôle Apigee n'initie jamais de connexion à votre cluster. Consultez la section Exigences du réseau sortant pour connaître les points de terminaison exacts que la sortie de votre cluster doit autoriser.
Versions du protocole MCP compatibles
Le MCP dans Apigee est compatible avec le protocole MCP sans état, version 2026-07-28, et les versions 2025-11-25, 2025-06-18, 2025-03-26 et 2024-11-05 du protocole MCP avec état. Un point de terminaison MCP diffuse les deux protocoles en même temps. Ainsi, les clients MCP existants continuent de fonctionner lorsque les clients MCP qui utilisent le protocole sans état appellent le même point de terminaison.
Sur cette page, sans état fait référence au modèle de métadonnées par requête introduit dans la version 2026-07-28 de MCP, que la spécification MCP appelle également moderne.
Stateful fait référence au modèle précédent qui commence par une requête initialize, que la spécification MCP appelle également legacy. Pour obtenir un exemple concret, consultez Lister les outils avec le protocole MCP sans état dans le guide de démarrage rapide.
| Protocole | Versions | Méthodes acceptées |
|---|---|---|
| Sans état | 2026-07-28 |
|
| Avec état |
|
|
Comment Apigee sélectionne le protocole
Apigee sélectionne le protocole à partir du corps de la requête, et non de l'en-tête MCP-Protocol-Version. Une requête dont l'objet params._meta contient io.modelcontextprotocol/protocolVersion avec une valeur de chaîne JSON utilise le protocole sans état. Une requête sans cette clé ou avec une valeur qui n'est pas une chaîne utilise le protocole avec état.
- Toute valeur de chaîne sélectionne le protocole sans état. Si la chaîne nomme une version non compatible avec Apigee, la requête utilise toujours le protocole sans état et échoue avec l'erreur JSON-RPC
-32022(Unsupported protocol version). Elle ne revient pas au protocole avec état. - Une requête avec un en-tête
MCP-Protocol-Versionde2026-07-28, mais sansio.modelcontextprotocol/protocolVersiondansparams._metaest une requête avec état. La version2026-07-28n'est pas une version avec état. Apigee la rejette donc avec le code HTTP400et l'erreur JSON-RPC-32602(Unsupported protocol version) du protocole avec état, et non l'erreur sans état-32022. Pour utiliser la version2026-07-28, une requête doit utiliser le format de requête sans état. - Si une requête
initializedemande la version2026-07-28ou toute version non compatible avec Apigee, Apigee négocie la version2025-11-25. - La méthode
server/discovern'est disponible que dans le protocole sans état. Une requêteserver/discoveravec état suit la gestion des exceptions du protocole avec état : elle reçoit HTTP200avec l'erreur JSON-RPC-32601(Method server/discover is not supported) dans le corps de la réponse. L'état HTTP404dans Erreurs de protocole sans état ne s'applique qu'aux requêtes sans état.
Requêtes de protocole sans état
Chaque requête sans état doit inclure la version du protocole dans le corps de la requête et dans un en-tête. Si vous migrez un client MCP depuis le protocole avec état, voici les principales différences :
- Le client MCP n'appelle pas
initialize. Apigee ne crée pas de sessions pour le protocole sans état. - Le client MCP n'envoie pas d'en-tête
Mcp-Session-Id. Si une requête sans état en inclut un, Apigee l'ignore. - Chaque requête comporte un objet
params._metaavec la version du protocole et les fonctionnalités du client. - Chaque requête comporte les en-têtes
MCP-Protocol-VersionetMcp-Method, et une requêtetools/callcomporte également l'en-têteMcp-Name. - Les requêtes non valides reçoivent un code HTTP
400ou404avec les codes d'erreur indiqués dans Erreurs de protocole sans état.
Une requête sans état doit inclure les champs suivants dans le corps de la requête :
params._meta["io.modelcontextprotocol/protocolVersion"]: doit être la chaîne JSON"2026-07-28", et non un nombre.params._meta["io.modelcontextprotocol/clientCapabilities"]: doit être un objet JSON. Si le client MCP ne déclare aucune fonctionnalité, envoyez un objet vide ({}).- Facultatif :
params._meta["io.modelcontextprotocol/clientInfo"], un objet avec les élémentsnameetversiondu client MCP. La spécification MCP recommande aux clients MCP de l'envoyer à chaque requête.
Une requête sans état doit inclure les en-têtes HTTP suivants :
| En-tête | Obligatoire pour | Valeur |
|---|---|---|
MCP-Protocol-Version |
Toutes les méthodes | 2026-07-28 : doit correspondre à la version du protocole dans _meta. |
Mcp-Method |
Toutes les méthodes | Méthode JSON-RPC, par exemple tools/list. Doit correspondre au champ method dans le corps de la requête. |
Mcp-Name |
tools/call uniquement |
Nom de l'outil. Doit correspondre à params.name dans le corps de la requête. Envoyez le nom de l'outil en tant que valeur d'en-tête ASCII brut. Si le nom de l'outil contient des caractères non ASCII ou des caractères de contrôle, s'il comporte des espaces blancs de début ou de fin, ou s'il correspond au format =?base64?...?=, vous devez l'encoder en tant que =?base64?ENCODED_NAME?=, où ENCODED_NAME est l'encodage base64 avec marge intérieure du nom de l'outil UTF-8. Pour en savoir plus, consultez Encodage des valeurs dans la spécification MCP. N'envoyez pas Mcp-Name avec tools/list ou server/discover. |
Envoyez chaque en-tête une seule fois. Apigee traite un en-tête MCP-Protocol-Version, Mcp-Method ou Mcp-Name répété comme une non-concordance d'en-tête.
Les résultats sans état incluent "resultType": "complete". Les résultats de tools/list et server/discover incluent également "cacheScope": "public" et "ttlMs": 0. Une valeur ttlMs de 0 signifie que les résultats sont obsolètes dès leur arrivée : Apigee ne propose pas de fenêtre de cache pour eux, de sorte que cacheScope n'a aucun effet pratique. Le résultat server/discover liste les versions de protocole compatibles dans supportedVersions, les fonctionnalités du serveur dans capabilities ("tools": {"listChanged": false}) et les informations sur le serveur dans _meta["io.modelcontextprotocol/serverInfo"]. L'ordre des champs dans un objet JSON n'est pas garanti. Les clients MCP doivent donc lire les champs par nom.
Si une requête tools/call sans état inclut les clés OpenTelemetry traceparent, tracestate ou baggage dans params._meta, Apigee transmet leurs valeurs au backend en tant qu'en-têtes HTTP du même nom.
Apigee n'ajoute pas d'annotations x-mcp-header aux définitions d'outils renvoyées par tools/list. Par conséquent, les clients MCP n'envoient pas d'en-têtes Mcp-Param-NAME à Apigee.
Erreurs de protocole sans état
Apigee rejette une requête sans état qui ne répond pas aux exigences de la section Requêtes de protocole sans état avec l'une des erreurs suivantes.
Pour corriger une erreur 400, vérifiez que la requête respecte ces exigences.
Apigee ne nécessite aucune fonctionnalité client. Il ne renvoie donc pas l'erreur JSON-RPC -32021 (MissingRequiredClientCapability).
| Condition | État HTTP | Code d'erreur JSON-RPC | Message d'erreur |
|---|---|---|---|
L'en-tête MCP-Protocol-Version, Mcp-Method ou Mcp-Name est manquant. |
400 |
-32020 |
Missing HEADER header |
| Un en-tête ne correspond pas au corps de la requête, est vide ou apparaît plusieurs fois. | 400 |
-32020 |
Header mismatch: HEADER header does not match request body |
La version du protocole n'est pas compatible. L'erreur data contient la version demandée dans requested et les versions compatibles dans supported. |
400 |
-32022 |
Unsupported protocol version |
io.modelcontextprotocol/clientCapabilities est manquant dans _meta. |
400 |
-32602 |
Missing io.modelcontextprotocol/clientCapabilities in _meta |
io.modelcontextprotocol/clientCapabilities n'est pas un objet JSON. |
400 |
-32602 |
io.modelcontextprotocol/clientCapabilities in _meta is not an object |
La méthode n'est pas compatible avec le protocole sans état, par exemple initialize, notifications/initialized, ping, resources/list, resources/read, prompts/list ou subscriptions/listen. |
404 |
-32601 |
Method METHOD is not supported |
Principales fonctionnalités de MCP dans Apigee
Le MCP dans Apigee offre des fonctionnalités de découverte, de sécurité et de gouvernance des outils. Ces fonctionnalités vous aident à gérer la façon dont les applications agentives interagissent avec vos services.
Découverte d'outils simplifiée avec le hub d'API
Vous pouvez découvrir les points de terminaison MCP disponibles pour les services Apigee à l'aide d'un service d'annuaire accessible via une interface REST. Chaque point de terminaison MCP est également compatible avec la méthode MCP tools/list, qui permet aux clients MCP de découvrir les outils disponibles dans ce point de terminaison.
De plus, MCP s'intègre au hub d'API Apigee. Lorsqu'un proxy de découverte MCP est déployé, le hub d'API ingère automatiquement sa spécification OpenAPI, lui attribue le style d'API MCP et mappe les opérations d'API à des outils MCP individuels. Les développeurs peuvent ainsi filtrer facilement les API compatibles avec le MCP dans le hub d'API et utiliser la recherche sémantique avec des requêtes en langage naturel pour trouver les outils pertinents pour leurs applications d'agent.
Emplacement de l'argument de l'outil dans la requête de backend
Lorsqu'un client MCP appelle un outil, Apigee crée une requête vers votre backend à partir des arguments fournis par le client. La valeur in déclarée par chaque paramètre dans votre spécification OpenAPI détermine l'emplacement de cet argument dans la requête sortante.
Valeur OpenAPI in |
Emplacement où l'argument est envoyé dans la requête de backend |
|---|---|
header |
En tant qu'en-tête de requête. Le nom du paramètre est utilisé comme nom d'en-tête, exactement comme indiqué dans la spécification. |
cookie |
Dans l'en-tête de requête Cookie, en tant que paire name=value. Si une opération déclare plusieurs paramètres de cookie, ils sont envoyés dans un en-tête Cookie, séparés par ; (un point-virgule et un espace). |
query |
Dans la chaîne de requête. |
path |
Remplacé dans le chemin d'URL de la requête. |
Chaque paramètre apparaît dans le inputSchema de l'outil, quelle que soit sa valeur in. Un client MCP les fournit donc tous de la même manière.
La valeur in ne change que lorsque la valeur est placée dans la requête envoyée à votre backend.
Par exemple, l'opération suivante déclare un paramètre dans chacun des trois emplacements :
paths: /orders: get: operationId: listOrders parameters: - name: X-Session-Id in: header schema: type: string - name: tenantId in: cookie schema: type: string - name: limit in: query schema: type: integer
Une requête tools/call qui fournit les trois arguments produit une requête de backend de la forme suivante :
GET /orders?limit=25 X-Session-Id: sess-abc-123 Cookie: tenantId=tenant-xyz-789
Notez le comportement suivant :
- Un argument lié à un en-tête ou à un cookie n'est pas non plus ajouté à la chaîne de requête et n'est pas inclus dans le corps de la requête.
- Un argument non fourni par le client est ignoré. Aucun en-tête, cookie ou paramètre de requête vide n'est envoyé à la place.
- Un en-tête lié remplace tout en-tête du même nom déjà présent dans la requête de backend. Les autres en-têtes de la requête de backend sont transmis sans modification.
- Les valeurs sont encodées en pourcentage (RFC 3986) lorsqu'elles sont placées dans la requête de backend. Par conséquent, une valeur contenant un espace ou un caractère réservé atteint votre backend sous sa forme encodée. Décodez-le à cet endroit si vous avez besoin de l'original.
- Lorsqu'une opération et son chemin d'accès déclarent tous deux un paramètre portant le même nom et la même valeur
in, la déclaration au niveau de l'opération s'applique, comme l'exige la spécification OpenAPI. - Attribuez des noms distincts aux paramètres d'une même opération, même lorsqu'ils déclarent des valeurs
indifférentes. OpenAPI identifie un paramètre par la paire de son nom et de son emplacement, mais un outil MCP n'accepte qu'une seule valeur par nom d'argument. Si une spécification déclare deux paramètres portant le même nom avec des valeursindifférentes, le client fournit une valeur qui est envoyée aux deux emplacements déclarés dans la requête de backend : unsessionIddéclaré à la foisin: cookieetin: queryarrive dans l'en-têteCookieet dans la chaîne de requête. Vérifiez ce point si votre backend comporte une logique qui dépend de l'origine d'une valeur. - Les noms d'arguments sont sensibles à la casse. Par conséquent,
UserIDetuseridsont deux arguments différents. Pour les paramètresheader, veillez à ce que les noms ne diffèrent pas uniquement par la casse : les noms d'en-tête HTTP ne sont pas sensibles à la casse. Par conséquent, deux paramètres d'en-tête dont les noms ne diffèrent que par la casse sont résolus sur le même en-tête de la requête de backend, et une seule des deux valeurs est conservée.
Cookies sur la requête envoyée à votre backend
Les cookies sont le seul cas où la liaison peut supprimer un élément de la requête plutôt que de l'ajouter. Contrairement aux autres en-têtes HTTP, qui contiennent des paires nom/valeur indépendantes pouvant être définies individuellement, tous les cookies partagent un seul en-tête Cookie. Apigee ne fusionne pas les cookies que vous associez avec ceux qui sont arrivés sur la requête du client MCP : lorsqu'un appel fournit un argument de cookie, l'en-tête Cookie est remplacé dans son intégralité par les cookies associés uniquement.
Par conséquent, le fait qu'un cookie arrivé avec la requête HTTP du client MCP atteigne ou non votre backend dépend de l'appel d'outil individuel :
- Si l'opération ne déclare aucun paramètre
cookie, l'en-têteCookieest transféré au backend sans modification. - Si l'opération déclare des paramètres
cookie, mais que l'appel n'en fournit aucun, l'en-têteCookieest à nouveau transféré au backend sans modification. - Dès que l'appel fournit au moins un argument de cookie, l'en-tête
Cookieest remplacé par les cookies liés uniquement. Tout cookie arrivé sur la requête du client et non déclaré en tant que paramètrecookieest supprimé.
Étant donné que le troisième cas est déterminé par les arguments fournis par un appel particulier, une opération avec des paramètres de cookie facultatifs peut transmettre des cookies lors d'un appel et les supprimer lors du suivant. Il n'existe aucun paramètre permettant de conserver un cookie non déclaré. Si votre backend dépend d'un cookie, déclarez-le en tant que paramètre cookie pour chaque opération qui en a besoin. Ainsi, sa valeur est toujours fournie par l'appel d'outil, plutôt que d'être héritée de la requête du client.
Sécurité
MCP dans Apigee inclut plusieurs couches de sécurité pour protéger vos services. Vous pouvez contrôler l'accès à l'aide de l'authentification, de l'autorisation, des limites du réseau et de l'analyse du contenu.
Authentification
Les points de terminaison MCP hébergés par Apigee sont compatibles avec OAuth 2.1 et OpenID Connect (OIDC) pour l'authentification. Cela garantit que seuls les agents, les clients MCP et les utilisateurs finaux dont l'identité est établie peuvent accéder à vos points de terminaison MCP et appeler des outils MCP. Les métadonnées de ressource protégée permettent aux clients de découvrir les serveurs d'autorisation OAuth.
Stratégies d'autorisation précises
Vous pouvez limiter l'accès à vos outils MCP en fonction des identités des clients OAuth. Par exemple, vous pouvez configurer une règle dans votre proxy de découverte MCP pour spécifier que seuls les agents désignés avec des identités client connues peuvent accéder à un outil MCP pour un service de paiement.
Responsabilité du client pour les appels d'outils
Les applications clientes MCP sont chargées d'appliquer une supervision humaine des appels d'outils, par exemple en invitant l'utilisateur à confirmer avant d'exécuter des opérations de mutation d'état. Pour en savoir plus, consultez la documentation sur le protocole Model Context.
Observabilité et analyse
Pour les points de terminaison hébergés par Apigee, vous pouvez utiliser Apigee Analytics pour afficher des informations détaillées sur l'utilisation de vos outils MCP.
Analytics vous permet de segmenter le trafic spécifique au MCP du trafic API standard et d'afficher les métriques au niveau de chaque outil, comme le volume de requêtes tools/list (découverte) par rapport aux requêtes tools/call (exécution). Les métriques de performances vous aident également à faire la distinction entre la surcharge du proxy et le temps de réponse cible, ce qui vous permet d'identifier plus efficacement les goulots d'étranglement.
Fiabilité et dépannage
Pour améliorer le dépannage et offrir une meilleure visibilité sur le processus de déploiement, Apigee affiche des erreurs d'infrastructure et de configuration spécifiques dans l'interface utilisateur. Si un déploiement échoue en raison d'une spécification OpenAPI non valide ou d'un problème d'infrastructure régional, l'UI fournit des commentaires exploitables pour vous aider à résoudre le problème sans l'intervention de l'assistance.
Utiliser MCP avec Apigee
Vous pouvez exposer vos API Apigee existantes en tant qu'outils MCP et les rendre accessibles via des points de terminaison MCP.
Ces points de terminaison peuvent être configurés au niveau de l'hôte ou du groupe d'environnements. Par exemple, si votre organisation cymbal possède huit noms d'hôte (par exemple, api.cymbal.com, partners.cymbal.com), chacun associé à un groupe d'environnements différent, vous pouvez héberger un serveur MCP dédié pour chaque nom d'hôte.
Un point de terminaison cible géré (ORG_NAME.mcp.apigee.internal) est déployé à l'aide d'un proxy de découverte MCP spécialisé dans votre organisation Apigee, où vos serveurs MCP sont mis à disposition.
Le tableau suivant montre comment les clients, y compris l'organisation fictive Cymbal, peuvent configurer plusieurs points de terminaison MCP à l'aide d'Apigee.
| Client | Nom d'hôte et chemin de base MCP | Point de terminaison cible du serveur MCP | proxy d'API | Environnement/Groupe d'environnements |
|---|---|---|---|---|
| cymbale | api.cymbal.com/mcp |
cymbal.mcp.apigee.internal(projet locataire de l'organisation Cymbal) |
mcp-api-proxy1 |
prod/prod-env-group |
api-internal.cymbal.com/mcp |
cymbal.mcp.apigee.internal(projet locataire de l'organisation Cymbal) |
mcp-api-proxy2 |
internal/internal-env-group |
|
api-service.cymbal.com/mcp |
cymbal.mcp.apigee.internal(projet locataire de l'organisation Cymbal) |
mcp-api-proxy3 |
dev/dev-env-group |
Limites
Les limites suivantes s'appliquent à MCP dans Apigee :
- Le nombre d'outils MCP dans une organisation Apigee est limité à 1 000.
- Le déploiement de l'infrastructure MCP peut être soumis à des limites de capacité dans les régions suivantes :
europe-central2europe-southwest1europe-west9me-central2
Si vous voyez une erreur de provisionnement ou si l'état de provisionnement ne passe jamais à Déployé, cela peut être dû à des limites de capacité d'infrastructure temporaires dans la région sélectionnée. Essayez de déployer le proxy dans un environnement d'une autre région.
- MCP dans Apigee est compatible avec les versions OpenAPI suivantes : 3.0.0, 3.0.1, 3.0.2, 3.0.3.
- Les insights sur les API dans le hub d'API Apigee ne sont pas disponibles pour les API et les outils MCP déployés dans les organisations Apigee où VPC-SC est activé.
- Les appels GET sur les réponses d'erreur MCP renverront une erreur
405, car le serveur MCP n'est actuellement pas compatible avec les flux d'événements envoyés par le serveur (SSE). - Les insights sur les API du hub d'API Apigee n'afficheront pas les API de style MCP ni le trafic pour les ressources MCP tant que la version 1-17-0-apigee-6 d'Apigee ne sera pas entièrement déployée dans toutes les régions disponibles.
- Vous ne pouvez pas remplacer l'attribut de style d'API par MCP pour une ressource d'API qui comporte des opérations d'API existantes.
Limites spécifiques à Apigee hybrid
Les limites suivantes s'appliquent à MCP dans Apigee hybrid :
- Les arguments d'outil déclarés
in: headerouin: cookiesont envoyés dans la chaîne de requête. Le routage par emplacement décrit dans Emplacement des arguments d'outil dans la requête de backend n'est pas encore disponible dans Apigee hybrid. En attendant, un paramètre déclarant l'un de ces emplacements atteint votre backend en tant que paramètre de requête, ce qui correspond au comportement qui précédait cette fonctionnalité. Les lignesin: queryetin: pathde ce tableau s'appliquent à Apigee hybrid telles qu'elles sont écrites. - Le nombre d'outils MCP est limité par la taille, et non par un nombre fixe. Contrairement à Apigee (qui applique un nombre maximal fixe d'outils MCP par organisation), Apigee hybrid limite la capacité des outils via quatre limites de taille : la taille du fichier de spécification OpenAPI, la taille du bundle de proxy MCP, la taille de la réponse
tools/listpar nom d'hôte et le nombre de noms d'hôte par groupe d'environnements. Pour la plupart des spécifications OpenAPI, vous pouvez généralement vous attendre à pouvoir intégrer 10 000 outils MCP par organisation,dans la limite de taille de réponse par défaut. La capacité réelle varie en fonction de la forme spécifique de votre spécification (dominée par le nombre de paramètres et de propriétés du corps de la requête, ainsi que par la longueur de la description). Les schémas de réponse ne sont pas comptabilisés dans le budget. Pour estimer la capacité de vos spécifications OpenAPI spécifiques et voir les quatre limites strictes et leurs modes d'échec, consultez Estimer la capacité de l'outil MCP. - L'activation ou la désactivation de MCP déclenche une version Canary progressive des pods de processeur de messages. L'opérateur Apigee met à jour la spécification du pod de votre processeur de messages lorsque vous activez ou désactivez MCP, et le contrôleur
ApigeeDeploymentdu processeur de messages exécute la modification via une version Canary par étapes plutôt que par un redémarrage progressif Kubernetes standard. La version ne se déclenche que lors des transitions d'activation et de désactivation, et non lors de l'activité de déploiement MCP en cours ou du trafic MCP en régime permanent. Planifiez l'activation initiale et toutes les opérations de désactivation ultérieures pendant un intervalle de maintenance approuvé. - Le dimensionnement des ressources des pods MCP est géré par le client. Les pods MCP s'exécutent avec les requêtes et les limites de ressources définies par les valeurs par défaut intégrées dans les charts Helm Apigee hybrid. Si votre charge de travail nécessite plus de capacité, ajustez le processeur et la mémoire dans
overrides.yaml. Pour connaître les champs disponibles, consultez la documentation de référence sur les champsoverrides.yaml. - Un plan de données MCP par organisation Apigee et par cluster. Dans la version
1.17.0, l'opérateur Apigee provisionne un plan de données MCP pour chaque organisation Apigee installée dans le cluster. Un cluster qui héberge plusieurs organisations Apigee exécute un plan de données MCP par organisation. Les plans de données sont indépendants et ne partagent pas de configuration. - L'activation uniforme dans un groupe d'environnements est requise. Activez MCP de manière uniforme sur tous les clusters diffusant le même groupe d'environnements Apigee. Si MCP est activé sur certains clusters et pas sur d'autres au sein d'un groupe, les requêtes MCP acheminées vers un cluster sur lequel MCP n'est pas activé recevront une réponse
503 Service Unavailable. - Le protocole MCP sans état nécessite la version
1.17.4ou une version ultérieure. Les versions d'Apigee hybrid de1.17.0à1.17.3ne sont compatibles qu'avec les versions avec état du protocole MCP2025-11-25,2025-06-18,2025-03-26et2024-11-05. À partir de la version1.17.4, Apigee hybrid est également compatible avec le protocole MCP sans état, version2026-07-28. Consultez Versions compatibles du protocole MCP. - TLS unidirectionnel entre le processeur de messages et le plan de données MCP. La version
1.17.0utilise le protocole TLS unidirectionnel entre le processeur de messages et le plan de données MCP. - TLS unidirectionnel entre le plan de données MCP et la passerelle d'entrée par défaut. Le plan de données MCP transfère les appels d'outils à votre passerelle d'entrée Apigee via TLS, mais par défaut, il ne présente aucun certificat client et ne vérifie pas le certificat de la passerelle d'entrée.
À partir de la version
1.17.4, vous pouvez activer le protocole TLS mutuel sur cette connexion par groupe d'environnements. Le protocole TLS mutuel est requis pour tout groupe d'environnementstlsMode: MUTUALqui diffuse des appels d'outils MCP. Consultez Configurer mTLS entre le plan de données MCP et la passerelle d'entrée. - Le plan de données MCP s'appuie sur le processeur de messages pour l'identité de l'appelant. Le plan de données MCP du cluster n'authentifie pas indépendamment ses appelants dans
1.17.0. Il suppose que les requêtes qui l'atteignent ont déjà été authentifiées par un proxy Apigee exécuté dans le processeur de messages. Chaque requête MCP qui doit être authentifiée doit arriver via un proxy MCP Apigee qui applique une règle d'authentification (voir Gérer l'accès aux outils MCP). Les clients de production doivent appliquer des contrôles d'entrée de cluster afin que seuls les pods de processeur de messages (libellé Kubernetesapp=apigee-runtimedans le même espace de noms Kubernetes où Apigee hybrid est installé) puissent atteindre le service MCP sur TCP443. Utilisez le moteur de stratégies compatible avec votre plate-forme (Kubernetes NetworkPolicy, Cilium, Calico, Istio AuthorizationPolicy) pour appliquer cette restriction.
Étapes suivantes
- Découvrez comment faire vos premiers pas avec Apigee et MCP.
- Pour Apigee hybrid, commencez par activer MCP dans votre cluster, puis suivez le guide de démarrage rapide.
- Pour accéder à d'autres produits Google et Google Cloud via les outils MCP, consultez Présentation des serveurs MCP Google Cloud.