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 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, eseguine 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: Build and Deploy a Remote MCP Server to Google Cloud Run in Under 10 Minutes.
Anziché creare un server MCP da zero, puoi anche utilizzare un server MCP precompilato, ad esempio un Google Cloud server MCP.
Autenticazione
Gli strumenti MCP hanno le stesse opzioni di autenticazione degli strumenti OpenAPI.
Intestazioni personalizzate
Puoi fornire intestazioni HTTP personalizzate da inviare nelle richieste al server MCP. Puoi anche inserire variabili dal contesto della sessione in queste intestazioni. Per ulteriori informazioni, consulta Variabili del contesto della sessione.
Testa il server MCP in modo indipendente
Prima di connettere gli agenti al server MCP, ti consigliamo di testare il server MCP 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, il server è attivo e funzionante e le informazioni di autenticazione necessarie per comunicare con il server vengono comprese.
Intestazioni personalizzate
Puoi definire intestazioni personalizzate da includere quando invii richieste HTTP al server MCP (richieste di elenco di strumenti e di esecuzione di strumenti). I valori di queste intestazioni devono essere forniti dalle variabili, quindi per definire un'intestazione personalizzata, devi prima definire una variabile che conterrà il valore dell'intestazione. Se una variabile non contiene un valore e non è presente un valore predefinito in fase di runtime, l'intestazione non verrà inclusa nelle richieste.
Crea lo strumento MCP
Per creare uno strumento MCP dalla console:
- Fai clic sull'icona dello strumento sul lato destro del builder dell'agente.
- 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.
- (Facoltativo) Definisci le intestazioni personalizzate fornendo i nomi delle intestazioni e le variabili utilizzate come valori delle intestazioni.
- 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 di CX Agent Studio (nel formato service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com) per inviare richieste al job Cloud Run.
Concedi il
ruolo Invocatore 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 testare almeno uno strumento per assicurarti che le informazioni di autenticazione siano configurate correttamente.