Server MCP di Google Workspace in Google Antigravity 2.0, IDE e/o CLI

1. Introduzione

Nota: stai ancora utilizzando la CLI di Gemini? Questa guida riguarda la CLI di Antigravity. Per ulteriori informazioni su come eseguire la transizione, consulta questo post del blog ufficiale.

In questo codelab imparerai a utilizzare il Model Context Protocol (MCP) per connettere i tuoi dati di Google Workspace ad Antigravity 2.0, IDE e/o CLI. MCP è uno standard aperto che consente ai modelli AI di utilizzare in modo sicuro gli strumenti forniti dai server remoti. Configurerai Antigravity per interagire con Gmail, Google Drive, Documenti Google, Fogli Google, Presentazioni Google, Google Calendar, Google Chat e l'API People senza scrivere codice.

In questo lab proverai a:

• Abilitare i servizi MCP di Google Workspace nel tuo progetto Google Cloud.
• Configurare Antigravity per accedere a questi servizi MCP.
• Testare l'integrazione con prompt divertenti e utili che interagiscono con i dati di Google Workspace.

Che cosa ti serve

• Un browser web come Chrome
• Un progetto Google Cloud registrato al programma di anteprima per sviluppatori di Google Workspace
• Un account Google Workspace
• Antigravity 2.0, IDE e/o CLI installati sulla tua macchina locale. Puoi trovare ulteriori dettagli e indicazioni per l'installazione da il sito web ufficiale.

Facile accesso a questo codelab

2. Prima di iniziare

Programma di anteprima per sviluppatori di Google Workspace: l'accesso ai server MCP di Google Workspace fa parte del programma di anteprima pubblica per sviluppatori. Se non l'hai ancora fatto, registrati e assicurati che il tuo account sia accettato nel programma all'indirizzo https://developers.google.com/workspace/preview.

Creare o selezionare un progetto Google Cloud

Nella console Google Cloud, seleziona o crea un progetto Google Cloud.

Abilitare le API

Per utilizzare i server MCP di Google Workspace, devi abilitare le API standard di Google Workspace.

Abilitare le API

Abilitare i servizi MCP

Poi, abilita i servizi MCP di Google Workspace.

Abilitare 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:
   • Nel campo Nome app, inserisci Chat MCP.
   • Nel campo URL avatar, inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • In Descrizione, inserisci Chat MCP server.
   • In Funzionalità, disattiva Abilita funzionalità interattive.
   • In Log, seleziona Registra errori in Logging.
3. Fai clic su Salva.

3. Configurare il consenso e il client OAuth

I server MCP di Google Workspace utilizzano OAuth 2.0 per l'autenticazione e l'autorizzazione sicure. Devi configurare una schermata per il consenso OAuth e creare un client applicazione web.

Configurare la schermata per il consenso OAuth

Devi prima configurare la schermata per il consenso.

1. Nella console Google Cloud, vai a Google Auth Platform > Branding. Fai clic su Inizia se non è configurato.
2. Configura le informazioni sull'app:
   • Nome app: Google Workspace MCP Servers
   • Email per assistenza utenti: seleziona la tua email.
3. Configura pubblico: seleziona Interno (o Esterno se Interno non è disponibile).
4. Configura le informazioni di contatto: inserisci il tuo indirizzo email.
5. Esamina e accetta le Norme relative ai dati utente, quindi fai clic su Crea.
6. Se hai selezionato Esterno, vai a Pubblico e aggiungi la tua email in Utenti di test.
7. Vai a Accesso ai dati > Aggiungi o rimuovi ambiti. In Aggiungi ambiti manualmente, aggiungi i seguenti ambiti per i server che vuoi utilizzare:
   • Taglia unica: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • 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.readonly
   • API People: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Fai clic su Aggiungi alla tabella, poi su Aggiorna e infine su Salva.

Creare un ID client OAuth

1. Vai a Google Auth Platform > Client > Crea client.
2. Seleziona Applicazione web come tipo di applicazione.
3. Assegna il nome Antigravity.
4. In URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI, quindi inserisci https://antigravity.google/oauth-callback.
5. Fai clic su Crea e copia l'ID client e il client secret. Ti serviranno nel passaggio successivo.

4. Configurare Antigravity

Ora configuriamo Antigravity per utilizzare questi endpoint. Se non hai installato Antigravity 2.0, IDE e/o CLI, segui le istruzioni sul sito web di Antigravity.

Aggiungere server MCP personalizzati

Antigravity 2.0, IDE e CLI condividono una configurazione MCP centrale nel file ~/.gemini/config/mcp_config.json.

1. Apri il file nell'editor di testo che preferisci.

   Nota: puoi accedere al file direttamente da Antigravity IDE se lo hai installato seguendo questi passaggi:

   1. Apri Server MCP tramite il menu a discesa ... nella parte superiore del riquadro dell'agente dell'editor.
   2. Fai clic su Gestisci server MCP , quindi su Visualizza configurazione non elaborata.
2. Modifica la seguente configurazione del server MCP personalizzato. Prima di farlo, sostituisci i segnaposto <YOUR_CLIENT_ID> e <YOUR_CLIENT_SECRET> con l'ID client OAuth e il client secret che hai creato nei passaggi precedenti.
3. Salva il file.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Autenticare i server MCP personalizzati

Dovresti visualizzare tutti i server MCP configurati come installati in Antigravity: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat e gws-people. Devi autenticare ognuno di questi server per ogni superficie di Antigravity perché i token OAuth non sono centralizzati.

Antigravity 2.0

1. Fai clic su Impostazioni in basso a sinistra.
2. Vai a Personalizzazioni.
3. In Server MCP installati, fai clic su Aggiorna.

4. Per ogni server MCP installato elencato:
   1. Fai clic su Autentica.
   
   2. Segui il flusso di autenticazione nella nuova finestra del browser che si apre.
   3. Al termine, fai clic su Copia negli appunti.
   
   4. Incolla il codice di autorizzazione che hai appena copiato nel campo di testo visualizzato nelle impostazioni di Antigravity 2.0 e fai clic su Invia.
   
   5. Ora viene visualizzato un pulsante Disconnetti che sostituisce Autentica.
   

Antigravity IDE

1. Apri Impostazioni utente di Antigravity tramite il menu a discesa Impostazioni specifiche dell'editor nella parte superiore della finestra.

2. Vai a Personalizzazioni.
3. In Server MCP installati, fai clic su Aggiorna.

4. Per ogni server MCP installato elencato:
   1. Fai clic su Autentica.
   
   2. Segui il flusso di autenticazione nella nuova finestra del browser che si apre.
   3. Al termine, fai clic su Copia negli appunti.
   
   4. Incolla il codice di autorizzazione che hai appena copiato nel campo di testo visualizzato nelle impostazioni di Antigravity IDE e fai clic su Invia.
   
   5. Ora viene visualizzato un pulsante Disconnetti che sostituisce Autentica.
   

Antigravity CLI

1. Digita /mcp e premi Invio.

2. Per ogni server MCP elencato:
   1. Seleziona il server utilizzando i tasti freccia su e giù e premi Invio.
   2. Seleziona Autentica utilizzando i tasti freccia sinistra e destra e premi Invio.
   
   3. Apri l'URL visualizzato in una nuova finestra del browser e segui il flusso di autenticazione.
   
   4. Al termine, fai clic su Copia negli appunti.
   
   5. Incolla il codice di autorizzazione che hai appena copiato nel campo di testo visualizzato nel terminale con Antigravity CLI in esecuzione e premi Invio.
   
   6. Ora viene visualizzato lo stato Autenticato che sostituisce Autenticazione necessaria.
   

5. Strumenti di test

Ora puoi interagire con i dati di Google Workspace utilizzando il linguaggio naturale. Ecco alcuni prompt di esempio per ogni servizio.

Nota: sostituisci i segnaposto tra parentesi nei prompt riportati di seguito (ad es. [NAME], [FILE_NAME]) con i valori effettivi dei tuoi dati di Google Workspace.

Taglia unica

Prova a eseguire ricerche in diversi prodotti:

• "Riassumi in poche frasi cosa è successo di recente nel mio account Google Workspace."
• "Trova qualsiasi elemento correlato a [PROJECT_NAME] nelle mie email, nei miei documenti e nei miei messaggi di chat."
• "Quando si terrà la mia prossima riunione sul piano di marketing e quali sono le ultime note e i messaggi di chat?"

Gmail

Prova a cercare o gestire le email:

• "Riassumi le ultime 5 email che ho ricevuto."
• "Scrivi una bozza di email a '[EMAIL_ADDRESS]' per richiedere un aggiornamento sul progetto '[PROJECT_NAME]'."

Google Drive

Prova a cercare o leggere i file:

• "Cerca i file su Google Drive che contengono ‘[KEYWORD]'."
• "Elenca i documenti che ho modificato di recente."
• "Leggi i contenuti del mio documento '[FILE_NAME]' e riassumi gli obiettivi principali."

Documenti, Fogli, Presentazioni Google

Prova a cercare le risorse di Drive:

• "Mostrami i contenuti strutturali del documento Google [DOCS_TITLE]."
• "Leggi il foglio Sheet1 del foglio di lavoro Google [SHEETS_TITLE]"
• "Mostrami il layout verbalizzato di Presentazioni Google [SLIDES_TITLE]."

Google Calendar

Prova a cercare nel tuo programma:

• "Quali sono le mie prossime riunioni questa settimana?"
• "Ho tempo libero domani pomeriggio?"

Google Chat

Prova a cercare i messaggi:

• "Cerca i messaggi contenenti ‘[KEYWORD]' in ‘[SPACE_NAME]'"

API People

Prova a cercare nel tuo profilo o nei tuoi contatti:

• "Secondo il mio profilo Google, qual è il mio nome?"
• "Trova le informazioni di contatto di ‘[NAME]'."

Combinare più servizi

La vera potenza di MCP si realizza quando si orchestrano le attività su più servizi. Prova questi prompt che dimostrano le funzionalità tra servizi:

• "Cerca i file in Drive relativi a 'Aggiornamenti delle milestone di [PROJECT_NAME]', riassumi i contenuti, trova l'indirizzo email di '[NAME]' e crea una bozza di email di Gmail con il riepilogo."

Esplorare altri strumenti

Questi sono solo alcuni esempi di ciò che puoi fare. Per visualizzare l'elenco completo degli strumenti disponibili per ogni servizio e provarli, consulta la sezione Prodotti supportati della documentazione ufficiale.

6. Libera spazio

Per liberare spazio nel progetto senza eliminarlo, puoi disabilitare le API e i servizi MCP che hai abilitato:

1. Nella console Google Cloud, vai alla dashboard API e servizi.
2. Fai clic su ciascuna delle API di Google Workspace e MCP che hai abilitato (ad es. Calendar MCP, Chat MCP) e fai clic su Disabilita API.

Elimina le credenziali del client OAuth nella console Google Auth Platform se non prevedi più di utilizzarle.

7. Complimenti

Complimenti! Hai configurato e testato correttamente i server MCP ufficiali di Google Workspace utilizzando Antigravity.

Documenti di riferimento

• Introduzione al Model Context Protocol (MCP)
• Configurare i server MCP di Google Workspace
• Configurare il consenso OAuth
• Antigravity