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

1. Introduzione

Nota: stai ancora utilizzando Gemini CLI? Questa guida illustra l'interfaccia a riga di comando Antigravity. Per saperne di più su come eseguire la transizione, consulta questo blog post ufficiale di Antigravity CLI.

Utilizzi Gemini Enterprise? Se la tua organizzazione utilizza Gemini Enterprise, gli amministratori dei clienti idonei possono gestire centralmente e inserire nella lista consentita i server MCP approvati. Scopri di più nel blog post su Antigravity Enterprise e nel nostro Codelab sui server MCP di Google Workspace con Antigravity in Gemini Enterprise.

In questo codelab imparerai a utilizzare il Model Context Protocol (MCP) per connettere i tuoi dati di Google Workspace ad Antigravity 2.0, all'IDE e/o alla CLI. MCP è uno standard aperto che consente ai modelli di 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:

• Attiva i servizi MCP di Google Workspace nel tuo progetto cloud di Google.
• Configura Antigravity per accedere a questi servizi MCP.
• Testa l'integrazione con prompt divertenti e utili che interagiscono con i tuoi dati di Google Workspace.

Che cosa ti serve

• Un browser web come Chrome
• Un progetto cloud di Google Cloud registrato al programma Anteprima per gli 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 sul sito web ufficiale.

Facile accesso a questo codelab

2. Prima di iniziare

Programma Anteprima per gli sviluppatori di Google Workspace: l'accesso ai server MCP di Google Workspace fa parte del programma Anteprima per gli sviluppatori pubblico. 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.

Prerequisiti per Enterprise: per i clienti idonei, se la tua organizzazione applica le policy di Gemini Enterprise, l'amministratore deve prima attivare gli strumenti per sviluppatori AI e inserire nella lista consentita gli endpoint del server MCP di Google Workspace nella console Cloud prima di poter stabilire la connessione. Scopri di più nel blog post su Antigravity Enterprise e nel nostro Codelab sui server MCP di Google Workspace con Antigravity in Gemini Enterprise.

Crea o seleziona un progetto Google Cloud

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

Abilita le API

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

Abilita le API

Abilita i servizi MCP

Poi, attiva i servizi MCP di Google Workspace.

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:
   • Nel campo Nome app, inserisci Chat MCP.
   • Nel campo Avatar URL (URL avatar), inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • In Descrizione, inserisci Chat MCP server.
   • Nella sezione Funzionalità, disattiva l'opzione Attiva funzionalità interattive.
   • In Log, seleziona Errori di log in Logging.
3. Fai clic su Salva.

3. Configura il consenso e il client OAuth

Nota per le aziende: in un ambiente Google Workspace aziendale, l'amministratore di Cloud o Gemini Enterprise in genere esegue il provisioning della schermata per il consenso OAuth e dell'ID client a livello centrale. Se l'amministratore ti ha già fornito un ID cliente approvato, puoi saltare questo passaggio e procedere direttamente alla sezione Configura Antigravity.

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 per l'applicazione web.

Configura 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 Dati di contatto: inserisci il tuo indirizzo email.
5. Leggi e accetta le norme relative ai dati utente, poi fai clic su Crea.
6. Se hai selezionato Esterno, vai a Pubblico e aggiungi la tua email in Utenti di test.
7. Vai ad Accesso ai dati > Aggiungi o rimuovi ambiti. In Aggiungi ambiti manualmente, aggiungi quanto segue 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.

Crea un ID client OAuth

1. Vai a Google Auth Platform > Client > Crea client.
2. Seleziona Applicazione web come tipo di applicazione.
3. Assegnale il nome Antigravity.
4. In URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e inserisci https://antigravity.google/oauth-callback.
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. Ti serviranno nel passaggio successivo.

4. Configura Antigravity

Ora configuriamo Antigravity per utilizzare questi endpoint. Se non hai installato Antigravity 2.0, l'IDE e/o l'interfaccia a riga di comando, segui le istruzioni sul sito web di Antigravity.

Aggiungi server MCP personalizzati

Antigravity 2.0, l'IDE e l'interfaccia a riga di comando condividono una configurazione MCP centrale nel file ~/.gemini/config/mcp_config.json.

1. Aprilo nell'editor di testo che preferisci.

   Nota: se hai installato Antigravity IDE, puoi accedere al file direttamente da lì 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 i server MCP e poi 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 e il secret OAuth che hai creato nei passaggi precedenti.
3. Salvala.

{
  "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>"
      }
    }
    ...
  }
  ...
}

Autentica i server MCP personalizzati

Dovresti vedere tutti i server MCP che hai configurato 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 ciascuno di questi account per ogni piattaforma Antigravity, perché i token OAuth non sono centralizzati.

Risoluzione dei problemi relativi agli errori delle policy aziendali: se un server MCP mostra Unauthorized / Blocked by Admin Policy quando fai clic su Aggiorna, il servizio non è incluso nella lista consentita di Gemini Enterprise della tua organizzazione. Contatta l'amministratore per aggiungere l'endpoint di servizio e condividi con lui il Codelab per amministratori di Gemini Enterprise per ricevere indicazioni sulla configurazione.

Antigravity 2.0

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

4. Per ogni server MCP installato nell'elenco:
   1. Fai clic su Authenticate (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 autenticazione che hai appena copiato nel campo di testo visualizzato nelle impostazioni di Antigravity 2.0 e fai clic su Invia.
   
   5. Ora viene visualizzato il pulsante Esci al posto di Autentica.
   

Antigravity IDE

1. Apri Antigravity User Settings (Impostazioni utente Antigravity) tramite il menu a discesa Editor-Specific settings (Impostazioni specifiche dell'editor) nella parte superiore della finestra.

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

4. Per ogni server MCP installato nell'elenco:
   1. Fai clic su Authenticate (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 autenticazione che hai appena copiato nel campo di testo visualizzato nelle impostazioni dell'IDE Antigravity e fai clic su Invia.
   
   5. Ora viene visualizzato il pulsante Esci al posto di Autentica.
   

Antigravity CLI

1. Digita /mcp e premi Invio.

2. Per ogni server MCP elencato:
   1. Selezionalo 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 autenticazione appena copiato nel campo di testo visualizzato nel terminale con l'interfaccia a riga di comando Antigravity in esecuzione e premi Invio.
   
   6. Ora viene visualizzato lo stato Autenticato al posto di Autenticazione necessaria.
   

5. Strumenti di test

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

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

Universale

Prova a cercare in diversi prodotti:

• "Riassumi in poche frasi l'ultima cosa che è successa nel mio account Google Workspace."
• "Trova tutto ciò che riguarda [PROJECT_NAME] nelle mie email, nei miei documenti e nei miei messaggi chat."
• "Quando è la mia prossima riunione sul piano di marketing e quali sono le ultime note e i messaggi chat in merito?"

Gmail

Prova a cercare o gestire le tue 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 su Google Drive i file che contengono '[PAROLA CHIAVE]'."
• "Elenca i documenti più recenti che ho modificato."
• "Leggi il contenuto del mio documento '[FILE_NAME]' e riassumi gli obiettivi principali."

Documenti, Fogli, Presentazioni Google

Prova a cercare tra le tue risorse di Drive:

• "Mostrami i contenuti strutturali del documento Google [DOCS_TITLE]."
• "Leggi il foglio Foglio1 dal foglio Google [SHEETS_TITLE]"
• "Mostrami il layout verbalizzato della presentazione Google [SLIDES_TITLE]."

Google Calendar

Prova a cercare nel tuo programma:

• "Quali sono le mie prossime riunioni di questa settimana?"
• "Ho del 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, come mi chiamo?"
• "Trova i dati di contatto di [NOME]."

Combinazione di più servizi

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

• "Cerca in Drive i file relativi agli aggiornamenti dei milestone di [NOME_PROGETTO], riassumi i contenuti, trova l'indirizzo email di [NOME] e crea una bozza di Gmail con il riepilogo."

Esplora 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. Esegui la pulizia

Per eseguire la pulizia del 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 Google Workspace e MCP che hai attivato (ad es. Calendar MCP, Chat MCP) e fai clic su Disattiva API.

Elimina le credenziali 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)
• Configura i server MCP di Google Workspace
• Configura il consenso OAuth
• Panoramica di Antigravity Enterprise
• Codelab sui server MCP di Google Workspace con Antigravity in Gemini Enterprise
• Antigravity