Panoramica del Model Context Protocol (MCP) in Apigee

Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa pagina descrive come utilizzare Apigee per esporre le tue API come strumenti MCP per applicazioni agentiche. MCP in Apigee è disponibile per le organizzazioni con abbonamento, con pagamento a consumo e di valutazione, incluse quelle con la residenza dei dati attivata.

Che cos'è MCP?

Il Model Context Protocol (MCP) è un protocollo open source sviluppato da Anthropic che standardizza il modo in cui le applicazioni AI si connettono a origini dati, workflow e strumenti.

Le applicazioni di AI possono utilizzare MCP per accedere ai servizi Google Cloud e Apigee come strumenti. In questo contesto, è utile comprendere i seguenti termini MCP:

  • Host MCP:l'applicazione o l'ambiente AI che interagisce con l'utente. L'host MCP utilizza modelli linguistici di grandi dimensioni (LLM) per elaborare le richieste che potrebbero richiedere dati o strumenti esterni.
  • Client MCP:un componente all'interno dell'host MCP che aiuta il LLM e il server MCP a comunicare tra loro. Traduce le richieste del LLM per il server MCP e converte le risposte del server MCP per il LLM. Inoltre, trova e utilizza i server MCP disponibili.
  • Server MCP:il servizio esterno che fornisce contesto, dati o funzionalità all'LLM, fungendo da proxy tra l'LLM e il client MCP.

Come funziona MCP in Apigee

Gli endpoint MCP per Google, Google Cloude Apigee implementano la specifica del server MCP. In questo modo, i client MCP conformi possono accedervi per:

  • Scopri gli endpoint disponibili.
  • Elenca gli strumenti disponibili in un endpoint.
  • Esegui l'autenticazione a un endpoint.
  • Chiama gli strumenti in base alle policy di accesso definite.

Qualsiasi client MCP che supporti gli endpoint MCP remoti su HTTP/S può accedere a questi strumenti. Poiché gli endpoint sono gestiti, non devi installare o gestire server MCP locali, server MCP remoti o infrastrutture aggiuntive per consentire alle applicazioni con agenti di accedere ai tuoi servizi.

MCP in Apigee offre il supporto JSON-RPC per i metodi tools/list e tools/call. Puoi personalizzare l'endpoint MCP con parametri per rilevabilità, sicurezza, disponibilità di rete e osservabilità.

Funzionalità principali di MCP in Apigee

MCP in Apigee offre funzionalità per il rilevamento, la sicurezza e la governance degli strumenti. Queste funzionalità ti aiutano a gestire il modo in cui le applicazioni con agenti interagiscono con i tuoi servizi.

Rilevamento semplificato degli strumenti con l'hub API

Puoi scoprire gli endpoint MCP disponibili per i servizi Apigee utilizzando un servizio di directory accessibile tramite un'interfaccia REST. Ogni endpoint MCP supporta anche il metodo tools/list di MCP, che consente ai client MCP di scoprire gli strumenti disponibili in quell'endpoint.

Inoltre, MCP si integra con l'hub API Apigee. Quando viene implementato un proxy di rilevamento MCP, l'hub API acquisisce automaticamente la relativa specifica OpenAPI, le assegna lo stile API MCP e mappa le operazioni API ai singoli strumenti MCP. In questo modo, gli sviluppatori possono filtrare facilmente le API abilitate per MCP nell'hub API e utilizzare la ricerca semantica con query in linguaggio naturale per trovare strumenti pertinenti per le loro applicazioni agentiche.

Sicurezza

MCP in Apigee include più livelli di sicurezza per proteggere i tuoi servizi. Puoi controllare l'accesso utilizzando autenticazione, autorizzazione, limiti di rete e scansione dei contenuti.

Autenticazione

Gli endpoint MCP ospitati da Apigee supportano OAuth 2.1 e OpenID Connect (OIDC) per l'autenticazione. In questo modo, solo gli agenti, i client MCP e gli utenti finali con identità stabilite possono accedere agli endpoint MCP e chiamare gli strumenti MCP. I metadati delle risorse protette consentono ai client di scoprire i server di autorizzazione OAuth.

Policy di autorizzazione granulari

Puoi limitare l'accesso agli strumenti MCP in base alle identità dei client OAuth. Ad esempio, puoi configurare un criterio nel proxy MCP Discovery per specificare che solo gli agenti designati con identità client note possono accedere a uno strumento MCP per un servizio di pagamento.

Osservabilità e analisi

Per gli endpoint ospitati da Apigee, puoi utilizzare Apigee Analytics per visualizzare informazioni dettagliate sull'utilizzo degli strumenti MCP. Analytics ti consente di segmentare il traffico specifico di MCP dal traffico API standard e visualizzare le metriche a livello di singolo strumento, ad esempio il volume di richieste tools/list (discovery) rispetto a tools/call (esecuzione). Le metriche sul rendimento ti aiutano anche a distinguere tra l'overhead del proxy e il tempo di risposta target, consentendoti di individuare i colli di bottiglia in modo più efficace.

Affidabilità e risoluzione dei problemi

Per migliorare la risoluzione dei problemi e fornire maggiore visibilità sul processo di deployment, Apigee mostra errori specifici di infrastruttura e configurazione nell'interfaccia utente. Se un deployment non va a buon fine a causa di una specifica OpenAPI non valida o di un problema di infrastruttura come l'esaurimento delle scorte di un bilanciamento del carico in una regione specifica, l'interfaccia utente fornirà un feedback utile per risolvere il problema senza richiedere l'intervento dell'assistenza.

Utilizzo di MCP con Apigee

Puoi esporre le tue API Apigee esistenti come strumenti MCP e renderle accessibili tramite gli endpoint MCP. Questi endpoint possono essere configurati a livello di singolo host o di gruppo di ambienti. Ad esempio, se la tua organizzazione cymbal ha otto nomi host (ad es. api.cymbal.com, partners.cymbal.com), ognuno associato a un gruppo di ambienti diverso, puoi ospitare un server MCP dedicato per ogni nome host.

Un endpoint di destinazione gestito (ORG_NAME.mcp.apigee.internal) viene implementato utilizzando un proxy di rilevamento MCP specializzato nella tua organizzazione Apigee, in cui i server MCP vengono resi disponibili.

La tabella seguente mostra un esempio di come i clienti, inclusa l'organizzazione fittizia di piatti, possono configurare più endpoint MCP utilizzando Apigee.

Cliente Nome host e basepath MCP Endpoint di destinazione del server MCP Proxy API Ambiente / Gruppo di ambienti
piatto api.cymbal.com/mcp cymbal.mcp.apigee.internal
(progetto tenant dell'organizzazione Cymbal)		 mcp-api-proxy1 prod/prod-env-group
api-internal.cymbal.com/mcp cymbal.mcp.apigee.internal
(progetto tenant dell'organizzazione Cymbal)		 mcp-api-proxy2 internal/internal-env-group
api-service.cymbal.com/mcp cymbal.mcp.apigee.internal
(progetto tenant dell'organizzazione Cymbal)		 mcp-api-proxy3 dev/dev-env-group

Limitazioni

A MCP in Apigee si applicano le seguenti limitazioni:

  • Il numero di strumenti MCP in un'organizzazione Apigee è limitato a 1000.
  • Il deployment dell'infrastruttura MCP potrebbe essere soggetto a limitazioni di capacità nelle seguenti regioni:
    • europe-central2
    • europe-southwest1
    • europe-west9
    • me-central2

    Se visualizzi un errore relativo all'errore di provisioning del bilanciatore del carico o lo stato di provisioning non cambia mai in Eseguito il deployment, il problema potrebbe essere dovuto a limiti temporanei della capacità dell'infrastruttura nella regione selezionata. Prova a eseguire il deployment del proxy in un ambiente in un'altra regione.

  • MCP in Apigee supporta le seguenti versioni di OpenAPI: 3.0.0, 3.0.1, 3.0.2. 3.0.3.
  • MCP in Apigee non è disponibile per l'utilizzo con le organizzazioni Apigee Hybrid.
  • Gli approfondimenti sulle API nell'hub API Apigee non sono disponibili per le API e gli strumenti MCP di cui è stato eseguito il deployment nelle organizzazioni Apigee con VPC-SC abilitato.
  • Le chiamate GET sulle risposte di errore MCP restituiranno un errore 405, poiché il server MCP attualmente non supporta i flussi Server-Sent Events (SSE).
  • Gli approfondimenti sull'API Apigee API Hub non mostreranno API o traffico in stile MCP per le risorse MCP finché Apigee versione 1-17-0-apigee-6 non sarà completamente implementata in tutte le regioni disponibili.
  • Non puoi modificare l'attributo dello stile API in MCP per una risorsa API che dispone di operazioni API esistenti.

Passaggi successivi