Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Consentire agli agenti di AI di eseguire ricerche in tutto lo spazio di lavoro con il server MCP di ricerca universale per Workspace

Il server MCP di Ricerca universale per Google Workspace utilizza lo standard Model Context Protocol (MCP) per consentire agli agenti AI di cercare gli artefatti di Workspace. Questo server fornisce un modo per eseguire ricerche in più prodotti Google Workspace, tra cui messaggi Gmail, file Google Drive, eventi Google Calendar e spazi e messaggi Google Chat, utilizzando un unico strumento.

Il server MCP di Ricerca universale fornisce un modo standardizzato per gli agenti AI di cercare informazioni in tutto l'account Google Workspace senza dover chiamare singoli strumenti specifici del prodotto.

Prerequisiti

Un progetto Google Cloud. Per creare un progetto, vedi Creare un progetto.
Un client MCP, come Google Antigravity.
Per eseguire i comandi in questa pagina, configura gcloud CLI in uno dei seguenti ambienti di sviluppo:
Cloud Shell
Per utilizzare un terminale online con gcloud CLI già configurata, attiva Cloud Shell:

Attiva Cloud Shell
Shell locale
Per utilizzare un ambiente di sviluppo locale, procedi nel seguente modo:
1. Installa Google Cloud CLI. Se hai già installato gcloud CLI, assicurati di avere l'ultima versione eseguendo gcloud components update.
2. Se utilizzi un provider di identità (IdP) esterno, accedi a gcloud CLI con la tua identità federata. Per ulteriori informazioni, vedi Accedi a gcloud CLI con la tua identità federata.
3. Inizializza gcloud CLI.

Configurare il server MCP di Ricerca universale

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

Abilitare le API

Per utilizzare il server MCP di Ricerca universale, abilita l'API MCP di Google Workspace e le API per i prodotti in cui vuoi eseguire la ricerca nel tuo progetto Google Cloud:

API Gmail
API Google Drive
API Google Calendar
API Google Chat
API MCP di Google Workspace

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.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

Il server MCP di Ricerca universale 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.

Se hai già configurato la schermata per il consenso OAuth per altri server MCP, assicurati di aver aggiunto gli ambiti richiesti per il server MCP di Ricerca universale.

Quando esegui l'autenticazione con il server MCP di Ricerca universale, puoi scegliere di autenticare tutti gli ambiti richiesti o solo un sottoinsieme. Il server rispetta queste scelte ed esegue ricerche solo nei prodotti per i quali è stato concesso l'accesso.

Ad esempio, se esegui l'autenticazione con tutti i seguenti ambiti:

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

Il server MCP di Ricerca universale eseguirà ricerche in Gmail, Google Drive, Google Calendar e Google Chat.

Tuttavia, se concedi l'accesso solo a https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly e https://www.googleapis.com/auth/chat.messages.readonly (e ometti https://www.googleapis.com/auth/gmail.readonly), la ricerca universale restituisce solo i risultati di Google Drive, Google Calendar e Google Chat. Non esegue ricerche nella tua email né restituisce risultati di Gmail.

Nella console Google Cloud, vai a Piattaforma di autenticazione Google > Accesso ai dati.
Fai clic su Aggiungi o rimuovi ambiti.
Aggiungi uno o più dei seguenti ambiti:
- 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
Fai clic su Aggiorna e poi su Salva.

Per istruzioni dettagliate sulla configurazione della schermata per il consenso, vedi Configurare i server MCP di Google Workspace.

Configurare il client MCP

Per aggiungere il server MCP di Ricerca universale al client MCP, segui le istruzioni per il client.

Antigravity

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

Crea un ID client e un secret OAuth 2.0 di tipo Applicazione web. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi aggiungi https://antigravity.google/oauth-callback nel campo URI. Per le istruzioni, vedi Configurare i server MCP di Google Workspace.
Apri o crea il file di configurazione ~/.gemini/antigravity/mcp_config.json.

Aggiungi la configurazione workspace-universal a mcp_config.json:

{
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.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.

Salva mcp_config.json.
Autentica il server MCP. Puoi eseguire l'autenticazione 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 di Antigravity).
  2. Vai a Personalizzazioni.
  3. In Server MCP installati, fai clic su Aggiorna.
  4. Trova workspace-universal 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 riquadro di gestione MCP interattivo eseguendo:
```
/mcp
```
  3. Utilizza i tasti freccia per selezionare workspace-universal, 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.
Verifica che il server sia configurato e in esecuzione correttamente:
- Per Antigravity IDE o GUI: viene visualizzato un pulsante Disconnetti accanto a workspace-universal 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 il server workspace-universal nella visualizzazione della dashboard per esaminarne lo stato ed elencare tutti gli strumenti disponibili.

Claude

Per aggiungere il server MCP di Ricerca universale a Claude, configura un connettore personalizzato.

Crea un ID client e un secret OAuth 2.0 di tipo Applicazione web. Per le istruzioni, vedi Configurare i server MCP di Google Workspace.
Nelle impostazioni di Claude, aggiungi un connettore personalizzato:
- Nome server: Universal Search MCP Server
- URL server MCP remoto: https://workspacemcp.googleapis.com/mcp/v1
- ID client OAuth e client secret OAuth: inserisci le tue credenziali.
- Ambiti: includi https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly e https://www.googleapis.com/auth/chat.messages.readonly.

Testare il server MCP di Ricerca universale

Prova a porre al client MCP domande che richiedono la ricerca in diversi prodotti:

"Trova tutto ciò che riguarda il Progetto X nei miei messaggi email, documenti e chat."
"Quando si terrà la mia prossima riunione sul piano di marketing e quali sono le ultime note e i messaggi di chat?"

Se gli strumenti vengono eseguiti correttamente e ricevi risposte pertinenti da più prodotti, il server MCP di Ricerca universale è configurato correttamente.

Strumenti supportati

Il server MCP di Ricerca universale offre il seguente strumento:

search_corpus: esegue una ricerca in più prodotti Google Workspace (Google Drive, Gmail, Google Calendar e Google Chat) in base alla query fornita.