Inizia a utilizzare Google Workspace MCP e Gemini CLI

1. Introduzione

Nota: stai ancora utilizzando Gemini CLI? Vai a questo codelab per scoprire come configurare i server MCP di Google Workspace con l'interfaccia a riga di comando di Antigravity. Per saperne di più sulla transizione, consulta questo blog post ufficiale.

In questo codelab imparerai a utilizzare il Model Context Protocol (MCP) per connettere la Gemini CLI ai tuoi dati di Google Workspace. MCP è uno standard aperto che consente ai modelli di AI di utilizzare in modo sicuro gli strumenti forniti dai server remoti. Utilizzerai l'Gemini CLI come client per interagire con Gmail, Google Drive, 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 Gemini CLI per utilizzare 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 Google Cloud
• Un account Google Workspace
• Gemini CLI installata sulla tua macchina locale

Per completare questo codelab sono necessari circa 30 minuti.

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.

Crea o seleziona un progetto Google Cloud

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

Abilita le API

Per utilizzare i server MCP di Google Workspace, devi abilitare le API Google Workspace standard. Sebbene alcuni server MCP funzionino in modo indipendente, altri richiedono comunque l'abilitazione dell'API standard sottostante:

• Gmail e Chat richiedono comunque le loro API standard.
• Drive richiede l'API standard per determinati strumenti.
• Calendar non richiede l'abilitazione dell'API standard.
• L'API People gestisce sia l'accesso standard sia la funzionalità MCP, pertanto non esiste un servizio MCP separato da attivare.

Abilita le API

Abilita i servizi MCP

Successivamente, attiva i servizi MCP dedicati per i prodotti.

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

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

Configura la schermata per il consenso OAuth

I server MCP di Google Workspace utilizzano OAuth 2.0 per l'autenticazione. 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:
   • 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • 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

Quando configuri un client OAuth 2.0 per i server MCP di Google Workspace, devi attivare l'impostazione di classificazione agentica (is_agentic) selezionando Utilizza questo client per un agente basato sull'AI. I client OAuth per i quali questa impostazione non è attiva non possono chiamare gli endpoint MCP di Google Workspace.

1. Vai a Piattaforma di autenticazione Google > Client > Crea client (o API e servizi > Credenziali > Crea credenziali > ID client OAuth).
2. Seleziona App desktop come tipo di applicazione.
3. Assegnale il nome Gemini CLI.
4. Seleziona Utilizza questo client per un agente basato sull'AI per attivare il flag di classificazione is_agentic sul client OAuth.
5. Fai clic su Crea e copia l'ID client e il client secret. Ti serviranno nel passaggio successivo.

4. Configura Gemini CLI

Ora configuriamo Gemini CLI per utilizzare questi endpoint. Se non hai installato Gemini CLI, segui le istruzioni di installazione sul sito web di Gemini CLI.

Ambiente locale richiesto: non utilizzare Cloud Shell per questo passaggio. Gemini CLI richiede un browser locale per l'autenticazione OAuth. Utilizza il terminale della tua macchina locale. Per saperne di più, consulta i requisiti per i reindirizzamenti del browser.

Crea il file di configurazione

Apri o crea ~/.gemini/settings.json nella tua home directory e aggiungi la seguente configurazione. Sostituisci i segnaposto con le tue credenziali OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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.users.readstate.readonly"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Autentica e verifica i server MCP

Prima di poter utilizzare i server MCP, devi autenticarli e verificare che siano connessi.

Avvia Gemini CLI

Esegui questo comando nel terminale per avviare la Gemini CLI:

gemini

Autentica

Esegui l'autenticazione con i servizi che vuoi testare eseguendo il comando corrispondente in Gemini CLI. Devi eseguire l'autenticazione solo con i servizi che prevedi di utilizzare in questo codelab.

Calendar

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Persone

/mcp auth people

Segui le istruzioni nel browser per autorizzare ogni servizio.

Verifica connessione

Verifica che gli strumenti siano caricati e pronti:

/mcp list

Dovresti visualizzare un output che indica che i servizi sono Ready con i relativi strumenti elencati.

6. Testa i server MCP

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.

Google Calendar

Prova a chiedere a Gemini informazioni sui tuoi impegni:

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

Google Chat

Prova a chiedere a Gemini di cercare i messaggi:

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

Google Drive

Prova a chiedere a Gemini di trovare 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."

Gmail

Prova a chiedere a Gemini di 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]'."

API People

Prova a chiedere a Gemini informazioni sul tuo profilo o sui 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 Gemini orchestra le attività su più servizi. Prova questi prompt che mostrano le funzionalità cross-service:

• "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.

7. 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 Disabilita API.

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

8. Complimenti

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

Che cosa hai imparato

• Come attivare i servizi MCP di Google Workspace in Google Cloud.
• Come configurare un client OAuth per MCP.
• Come utilizzare la Gemini CLI per interagire con i dati di Google Workspace utilizzando strumenti standard.

Documenti di riferimento

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