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 negli artefatti di Workspace. Questo server offre un modo per eseguire ricerche in più prodotti Google Workspace, tra cui messaggi Gmail, file Google Drive, eventi di Google Calendar e spazi e messaggi di 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

Configurare il server MCP di Ricerca universale

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

Abilita 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 Google Workspace MCP

Interfaccia a riga di comando

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 Universal Search 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 Universal Search.

Quando esegui l'autenticazione con il server MCP di Universal Search, puoi scegliere di autenticare tutti gli ambiti richiesti o solo un sottoinsieme. Il server rispetta queste scelte e cerca 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 Universal Search eseguirà la ricerca 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 risultati da Google Drive, Google Calendar e Google Chat. Non esegue ricerche nelle tue email né restituisce risultati di Gmail.

  1. Nella console Google Cloud, vai a Google Auth Platform > Accesso ai dati.
  2. Fai clic su Aggiungi o rimuovi ambiti.

  3. 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

  4. 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.

Configura il client MCP

Per aggiungere il server MCP di Universal Search al client MCP, segui le istruzioni per il tuo 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.

  1. 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 istruzioni, vedi Configurare i server MCP di Google Workspace.

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

  3. 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.

  4. Risparmia mcp_config.json.

  5. Autentica il server MCP. Puoi autenticarti utilizzando le impostazioni della GUI o la CLI:

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

  6. Verifica che il server sia configurato correttamente e in esecuzione:

    • Per Antigravity IDE o la GUI:viene visualizzato un pulsante Esci 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 la dicitura Autenticato accanto al nome nel pannello della TUI interattiva. 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.

  1. Crea un ID client e un secret OAuth 2.0 di tipo Applicazione web. Per istruzioni, vedi Configurare i server MCP di Google Workspace.

  2. Nelle impostazioni di Claude, aggiungi un connettore personalizzato:

    • Nome server: Universal Search MCP Server
    • URL del 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.

Testa il server MCP di Ricerca universale

Prova a porre al cliente MCP domande che richiedono ricerche in diversi prodotti:

  • "Trova tutto ciò che riguarda il progetto X 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 chat a riguardo?"

Se gli strumenti vengono eseguiti correttamente e ricevi risposte pertinenti da più prodotti, il server MCP di Universal Search è 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.