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 de pesquisa universal do Google Workspace usa o padrão do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) para permitir que agentes de IA pesquisem seus artefatos do Workspace. Com ele, é possível 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 de pesquisa universal oferece uma maneira padronizada para que 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 MCP, como 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 de pesquisa universal

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

Ativar as APIs

Para usar o servidor MCP de pesquisa universal, ative a API MCP do Google Workspace e as APIs dos produtos que você quer pesquisar no seu 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 na nuvem do Google Cloud.

Console

Ative as APIs no console do Google Cloud:

Ativar as APIs

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

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

Ao fazer a autenticação com o servidor MCP de pesquisa universal, você pode autenticar todos os escopos solicitados ou apenas um subconjunto deles. O servidor respeita essas opções e só pesquisa os produtos para os quais 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 de pesquisa universal vai pesquisar no Gmail, no Google Drive, no Google Calendar 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 só vai retornar resultados do Google Drive, do Google Calendar 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 > Data Access.
  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 de pesquisa universal ao cliente MCP, siga as instruções do cliente.

Antigravity

Para adicionar o servidor MCP de pesquisa universal ao Antigravity, adicione a configuração do servidor ao arquivo mcp_config.json. Essas instruções são compatíveis com o Antigravity 2.0, o IDE do Antigravity e a CLI do Antigravity.

  1. Crie um ID do cliente OAuth 2.0 e uma chave secreta 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/config/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 do Antigravity ou GUI (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-o 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, acesse 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 o IDE do Antigravity ou GUI: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. Você pode selecionar o servidor workspace-universal na visualização do painel para inspecionar o status e listar todas as ferramentas disponíveis.

Claude

Para adicionar o servidor MCP de pesquisa universal ao Claude, configure um conector personalizado.

  1. Crie um ID do cliente OAuth 2.0 e uma chave secreta 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: insira 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 de pesquisa universal

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

  • "Encontre qualquer coisa relacionada ao Projeto X no meu e-mail, documentos e mensagens de chat."
  • "Quando será minha próxima reunião sobre o plano de marketing e quais são as notas e mensagens de chat mais recentes sobre ele?"

Se as ferramentas forem executadas corretamente e você receber respostas relevantes de vários produtos, o servidor MCP de pesquisa universal estará configurado corretamente.

Ferramentas compatíveis

O servidor MCP de pesquisa universal oferece a seguinte ferramenta:

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