O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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 para o Google Workspace usa o padrão do Protocolo de Contexto de Modelo (MCP) para permitir que os 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 da Pesquisa Universal oferece uma maneira padronizada para os agentes de IA pesquisarem informações em toda a sua conta do Google Workspace sem precisar chamar ferramentas específicas de cada produto.

Pré-requisitos

Inscrição no Programa de prévia para desenvolvedores do Google Workspace.
Um projeto do Google Cloud. Para criar um projeto, consulte Criar um projeto.
Um cliente 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ê já instalou a CLI gcloud anteriormente, execute gcloud components update para verificar se você tem a versão mais recente.
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, é necessário ativá-lo no seu projeto na nuvem do Google Cloud e configurar 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 no seu projeto do Google Cloud:

CLI

gcloud services enable 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 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 da Pesquisa Universal.

Ao se autenticar no servidor MCP da Pesquisa Universal, é possível autenticar todos os escopos solicitados ou apenas um subconjunto deles. O servidor respeita essas escolhas e pesquisa apenas os produtos para os quais o acesso foi concedido.

Por exemplo, se você se autenticar com todos os 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

O servidor MCP de pesquisa universal vai pesquisar no Gmail, no Google Drive, no Google Agenda e no Google Chat.

No entanto, se você conceder acesso apenas ao 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, do Google Agenda e do Google Chat. Ele não pesquisa seu e-mail nem retorna resultados do Gmail.

No console do Google Cloud, acesse Plataforma de autenticação do Google > Acesso a dados.
Clique em Adicionar ou remover escopos.
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
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 de 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, o IDE do Antigravity e a CLI do Antigravity.

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. Selecione Usar este cliente para um agente com tecnologia de IA. Para instruções, consulte Configurar os servidores MCP do Google Workspace.
Abra ou crie o arquivo de configuração ~/.gemini/config/mcp_config.json.

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.

Economize mcp_config.json.
Autentique o servidor MCP. É possível autenticar usando as configurações da GUI ou da CLI:
- Para o IDE do Antigravity ou a GUI (Antigravity 2.0):
  1. Abra a tela de configurações (por exemplo, clique em Configurações no canto inferior esquerdo 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, 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.
Verifique se o servidor está configurado corretamente e em execução:
- Para o IDE ou a GUI do Antigravity:um botão Sair é exibido 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 Authed 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.

Crie um ID do cliente OAuth 2.0 e uma chave secreta do tipo Aplicativo da Web e selecione Usar este cliente para um agente com tecnologia de IA. Para instruções, consulte Configurar os servidores MCP do Google Workspace.
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 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 é minha próxima reunião sobre o plano de marketing e quais são as últimas notas e mensagens de chat sobre ele?"

Se as ferramentas forem executadas com sucesso e você receber respostas relevantes de vários produtos, seu servidor MCP de pesquisa universal está 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.