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 collegano 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 ulteriori informazioni sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.
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 l'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 dell'API di dati Google Analytics ha il seguente endpoint MCP globale:
- https://analyticsdata.googleapis.com/mcp/v1
Il server MCP dell'API Google Analytics Data offre il seguente endpoint del set di strumenti MCP:
- https://analyticsdata.googleapis.com/mcp/v1
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. I toolset sono un gruppo di strumenti utili per un'attività specifica. L'utilizzo di toolset può aiutare l'agente a ottenere risultati migliori perché riduce il numero di strumenti a sua disposizione.
Set di strumenti
Il server MCP analyticsdata.googleapis.com ha il seguente set di strumenti:
| Set di strumenti MCP | ||
|---|---|---|
| Endpoint | Descrizione | Strumenti |
| /mcp/v1 | Set di strumenti MCP dell'API di dati di Google Analytics | |
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.
| Richiesta curl |
|---|
curl --location 'https://analyticsdata.googleapis.com/mcp/v1' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |