Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione AI. I server MCP connettono le applicazioni di AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione di AI può comprendere.
Configurazione del server
Prima dell'uso, devi abilitare i server MCP e configurare l'autenticazione. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.
Server MCP per l'API Gemini Enterprise for Customer Experience
Endpoint server
Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (di solito un URL) del server MCP che un'applicazione AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per il LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint Google MCP possono essere globali o regionali.
Il server MCP ces.googleapis.com ha il seguente endpoint MCP:
- https://ces.[REGION].rep.googleapis.com/mcp
Strumenti MCP
Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.
Il server MCP ces.googleapis.com dispone dei seguenti strumenti:
| Strumenti MCP | |
|---|---|
| list_apps | Elenca le app nel progetto e nella località specifici. |
| get_app | Recupera i dettagli dell'app specificata. |
| create_app | Crea una nuova app nel progetto e nella località specificati. |
| update_app | Aggiorna l'app specificata. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_app | Elimina l'app specificata. |
| list_agents | Elenca gli agenti nell'app specificata. |
| get_agent | Recupera i dettagli dell'agente specificato. |
| create_agent | Crea un nuovo agente nell'app specificata. |
| update_agent | Aggiorna l'agente specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_agent | Elimina l'agente specificato. |
| list_tools | Elenca gli strumenti nell'app specificata. |
| get_tool | Recupera i dettagli dello strumento specificato. |
| create_tool | Crea un nuovo strumento nell'app specificata. |
| update_tool | Aggiorna lo strumento specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_tool | Elimina lo strumento specificato. |
| list_guardrails | Elenca i guardrail nell'app specificata. |
| get_guardrail | Recupera i dettagli della barriera protettiva specificata. |
| create_guardrail | Crea una nuova barriera protettiva nell'app specificata. |
| update_guardrail | Aggiorna la barriera di protezione specificata. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_guardrail | Elimina la barriera protettiva specificata. |
| list_deployments | Elenca i deployment nell'app specificata. |
| get_deployment | Recupera i dettagli del deployment specificato. |
| create_deployment | Crea un nuovo deployment nell'app specificata. |
| update_deployment | Aggiorna il deployment specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_deployment | Elimina il deployment specificato. |
| list_toolsets | Elenca i toolset nell'app specificata. |
| get_toolset | Recupera i dettagli del set di strumenti specificato. |
| create_toolset | Crea un nuovo toolset nell'app specificata. |
| update_toolset | Aggiorna il set di strumenti specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_toolset | Elimina il set di strumenti specificato. |
| list_app_versions | Elenca tutte le versioni dell'app specificata. |
| get_app_version | Recupera i dettagli della versione dell'app specificata. |
| create_app_version | Crea una nuova versione dell'app nell'app specificata. |
| delete_app_version | Elimina la versione dell'app specificata. |
| restore_app_version | Ripristina la versione dell'app specificata. |
| list_changelogs | Elenca i log delle modifiche nell'app specificata. |
| get_changelog | Recupera i dettagli del changelog specificato. |
| start_export_app | Avvia l'esportazione di un'app CES |
| start_import_app | Avvia l'importazione di un'app CES |
| run_evaluation | Esegue una valutazione per un'app CES |
| create_evaluation | Crea una nuova valutazione. |
| create_evaluation_dataset | Crea un nuovo set di dati di valutazione. |
| delete_evaluation | Elimina la valutazione specificata. |
| delete_evaluation_dataset | Elimina il set di dati di valutazione specificato. |
| generate_evaluation_from_conversation | Genera una valutazione da una conversazione. |
| get_evaluation | Recupera i dettagli della valutazione specificata. |
| get_evaluation_dataset | Recupera i dettagli del set di dati di valutazione specificato. |
| get_evaluation_result | Recupera i dettagli del risultato della valutazione specificato. |
| get_evaluation_run | Recupera i dettagli dell'esecuzione della valutazione specificata. |
| list_evaluation_datasets | Elenca i set di dati di valutazione. |
| list_evaluation_results | Elenca i risultati della valutazione. |
| list_evaluation_runs | Elenca le esecuzioni della valutazione. |
| list_evaluations | Elenca le valutazioni. |
| update_evaluation | Aggiorna la valutazione specificata. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| update_evaluation_dataset | Aggiorna il set di dati di valutazione specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input. |
| delete_evaluation_result | Elimina il risultato della valutazione specificato. |
| delete_evaluation_run | Elimina l'esecuzione della valutazione specificata. |
| get_conversation | Recupera i dettagli della conversazione specificata. |
| list_conversations | Elenca le conversazioni. |
| get_operation |
Recupera lo stato di un'operazione a lunga esecuzione. Utilizzo Alcuni strumenti (ad esempio Parametri * |
Ottenere le specifiche dello strumento MCP
Per ottenere le specifiche dello strumento MCP per tutti gli strumenti in un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili nel server MCP.
| Curl Request |
|---|
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |