Permita que os agentes de IA pesquisem no espaço de trabalho com o servidor MCP da Pesquisa universal para o Workspace

O servidor MCP da Pesquisa Universal para Google Workspace usa o padrão do Protocolo de Contexto de Modelo (MCP) para permitir que agentes de IA pesquisem seus artefatos do Workspace. Esse servidor permite pesquisar em vários produtos do Google Workspace, incluindo mensagens do Gmail, arquivos do Google Drive, eventos do Google Agenda e espaços e mensagens do Google Chat, usando uma única ferramenta.

O servidor MCP da Pesquisa Universal oferece uma maneira padronizada para que os agentes de IA pesquisem informações em toda a sua conta do Google Workspace sem precisar chamar ferramentas específicas de produtos individuais.

Pré-requisitos

  • Um projeto do Google Cloud. Para criar um projeto, consulte Criar um projeto.

  • Um cliente do MCP, como o Google Antigravity.

  • Para executar os comandos nesta página, configure a CLI gcloud em um dos seguintes ambientes de desenvolvimento:

    Cloud Shell

    Para usar um terminal on-line com a CLI gcloud já configurada, ative o Cloud Shell:

    Ativar o Cloud Shell

    Shell local

    Para usar um ambiente de desenvolvimento local, siga estas etapas:

    1. Instale a CLI do Google Cloud. Se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.
    2. Se você usa um provedor de identidade (IdP) externo, faça login na CLI gcloud com sua identidade federada. Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.
    3. Inicialize a CLI gcloud.

Configurar o servidor MCP da pesquisa universal

Para usar o servidor MCP da Pesquisa Universal, ative-o no seu projeto na nuvem do Google Cloud e configure o cliente MCP para se conectar a ele.

Ative as APIs

Para usar o servidor MCP da Pesquisa universal, ative a API MCP do Google Workspace e as APIs dos produtos que você quer pesquisar no projeto do Google Cloud:

  • API Gmail
  • API Google Drive
  • API Google Calendar
  • API Google Chat

  • API MCP do 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

Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

Console

Ative as APIs no console do Google Cloud:

Ativar as APIs

O servidor MCP da Pesquisa Universal usa o OAuth 2.0 para autenticação e autorização. É necessário configurar a tela de permissão do OAuth antes de criar um ID do cliente OAuth.

Se você já configurou a tela de permissão do OAuth para outros servidores MCP, verifique se adicionou os escopos necessários para o servidor MCP da Pesquisa Universal.

Ao fazer a autenticação com o servidor MCP da Pesquisa Universal, é possível autenticar todos os escopos solicitados ou apenas um subconjunto deles. O servidor respeita essas escolhas e só pesquisa nos produtos em que o acesso foi concedido.

Por exemplo, se você fizer a autenticação com todos os escopos a seguir:

  • 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

O servidor MCP da Pesquisa universal vai pesquisar no Gmail, no Google Drive, no Google Agenda e no Google Chat.

No entanto, se você conceder acesso apenas 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 omitir https://www.googleapis.com/auth/gmail.readonly), a pesquisa universal vai retornar apenas resultados do Google Drive, da Agenda e do Google Chat. Ela não pesquisa seu e-mail nem retorna resultados do Gmail.

  1. No console do Google Cloud, acesse Google Auth Platform > Acesso a dados.
  2. Clique em Adicionar ou remover escopos.

  3. Adicione um ou mais dos seguintes escopos:

    • 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. Clique em Atualizar e em Salvar.

Para instruções detalhadas sobre como configurar a tela de permissão, consulte Configurar os servidores MCP do Google Workspace.

Configurar o cliente MCP

Para adicionar o servidor MCP da Pesquisa Universal ao seu cliente MCP, siga as instruções do cliente.

Antigravity

Para adicionar o servidor MCP da Pesquisa Universal ao Antigravity, adicione a configuração do servidor ao arquivo mcp_config.json. Estas instruções são compatíveis com o Antigravity 2.0, a IDE do Antigravity e a CLI do Antigravity.

  1. Crie um ID do cliente e uma chave secreta do OAuth 2.0 do tipo Aplicativo da Web. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione https://antigravity.google/oauth-callback no campo URIs. Para instruções, consulte Configurar os servidores MCP do Google Workspace.

  2. Abra ou crie o arquivo de configuração ~/.gemini/antigravity/mcp_config.json.

  3. Adicione a configuração 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"
      }
    }
  }
}

    Substitua:

    • OAUTH_CLIENT_ID: o ID do cliente que você criou.
    • OAUTH_CLIENT_SECRET: a chave secreta do cliente que você criou.

  4. Economize mcp_config.json.

  5. Autentique o servidor MCP. É possível fazer a autenticação usando as configurações da GUI ou a CLI:

    • Para o IDE ou a GUI do Antigravity (Antigravity 2.0):

      1. Abra a tela de configurações (por exemplo, clique em Configurações na parte de baixo à esquerda ou abra Configurações do usuário do Antigravity).
      2. Acesse Personalizações.
      3. Em Servidores MCP instalados, clique em Atualizar.
      4. Encontre workspace-universal na lista, clique em Autenticar, faça login na sua Conta do Google, copie o código de autorização, cole na caixa de diálogo de entrada e clique em Enviar.

    • Para a CLI do Antigravity:

      1. Inicie a CLI do Antigravity:

        agy

      2. Abra o painel interativo de gerenciamento do MCP executando:

        /mcp

      3. Use as teclas de seta para selecionar workspace-universal, vá até a ação Autenticar e pressione Enter. Conclua o fluxo de login no navegador, copie o código de autorização, cole-o no prompt do terminal e pressione Enter.

  6. Verifique se o servidor está configurado e em execução corretamente:

    • Para a GUI ou o IDE do Antigravity:um botão Sair é mostrado ao lado de workspace-universal em Personalizações > Servidores MCP instalados.
    • Para a CLI do Antigravity:abra o painel /mcp para conferir os servidores MCP configurados. Os servidores verificados e autenticados mostram Autenticado ao lado dos nomes no painel interativo da TUI. Selecione o servidor workspace-universal na visualização do painel para inspecionar o status dele e listar todas as ferramentas disponíveis.

Claude

Para adicionar o servidor MCP da Pesquisa Universal ao Claude, configure um conector personalizado.

  1. Crie um ID do cliente e uma chave secreta do OAuth 2.0 do tipo Aplicativo da Web. Para instruções, consulte Configurar os servidores MCP do Google Workspace.

  2. Nas configurações do Claude, adicione um conector personalizado:

    • Nome do servidor: Universal Search MCP Server
    • URL do servidor MCP remoto: https://workspacemcp.googleapis.com/mcp/v1
    • ID do cliente OAuth e chave secreta do cliente OAuth: digite suas credenciais.
    • Escopos: inclua 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.

Testar o servidor MCP da Pesquisa Universal

Faça perguntas ao cliente do MCP que exijam pesquisa em diferentes produtos:

  • "Encontre tudo relacionado ao Projeto X nos meus e-mails, documentos e mensagens de chat."
  • "Quando será minha próxima reunião sobre o plano de marketing? Quais são as últimas observações e mensagens de chat sobre ele?"

Se as ferramentas forem executadas com êxito e você receber respostas relevantes de vários produtos, o servidor MCP da Pesquisa Universal estará configurado corretamente.

Ferramentas compatíveis

O servidor MCP da Pesquisa Universal oferece a seguinte ferramenta:

  • search_corpus: realiza uma pesquisa em vários produtos do Google Workspace (Google Drive, Gmail, Google Agenda e Google Chat) com base na consulta fornecida.