MCP Reference: people.googleapis.com

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.

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 people.googleapis.com dispone dei seguenti strumenti:

Strumenti MCP
search_directory_people

Cercare persone all'interno della directory Google Workspace della tua organizzazione. Questa funzionalità è disponibile esclusivamente per gli account Google Workspace (utilizzati da aziende, scuole e altre organizzazioni) e non per gli Account Google personali.

REGOLE IMPORTANTI DA SEGUIRE:

  • Se questo strumento restituisce più risultati, devi presentarli all'utente e chiedergli di chiarire quale risultato utilizzare prima di procedere.

  • È severamente vietato passare l'output di questo strumento a un altro strumento (ad es. inviare un'email, creare una bozza, creare un evento e così via) senza la conferma esplicita dell'utente.

  • Anche se viene trovato un solo risultato, devi mostrare all'utente i dettagli della persona trovata e invitarlo a verificare che si tratti della persona che intendeva cercare prima di procedere con i passaggi successivi.

  • Se questo strumento non restituisce risultati, utilizza lo strumento search_contacts.
search_contacts

Cerca i contatti dell'utente.

REGOLE IMPORTANTI DA SEGUIRE:

  • Se questo strumento restituisce più risultati, devi presentarli all'utente e chiedergli di chiarire quale risultato utilizzare prima di procedere.

  • È severamente vietato passare l'output di questo strumento a un altro strumento (ad es. inviare un'email, creare una bozza, creare un evento e così via) senza la conferma esplicita dell'utente.

  • Anche se viene trovato un solo risultato, devi mostrare all'utente i dettagli della persona trovata e invitarlo a verificare che si tratti della persona che intendeva cercare prima di procedere con i passaggi successivi.
get_user_profile Recuperare le informazioni del profilo (nome ed email).

Ottenere le specifiche dello strumento MCP

Per ottenere le specifiche dello strumento MCP per tutti gli strumenti di 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://people.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
}'