Model Context Protocol (MCP) è uno standard open source per connettere le applicazioni AI a sistemi esterni. Stabilisce un insieme specifico di entità e una struttura definita, che funge da modo standard per connettere varie origini dati e strumenti con i modelli di AI.
Puoi utilizzare gli strumenti MCP per connettere l'applicazione dell'agente a un server MCP esistente.
Limitazioni
Si applicano le seguenti limitazioni:
- CX Agent Studio supporta solo i server basati su StreamableHttpTransport; i server di trasporto SSE non sono supportati.
Crea o seleziona un server MCP
Per creare il tuo server MCP, ti consigliamo di utilizzare gli SDK MCP ufficiali o altri SDK di terze parti affidabili come FastMCP. Una volta creato il server MCP, esegui il deployment in un servizio di hosting. Puoi utilizzare Cloud Run o Compute Engine per ospitare il server MCP. Ti consigliamo di seguire questa guida per comprendere l'intero processo: Crea ed esegui il deployment di un server MCP remoto in Google Cloud meno di 10 minuti.
Invece di creare un server MCP da zero, puoi anche utilizzare un server MCP predefinito, ad esempio un Google Cloud server MCP.
Autenticazione
Gli strumenti MCP hanno le stesse opzioni di autenticazione degli strumenti OpenAPI.
Testare il server MCP in modo indipendente
Prima di connettere gli agenti al server MCP,
ti consigliamo di testarlo in modo indipendente.
I server creati utilizzando StreamableHttpTransport
terminano con il suffisso (/mcp o /mcp/).
Ad esempio, se il server è ospitato all'indirizzo https://example.com,
l'URL corretto a cui inviare le richieste al server è https://example.com/mcp.
Per testare il server localmente, valuta la possibilità di utilizzare curl o Postman (che supporta in modo nativo le connessioni MCP). In questo modo si assicura che il server sia attivo e funzionante e che le informazioni di autenticazione necessarie per comunicare con il server siano comprese.
Crea lo strumento MCP
Per creare uno strumento MCP dalla console:
- Fai clic sull'icona degli strumenti sul lato destro del generatore di agenti.
- Seleziona Strumento MCP.
- Fornisci un nome per lo strumento.
- Fornisci una descrizione dello strumento.
- Fornisci l'indirizzo del server MCP.
- Seleziona un tipo di autenticazione.
- Fai clic su Crea.
Per i server ospitati su Cloud Run,
l'opzione di autenticazione consigliata è Token ID agente di servizio.
Questo metodo utilizza il account di servizio CX Agent Studio
(nel formato: service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com)
per inviare richieste
al job Cloud Run.
Concedi il
ruolo Invoker Cloud Run
al account di servizio di CX Agent Studio
, in modo che possa inviare richieste al server utilizzando la propria identità.
Prima di aggiungere altri strumenti all'agente, ti consigliamo di testarne almeno uno per assicurarti che le informazioni di autenticazione siano configurate correttamente.