Configurare i server MCP di Google Workspace

Google Workspace offre server Model Context Protocol (MCP) remoti che consentono agli agenti AI di interagire in modo sicuro con i dati di Google Workspace. Configurando i server MCP di Google Workspace, consenti alle applicazioni AI come Google Antigravity e Claude di eseguire azioni nelle applicazioni Google Workspace come Gmail, Google Drive, Documenti Google, Fogli Google, Presentazioni Google, Google Calendar, Google Chat e Google Classroom. Ogni prodotto Google Workspace ha il proprio server MCP dedicato.

I server MCP di Google Workspace forniscono un modo standardizzato per gli agenti AI di:

  • Lettura dei dati: cerca email, recupera file ed elenca eventi nel calendario.
  • Passa all'azione: crea bozze di email, carica file e pianifica riunioni.
  • Rispetta la sicurezza: eredita le stesse autorizzazioni e gli stessi controlli di governance dei dati dell'utente.

Prerequisiti

Configura i server MCP di Google Workspace

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

Abilita le API

Per utilizzare i server MCP di Google Workspace, devi abilitare le seguenti API nel tuo progetto Google Cloud:

  • API Gmail
  • API Google Drive
  • API Documenti Google
  • API Google Sheets
  • API Presentazioni Google
  • API Google Calendar
  • API Google Chat
  • API People
  • API Google Classroom

Interfaccia a riga di comando

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID progetto Google Cloud.

Console

Abilita le API nella console Google Cloud:

Abilita le API

Abilita i servizi MCP

Per abilitare i componenti MCP per ogni prodotto Google Workspace, devi abilitare i seguenti servizi nel tuo progetto Google Cloud:

  • API Gmail MCP
  • API Google Drive MCP
  • API MCP di Documenti Google
  • API Fogli Google MCP
  • API Google Slides MCP
  • API Google Calendar MCP
  • API Google Chat MCP
  • API People MCP
  • API Google Classroom MCP

Interfaccia a riga di comando

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID progetto Google Cloud.

Console

Abilita i servizi MCP nella console Google Cloud:

Attiva i servizi MCP

Configura l'app di Chat

Per utilizzare il server MCP di Google Chat, devi configurare un'app di 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 Avatar URL (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 Abilita 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 di Chat, consulta Scegli un'architettura per l'app Google Chat.

I server MCP di Google Workspace utilizzano 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 Google Auth Platform, 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 Workspace MCP Servers in Nome app.
    2. In Email per l'assistenza utenti, seleziona il tuo indirizzo email o un gruppo Google appropriato.
    3. Fai clic su Avanti.
    4. In Pubblico, seleziona Interno. Se non riesci a selezionare Interno, seleziona Esterno.
    5. Fai clic su Avanti.
    6. In Dati di contatto, inserisci un indirizzo email a cui puoi ricevere notifiche relative a eventuali 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 accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.
    9. Fai clic su Continua.
    10. Fai clic su Crea.
    11. Se hai selezionato Esterno come tipo di utente, aggiungi gli utenti di test:
      1. Fai clic su Pubblico.
      2. Nella sezione Utenti di test, fai clic su Aggiungi utenti.
      3. Inserisci il tuo indirizzo email e quello di 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. In Aggiungi ambiti manualmente, incolla gli ambiti per i server MCP che vuoi utilizzare:

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google Drive:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • Documenti Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • Fogli Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/spreadsheets.readonly
        • https://www.googleapis.com/auth/spreadsheets
      • Presentazioni Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • Google Calendar:
        • https://www.googleapis.com/auth/calendar.calendarlist.readonly
        • https://www.googleapis.com/auth/calendar.events.freebusy
        • https://www.googleapis.com/auth/calendar.events.readonly
      • 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
      • API People:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly
    2. Fai clic su Aggiungi alla tabella.

    3. Fai clic su Aggiorna.

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

Configura il client MCP

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

Antigravity

Per aggiungere i server MCP remoti di Google Workspace 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 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. Seleziona Utilizza questo client per un agente basato sull'AI.

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

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

  3. Aggiungi la configurazione mcpServers a mcp_config.json:

    {
      "mcpServers": {
        "gmail": {
          "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "drive": {
          "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "docs": {
          "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "sheets": {
          "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "slides": {
          "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "calendar": {
          "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "chat": {
          "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "people": {
          "serverUrl": "https://people.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "classroom": {
          "serverUrl": "https://classroommcp.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 i server MCP. Puoi eseguire l'autenticazione utilizzando le impostazioni della GUI o l'interfaccia a riga di comando:

    • Per Antigravity IDE o GUI (Antigravity 2.0):

      1. Apri la schermata delle impostazioni (ad esempio, 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. Per ogni server elencato (gmail, drive, docs, sheets, slides, calendar, chat, people e classroom), 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 riquadro di gestione interattivo di MCP eseguendo:

        /mcp
        
      3. Autentica ogni server MCP:

        1. Utilizza i tasti freccia per selezionare il server, 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.
        2. Ripeti questi passaggi per ogni server configurato (gmail, drive, docs, sheets, slides, calendar, chat, people e classroom).
  6. Verifica che i server siano configurati correttamente e in esecuzione:

    • Per Antigravity IDE o la GUI: viene visualizzato un pulsante Esci accanto a ogni server in Personalizzazioni > Server MCP installati.
    • Per Antigravity CLI: apri il riquadro /mcp per visualizzare i server MCP configurati. I server verificati e autenticati mostrano Authed accanto ai loro nomi all'interno del riquadro TUI interattivo. Puoi selezionare qualsiasi server nella visualizzazione della dashboard per controllarne lo stato ed elencare tutti gli strumenti disponibili.

I server MCP remoti sono pronti per l'uso in Antigravity.

Claude

Per utilizzare i server MCP remoti di Google Workspace con Claude.ai o Claude Desktop, devi disporre del piano Claude Enterprise, Pro, Max o Team.

Per aggiungere i server MCP remoti di Google Workspace a Claude, configura un connettore personalizzato con un ID client OAuth e un secret.

  1. Crea un ID client e un 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. Seleziona Utilizza questo client per un agente basato sull'AI.

    6. 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 amministratore) > Connettori.
    2. Fai clic su Aggiungi connettore personalizzato.
    3. Inserisci i dettagli della connessione per il prodotto Google Workspace che vuoi aggiungere:

      • Nome server: un nome per il server, ad esempio Gmail.
      • URL del server MCP remoto: l'URL del prodotto Google Workspace, ad esempio uno dei seguenti:
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google Drive: https://drivemcp.googleapis.com/mcp/v1
        • Documenti Google: https://docsmcp.googleapis.com/mcp/v1
        • Fogli Google: https://sheetsmcp.googleapis.com/mcp/v1
        • Presentazioni Google: https://slidesmcp.googleapis.com/mcp/v1
        • Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • API People: https://people.googleapis.com/mcp/v1
        • Google Classroom: https://classroommcp.googleapis.com/mcp/v1
    4. In Impostazioni avanzate, inserisci l'ID client OAuth e il client secret OAuth.

    5. Fai clic su Aggiungi.

    6. Ripeti questi passaggi per ogni prodotto Google Workspace che vuoi aggiungere.

Altri

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

  • Nome server: googleworkspace

  • Server: ogni prodotto Google Workspace ha il proprio URL del server:

    • Gmail: https://gmailmcp.googleapis.com/mcp/v1
    • Google Drive: https://drivemcp.googleapis.com/mcp/v1
    • Documenti Google: https://docsmcp.googleapis.com/mcp/v1
    • Fogli Google: https://sheetsmcp.googleapis.com/mcp/v1
    • Presentazioni Google: https://slidesmcp.googleapis.com/mcp/v1
    • Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
    • Google Chat: https://chatmcp.googleapis.com/mcp/v1
    • API People: https://people.googleapis.com/mcp/v1
    • Google Classroom: https://classroommcp.googleapis.com/mcp/v1
  • Trasporto: HTTP trasmissibile in streaming

  • Autenticazione: il server MCP remoto di Google Workspace utilizza OAuth 2.0. Quando crei il client OAuth 2.0, seleziona Utilizza questo client per un agente basato sull'AI. Per maggiori dettagli, consulta Scopri di più su autenticazione e autorizzazione.

    Il client MCP richiede un token di aggiornamento per evitare che gli utenti debbano accedere nuovamente ogni ora circa. Il server OAuth 2.0 di Google emette un token di aggiornamento solo quando la richiesta di autorizzazione include access_type=offline. La richiesta del solo ambito offline_access OpenID Connect (OIDC) non ne restituisce uno. Se il tuo client MCP supporta parametri di autorizzazione personalizzati, aggiungi access_type=offline alla richiesta di autorizzazione. Per ottenere un nuovo token di aggiornamento per un utente che ha già concesso l'accesso, aggiungi anche prompt=consent. Se il tuo client MCP non supporta i parametri di autorizzazione personalizzati, gli utenti devono accedere di nuovo ogni volta che il token di accesso scade. Per maggiori dettagli, consulta Aggiorna un token di accesso.

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

Testa i server MCP di Google Workspace

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

Prova a porre al tuo cliente MCP le seguenti domande:

  • "Cosa ha detto Ariel nella sua ultima email sul nostro piano di marketing?"

    Il client filtra le email di Ariel utilizzando gmail.search_threads, recupera i contenuti del thread più recente con gmail.get_thread e poi li riassume per te.

  • "Scrivi una bozza di email per ariel@example.com dicendo che approvo il piano di marketing."

    Il client utilizza gmail.create_draft per creare un'email nella cartella Bozze, consentendoti di rivederla e inviarla da Gmail.

  • "Riassumi il file Piano di marketing."

    Il client chiama drive.search_files per individuare "Piano di marketing", quindi utilizza drive.read_file_content per recuperare e riassumere i contenuti.

  • "Mostrami i contenuti strutturali degli appunti della riunione di Documenti Google."

    Il client recupera la struttura e i contenuti del documento utilizzando docs.read_doc.

  • "Leggi il foglio Foglio1 dal foglio Google Vendite trimestrali."

    Il client recupera i valori della griglia utilizzando sheets.get_values.

  • "Mostrami il layout verbalizzato della presentazione Panoramica del prodotto di Presentazioni Google."

    Il client recupera le strutture del layout grafico della presentazione utilizzando slides.read_presentation.

  • "Quando è la mia prossima riunione con Ariel?"

    Il cliente controlla la tua pianificazione utilizzando calendar.list_events e descrive la tua prossima riunione con Ariel.

  • "Secondo il mio profilo Google, come mi chiamo?"

    Il client utilizza people.get_user_profile per recuperare le informazioni del tuo profilo Google Workspace.

  • "Quali corsi sto insegnando attualmente?"

    Il client controlla la tua pianificazione utilizzando classroom.list_course_summaries e riassume i corsi attivi in cui hai il ruolo di insegnante.

  • "Per il mio corso di geologia, scrivi una bozza di annuncio sulla prossima gita."

    Il client utilizza classroom.create_announcement per creare la bozza dell'annuncio, che puoi rivedere e pubblicare nell'app Google Classroom.

Se gli strumenti vengono eseguiti correttamente e ricevi risposte pertinenti, i tuoi server MCP di Google Workspace sono configurati correttamente.

Risoluzione dei problemi

Se riscontri problemi di connessione ai server MCP, puoi controllare se sono presenti errori nei log OAuth. Chiedi all'amministratore di controllare gli eventi del log OAuth nello strumento di indagine sulla sicurezza.

Se le tue richieste ai server MCP vengono rifiutate, verifica che il tuo client OAuth 2.0 abbia selezionato Utilizza questo client per un agente basato sull'AI in Google Auth Platform > Client. Se non riesci a modificare questa impostazione su un client OAuth esistente, crea un nuovo client OAuth con l'opzione Utilizza questo client per un agente basato sull'AI selezionata e aggiorna l'app per utilizzarlo. Se un client OAuth esistente viene utilizzato sia per le funzionalità dell'agente AI sia per quelle non dell'agente, crea un client OAuth separato per l'agente AI e mantieni il client esistente per le funzionalità non dell'agente. Per istruzioni, consulta Configura il client MCP e Gestisci i client OAuth.

Se la tua app utilizza un service account con delega a livello di dominio, non puoi selezionare Utilizza questo client per un agente basato sull'AI perché i service account non sono gestiti in Google Auth Platform > Client. Le richieste ai server MCP da parte di service account che utilizzano la delega a livello di dominio non vengono rifiutate per questo motivo. L'accesso è controllato dalle impostazioni di delega a livello di dominio gestite dall'amministratore di Google Workspace. Per maggiori dettagli, consulta Controlla l'accesso all'API con la delega a livello di dominio.

Se chiami i server MCP da Google Apps Script, Apps Script crea e gestisce un client OAuth predefinito per il tuo script, ma non puoi selezionare Utilizza questo client per un agente basato sull'AI. Questo vale anche se lo script utilizza un progetto Google Cloud standard. Segui, invece, questi passaggi:

  1. Nella console Google Cloud, vai a Google Auth Platform > Client, crea un client OAuth e seleziona Utilizza questo client per un agente basato sull'AI.
  2. Nello script, utilizza la libreria OAuth2 per Apps Script per autorizzare gli utenti con quel client OAuth.
  3. Quando chiami i server MCP, invia il token di accesso restituito dalla libreria anziché il token di ScriptApp.getOAuthToken.

I progetti Apps Script che non chiamano i server MCP non sono interessati.

Se ti viene chiesto di accedere di nuovo ogni ora circa, il tuo client MCP non riceve un token di aggiornamento. Il server OAuth 2.0 di Google emette un token di aggiornamento solo quando la richiesta di autorizzazione include access_type=offline. La richiesta del solo ambito OpenID Connect (OIDC) offline_access non ne restituisce uno. Se il tuo client MCP supporta parametri di autorizzazione personalizzati, aggiungi access_type=offline alla richiesta di autorizzazione. Per ottenere un nuovo token di aggiornamento per un utente che ha già concesso l'accesso, aggiungi anche prompt=consent. Se il tuo client MCP non supporta i parametri di autorizzazione personalizzati, devi accedere di nuovo ogni volta che il token di accesso scade. Per maggiori dettagli, consulta Aggiorna un token di accesso.

Prodotti supportati

I seguenti prodotti Google Workspace supportano i server MCP di Google Workspace e offrono i seguenti strumenti:

Considerazione importante sulla sicurezza: prompt injection indiretto

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 i server MCP di Google Workspace, possono leggere, modificare ed eliminare i dati nel tuo Account Google.

Per mitigare questi rischi, segui queste best practice:

  • Utilizza solo strumenti attendibili. Non collegare mai i server MCP di Google Workspace ad applicazioni non attendibili o non verificate.
  • Fai attenzione agli input non attendibili. Evita di chiedere al tuo client MCP di elaborare email, documenti 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.
  • Esamina tutte le azioni. Esamina sempre attentamente le azioni intraprese dal tuo client AI per tuo conto per assicurarti che siano corrette e in linea con le tue intenzioni.