MCP Reference: chatmcp.googleapis.com

L'API MCP di Chat fornisce MCP remota per le funzionalità di Google Chat.

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 AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione AI può comprendere.

Configurazione del server

Prima di utilizzarlo, devi configurare il server MCP di Chat. Per saperne di più 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 (in genere 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 MCP di Google possono essere globali o regionali.

Il server MCP dell'API Chat ha il seguente endpoint MCP globale:

  • https://chatmcp.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.

Strumenti

Il server MCP chatmcp.googleapis.com ha i seguenti strumenti:

Strumenti MCP
list_messages Recupera i messaggi da una conversazione di Google Chat specificata (spazio, messaggio diretto o messaggio diretto di gruppo). Consente di filtrare per thread, intervallo di tempo e numero di messaggi. Inoltre, è possibile recuperare la pagina successiva dei messaggi per consentire un contesto più ampio. I messaggi privati (messaggi visibili solo a un singolo utente) vengono filtrati.
search_conversations

Cerca le conversazioni di Google Chat in base al nome visualizzato.

Se vengono forniti solo i partecipanti, questo strumento trova i messaggi diretti 1:1 (se viene fornito un partecipante) o le chat di gruppo (se vengono forniti più partecipanti) che includono i partecipanti specificati e l'utente chiamante.

Se viene fornita solo una query, questo strumento cerca le conversazioni in cui la query è una sottostringa senza distinzione tra maiuscole e minuscole del nome visualizzato della conversazione.

Se vengono forniti sia i partecipanti sia la query, questo strumento trova le conversazioni in base ai partecipanti e poi le filtra in base al nome visualizzato.

Se non vengono forniti né i partecipanti né la query, questo strumento elenca tutte le conversazioni di cui l'utente chiamante è membro.

Questo strumento elenca solo le conversazioni di cui l'utente chiamante è membro.

IMPORTANTE: un elenco "conversazioni" vuoto non significa che non ci siano altri risultati in generale. Se è presente "next_page_token", è possibile recuperare altre pagine. Se ricevi un elenco vuoto ma un "next_page_token", chiedi all'utente se devi continuare la ricerca.

Recuperare le specifiche degli strumenti MCP

Per recuperare le specifiche degli strumenti 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://chatmcp.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
}'