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 eseguire ricerche negli artefatti di Workspace. Questo server fornisce un modo per eseguire ricerche in più prodotti Google Workspace, tra cui messaggi di Gmail, file di 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 nell'intero account Google Workspace senza dover chiamare singoli strumenti specifici del prodotto.

Prerequisiti

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

Abilita le API

Per utilizzare il server MCP di Universal Search, attiva l'API MCP di Google Workspace nel tuo progetto cloud Google Cloud:

Interfaccia a riga di comando

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID 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 Ricerca universale.

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 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 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, quindi su Salva.

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

Configura il client MCP

Per aggiungere il server MCP di Ricerca universale al tuo 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 OAuth 2.0 e un secret di tipo Applicazione web. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI, quindi aggiungi https://antigravity.google/oauth-callback nel campo URI. Seleziona Utilizza questo client per un agente basato sull'AI. Per istruzioni, vedi Configura 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 eseguire l'autenticazione utilizzando le impostazioni della GUI o l'interfaccia a riga di comando:

    • 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 riquadro di gestione interattivo di MCP 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 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 Authed accanto ai loro nomi all'interno del riquadro TUI interattivo. Puoi selezionare il server workspace-universal nella visualizzazione della dashboard per controllarne 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 OAuth 2.0 e un secret di tipo Applicazione web e seleziona Utilizza questo client per un agente basato sull'AI. Per istruzioni, consulta Configura 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 tuo client MCP domande che richiedono la ricerca in diversi prodotti:

  • "Trova tutto ciò che riguarda il Progetto X 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 sull'argomento?"

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.