Configurare il server MCP della chat

Google Chat offre un server Model Context Protocol (MCP) remoto che consente agli agenti AI di interagire in modo sicuro con i dati di Google Chat. Se configuri il server MCP di Google Chat, consenti alle applicazioni AI come Google Antigravity e Claude di eseguire azioni in Google Chat.

Il server MCP di Google Chat offre un modo standardizzato per gli agenti AI di:

  • Leggi dati: elenca e cerca le conversazioni e leggi i messaggi.
  • Rispetta la sicurezza: eredita le stesse autorizzazioni e gli stessi controlli di governance dei dati dell'utente.

Prerequisiti

Configurare il server MCP di Google Chat

Per utilizzare il server MCP di Google Chat, devi abilitarlo nel tuo progetto Google Cloud e poi configurare il client MCP per connetterti.

Abilita le API

Per utilizzare il server Google Chat MCP, devi abilitare le seguenti API nel tuo progetto Google Cloud:

  • API Google Chat

Interfaccia a riga di comando

gcloud services enable chat.googleapis.com --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

Console

Abilita le API nella console Google Cloud:

Abilita le API

Attiva i servizi MCP

Per abilitare i componenti MCP per Google Chat, devi abilitare il seguente servizio nel tuo progetto Google Cloud:

  • API Google Chat MCP

Interfaccia a riga di comando

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

Console

Abilita i servizi MCP nella console Google Cloud:

Attivare i servizi MCP

Configurare l'app Chat

Per utilizzare il server MCP di Google Chat, devi configurare un'app Chat nel tuo progetto Google Cloud.

  1. Nella console Google Cloud, cerca API Google Chat e fai clic su API Google Chat > Gestisci > Configurazione.

    Vai all'API Google Chat

  2. Configura l'app Chat:

    1. Nel campo Nome app, inserisci Chat MCP.
    2. Nel campo URL avatar, inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. In Descrizione, inserisci Chat MCP server.
    4. In Funzionalità, disattiva le funzionalità interattive disattivando l'opzione Attiva funzionalità interattive.
    5. In Log, seleziona Errori di log in Logging.

  3. Fai clic su Salva.

Per scoprire di più sulla creazione di un'app Chat, vedi Scegliere un'architettura per l'app Google Chat.

Il server MCP di Google Chat utilizza OAuth 2.0 per l'autenticazione e l'autorizzazione. Devi configurare la schermata per il consenso OAuth prima di poter creare un ID client OAuth.

  1. Nella console Google Cloud, vai a Google Auth Platform > Branding.

    Vai a Branding

  2. Se hai già configurato la piattaforma Google Auth, puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se viene visualizzato il messaggio Google Auth Platform non ancora configurata, fai clic su Inizia:

    1. In Informazioni sull'app, digita Chat MCP Server in Nome app.
    2. In Email di assistenza utenti, seleziona il tuo indirizzo email o un gruppo Google appropriato.
    3. Fai clic su Avanti.
    4. Nella sezione Pubblico, seleziona Interno. Se non riesci a selezionare Interno, seleziona Esterno.
    5. Fai clic su Avanti.
    6. In Informazioni di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al progetto.
    7. Fai clic su Avanti.
    8. In Fine, leggi le Norme relative ai dati utente dei servizi API di Google e, se le accetti, seleziona Accetto le Norme relative ai dati utente dei servizi API di Google.
    9. Fai clic su Continua.
    10. Fai clic su Crea.
    11. Se hai selezionato Esterno per il tipo di utente, aggiungi utenti di test:
      1. Fai clic su Segmento di pubblico.
      2. Nella sezione Utenti di test, fai clic su Aggiungi utenti.
      3. Inserisci il tuo indirizzo email e gli altri utenti di test autorizzati, quindi fai clic su Salva.

  3. Fai clic su Accesso ai dati > Aggiungi o rimuovi ambiti. Viene visualizzato un riquadro con un elenco di ambiti per ogni API che hai abilitato nel tuo progetto Google Cloud.

    1. Nella sezione Aggiungi ambiti manualmente, incolla gli ambiti per il server MCP di Google Chat:

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate.readonly

    2. Fai clic su Aggiungi alla tabella.

    3. Fai clic su Aggiorna.

    4. Dopo aver selezionato gli ambiti richiesti dalla tua app, fai clic su Salva nella pagina Accesso ai dati.

Configura il client MCP

Per aggiungere il server MCP remoto di Google Chat al client MCP, segui le istruzioni per il tuo client.

Antigravity

Per aggiungere il server MCP remoto di Google Chat ad Antigravity, aggiungi la configurazione del server al file mcp_config.json. Queste istruzioni supportano Antigravity 2.0, Antigravity IDE e Antigravity CLI.

  1. Crea un ID client e un client secret OAuth 2.0:

    1. Nella console Google Cloud, vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

    2. Seleziona Applicazione web come tipo di applicazione.

    3. Inserisci un Nome.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI, quindi aggiungi https://antigravity.google/oauth-callback nel campo URI.

    5. Fai clic su Crea e copia l'ID client e il client secret.

  2. Apri o crea il file di configurazione ~/.gemini/antigravity/mcp_config.json.

  3. Aggiungi la configurazione mcpServers a mcp_config.json:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Sostituisci quanto segue:

    • OAUTH_CLIENT_ID: l'ID client che hai creato.
    • OAUTH_CLIENT_SECRET: Il client secret che hai creato.

  4. Risparmia mcp_config.json.

  5. Autentica il server MCP. Puoi autenticarti utilizzando le impostazioni della GUI o la CLI:

    • Per Antigravity IDE o GUI (Antigravity 2.0):

      1. Apri la schermata delle impostazioni (ad es. fai clic su Impostazioni in basso a sinistra o apri Impostazioni utente Antigravity).
      2. Vai a Personalizzazioni.
      3. Nella sezione Server MCP installati, fai clic su Aggiorna.
      4. Trova chat nell'elenco, fai clic su Autentica, accedi al tuo Account Google, copia il codice di autorizzazione, incollalo nella finestra di dialogo di input e fai clic su Invia.

    • Per Antigravity CLI:

      1. Avvia Antigravity CLI:

        agy

      2. Apri il pannello di gestione interattivo di MCP eseguendo:

        /mcp

      3. Utilizza i tasti freccia per selezionare chat, vai all'azione Autentica e premi Invio. Completa il flusso di accesso nel browser, copia il codice di autorizzazione, incollalo nel prompt del terminale e premi Invio.

  6. Verifica che il server sia configurato correttamente e in esecuzione:

    • Per l'IDE o la GUI di Antigravity: viene visualizzato un pulsante Esci accanto al server in Personalizzazioni > Server MCP installati.
    • Per l'interfaccia a riga di comando Antigravity: apri il riquadro /mcp per visualizzare i server MCP configurati. I server verificati e autenticati mostrano Autenticato accanto ai loro nomi nel riquadro TUI interattivo. Puoi selezionare qualsiasi server nella visualizzazione della dashboard per esaminarne lo stato ed elencare tutti gli strumenti disponibili.

Il server MCP remoto è pronto per l'uso in Antigravity.

Claude

Per utilizzare il server MCP remoto di Google Chat con Claude.ai o Claude Desktop, devi disporre del piano Claude Enterprise, Pro, Max o Team.

Per aggiungere il server MCP remoto di Google Chat a Claude, configura un connettore personalizzato con un ID client OAuth e un client secret.

  1. Crea un ID client e un client secret OAuth 2.0:

    1. Nella console Google Cloud, vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

    2. Seleziona Applicazione web come tipo di applicazione.

    3. Inserisci un Nome.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI, quindi aggiungi https://claude.ai/api/mcp/auth_callback nel campo URI.

    5. Fai clic su Crea e copia l'ID client e il client secret.

  2. Configura il server MCP in Claude:

    1. In Claude.ai o Claude Desktop, vai a Impostazioni (o Impostazioni amministrazione) > Connettori.
    2. Fai clic su Aggiungi connettore personalizzato.
    3. Inserisci i dettagli della connessione per il prodotto Google Chat:
      • Nome server: Google Chat
      • URL server MCP remoto: https://chatmcp.googleapis.com/mcp/v1
    4. In Impostazioni avanzate, inserisci l'ID client OAuth e il segreto client OAuth.
    5. Fai clic su Aggiungi.

Altro

Molte applicazioni di AI hanno modi per connettersi a un server MCP remoto. In genere devi inserire i dettagli del server, come nome, endpoint, protocollo di trasporto e metodo di autenticazione. Per il server MCP remoto di Google Chat, inserisci quanto segue:

Per maggiori dettagli sulla connessione di diversi tipi di client, vedi Configurare MCP in un'applicazione AI.

Testare il server MCP di Google Chat

Dopo aver configurato il client MCP, puoi verificare la connessione eseguendo alcuni prompt di test.

Prova a porre al cliente MCP le seguenti domande:

  • "Qual è stato l'ultimo messaggio nello spazio "Progetto X"?"

    Il client trova lo spazio utilizzando search_conversations e poi recupera i messaggi utilizzando list_messages.

Se gli strumenti vengono eseguiti correttamente e ricevi risposte pertinenti, il server MCP di Google Chat è configurato correttamente.

Risoluzione dei problemi

Se riscontri problemi di connessione al server MCP, puoi verificare la presenza di errori nei log OAuth. Chiedi all'amministratore di controllare gli eventi del log OAuth nello strumento di indagine sulla sicurezza.

Riferimento allo strumento

Per il server MCP di Google Chat sono disponibili i seguenti strumenti:

  • search_conversations
  • list_messages
  • search_messages
  • send_message

Considerazione importante per la sicurezza: prompt injection indiretta

Quando esponi un modello linguistico a dati non attendibili, esiste il rischio di un attacco di prompt injection indiretto. Poiché i client MCP come Google Antigravity hanno accesso a strumenti e API potenti tramite il server MCP di Google Chat, possono leggere, modificare ed eliminare i dati nel tuo Account Google.

Per mitigare questi rischi, segui queste best practice:

  • Utilizza solo strumenti attendibili.Non connettere mai il server MCP di Google Chat ad applicazioni non attendibili o non verificate.
  • Fai attenzione agli input non attendibili.Evita di chiedere al client MCP di elaborare messaggi o altre risorse provenienti da fonti non verificate. Questi input potrebbero contenere istruzioni nascoste che possono compromettere la tua sessione, consentendo a un malintenzionato di modificare, rubare o eliminare i tuoi dati.
  • Rivedi tutte le azioni. Controlla sempre attentamente le azioni intraprese dal tuo client AI per tuo conto per assicurarti che siano corrette e in linea con le tue intenzioni.