Servidores MCP do Google Workspace no Google Antigravity 2.0, IDE e/ou CLI

1. Introdução

Observação: você ainda está usando a CLI do Gemini? Este guia aborda a CLI do Antigravity. Confira mais informações sobre como fazer a transição neste post oficial do blog da CLI do Antigravity.

Usa o Gemini Enterprise? Se a sua organização usa o Gemini Enterprise, os administradores de clientes qualificados podem gerenciar e incluir servidores MCP aprovados em uma lista de permissões de forma centralizada. Saiba mais no post do blog sobre o Antigravity Enterprise e no codelab complementar Servidores MCP do Google Workspace com o Antigravity no Gemini Enterprise.

Neste codelab, você vai aprender a usar o Protocolo de Contexto de Modelo (MCP) para conectar seus dados do Google Workspace ao Antigravity 2.0, ao IDE e/ou à CLI. O MCP é um padrão aberto que permite que os modelos de IA usem com segurança ferramentas fornecidas por servidores remotos. Você vai configurar o Antigravity para interagir com o Gmail, o Google Drive, o Google Docs, o Google Planilhas, o Google Slides, o Google Agenda, o Google Chat e a API People sem escrever nenhum código.

Atividades deste laboratório

• Ative os serviços do MCP do Google Workspace no seu projeto na nuvem do Google Cloud.
• Configure o Antigravity para acessar esses serviços do MCP.
• Teste a integração com comandos divertidos e úteis que interagem com seus dados do Google Workspace.

O que é necessário

• Um navegador da web, como o Chrome
• Um projeto na nuvem do Google Cloud inscrito no Programa de prévia para desenvolvedores do Google Workspace.
• Uma conta do Google Workspace
• Antigravity 2.0, IDE e/ou CLI instalados na sua máquina local. Confira mais detalhes e orientações de instalação no site oficial.

Acesso fácil a este codelab

2. Antes de começar

Programa de prévia para desenvolvedores do Google Workspace: o acesso aos servidores MCP do Google Workspace faz parte do programa de prévia pública para desenvolvedores. Se ainda não tiver feito isso, inscreva-se e verifique se sua conta foi aceita no programa em https://developers.google.com/workspace/preview.

Pré-requisitos para empresas: para clientes qualificados, se a organização aplicar as políticas do Gemini Enterprise, o administrador precisará ativar as ferramentas para desenvolvedores de IA e colocar os endpoints do servidor MCP do Google Workspace na lista de permissões no console do Cloud antes de se conectar. Saiba mais no post do blog sobre o Antigravity Enterprise e no codelab complementar Servidores MCP do Google Workspace com o Antigravity no Gemini Enterprise.

Criar ou selecionar um projeto do Google Cloud

No Console do Google Cloud, selecione ou crie um projeto na nuvem do Google Cloud.

Ative as APIs

Para usar os servidores MCP do Google Workspace, é necessário ativar as APIs padrão do Google Workspace.

Ativar as APIs

Ativar serviços do MCP

Em seguida, ative os serviços do MCP do Google Workspace.

Ativar os serviços do MCP

Configurar o app do Chat

Para usar o servidor MCP do Google Chat, configure um app do Chat no seu projeto do Google Cloud.

1. No console do Google Cloud, pesquise API Google Chat e clique em API Google Chat > Gerenciar > Configuração.

Acessar a API Google Chat

2. Configure o app do Chat:
   • No campo Nome do app, digite Chat MCP.
   • No campo URL do avatar, digite https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • Em Descrição, insira Chat MCP server.
   • Em Funcionalidade, desative a opção Ativar recursos interativos.
   • Em Registros, selecione Registrar erros no Logging.
3. Clique em Salvar.

3. Configurar o consentimento e o cliente do OAuth

Observação para empresas: em um ambiente corporativo do Google Workspace, o administrador do Cloud ou do Gemini Enterprise geralmente provisiona a tela de permissão OAuth e o ID do cliente de forma centralizada. Se o administrador já tiver fornecido um ID do cliente aprovado, pule esta etapa e prossiga diretamente para Configurar o Antigravity.

Os servidores MCP do Google Workspace usam o OAuth 2.0 para autenticação e autorização seguras. É necessário configurar uma tela de permissão OAuth e criar um cliente de aplicativo da Web.

Configurar a tela de permissão OAuth

Primeiro, configure a tela de permissão.

1. No console do Google Cloud, acesse Plataforma Google Auth > Branding. Clique em Começar se não estiver configurado.
2. Configure as Informações do app:
   • Nome do app: Google Workspace MCP Servers
   • E-mail para suporte do usuário: selecione seu e-mail.
3. Configure o Público-alvo: selecione Interno (ou Externo se a opção "Interno" não estiver disponível).
4. Configure as Informações de contato: insira seu endereço de e-mail.
5. Leia e aceite a Política de Dados do Usuário e clique em Criar.
6. Se você selecionou Externo, acesse Público-alvo e adicione seu e-mail em Usuários de teste.
7. Acesse Acesso aos dados > Adicionar ou remover escopos. Em Adicionar escopos manualmente, adicione o seguinte para os servidores que você quer usar:
   • Universal: 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
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Google Docs: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
   • Google Planilhas: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
   • Google Slides: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
   • Google Agenda: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
   • API People: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Clique em Adicionar à tabela, em Atualizar e em Salvar.

Criar um ID do cliente OAuth

1. Acesse Google Auth Platform > Clientes > Criar cliente.
2. Selecione Aplicativo da Web como o tipo de aplicativo.
3. Dê o nome Antigravity a ela.
4. Em URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://antigravity.google/oauth-callback.
5. Selecione Usar este cliente para um agente com tecnologia de IA.
6. Clique em Criar e copie o ID do cliente e a chave secreta do cliente. Você vai precisar deles na próxima etapa.

4. Configurar o Antigravity

Agora, vamos configurar o Antigravity para usar esses endpoints. Se você não tiver o Antigravity 2.0, o ambiente de desenvolvimento integrado e/ou a CLI instalados, siga as instruções no site do Antigravity (em inglês).

Adicionar servidores MCP personalizados

O Antigravity 2.0, o IDE e a CLI compartilham uma configuração central do MCP no arquivo ~/.gemini/config/mcp_config.json.

1. Abra-o no editor de texto de sua preferência.

   Observação: se você tiver o IDE do Antigravity instalado, siga estas etapas para acessar o arquivo diretamente:

   1. Abra os servidores MCP no menu suspenso ... na parte de cima do painel do agente do editor.
   2. Clique em Gerenciar servidores MCP e em Ver configuração bruta.
2. Modifique-o com a seguinte configuração de servidor MCP personalizado. Antes de fazer isso, substitua os marcadores de posição <YOUR_CLIENT_ID> e <YOUR_CLIENT_SECRET> pelo ID e pela chave secreta do cliente OAuth que você criou nas etapas anteriores.
3. Salve.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Autenticar servidores MCP personalizados

Você vai encontrar todos os servidores MCP que configurou como instalados no Antigravity: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat e gws-people. É necessário autenticar cada uma delas para cada superfície do Antigravity, porque os tokens OAuth não são centralizados.

Solução de problemas de erros de política corporativa: se um servidor MCP exibir Unauthorized / Blocked by Admin Policy ao clicar em Atualizar, esse serviço não está incluído na lista de permissões do Gemini Enterprise da sua organização. Entre em contato com o administrador para adicionar o endpoint de serviço e compartilhe o codelab do administrador do Gemini Enterprise com ele para receber orientações de configuração.

Antigravity 2.0

1. Clique em Configurações no canto inferior esquerdo.
2. Acesse Personalizações.
3. Em Servidores MCP instalados, clique em Atualizar.

4. Para cada servidor MCP instalado listado:
   1. Clique em Autenticar.
   
   2. Siga o fluxo de autenticação na nova janela do navegador que será aberta.
   3. Quando terminar, clique em Copiar para a área de transferência.
   
   4. Cole o código de autenticação que você acabou de copiar no campo de texto exibido nas configurações do Antigravity 2.0 e clique em Enviar.
   
   5. O botão Sair agora é exibido no lugar de Autenticar.
   

IDE do Antigravity

1. Abra as Configurações do usuário do Antigravity no menu suspenso Configurações específicas do editor na parte de cima da janela.

2. Acesse Personalizações.
3. Em Servidores MCP instalados, clique em Atualizar.

4. Para cada servidor MCP instalado listado:
   1. Clique em Autenticar.
   
   2. Siga o fluxo de autenticação na nova janela do navegador que será aberta.
   3. Quando terminar, clique em Copiar para a área de transferência.
   
   4. Cole o código de autenticação que você acabou de copiar no campo de texto que aparece nas configurações do IDE do Antigravity e clique em Enviar.
   
   5. O botão Sair agora é exibido no lugar de Autenticar.
   

CLI do Antigravity

1. Digite /mcp e pressione Enter.

2. Para cada servidor MCP listado:
   1. Selecione-o usando as teclas de seta para cima e para baixo e pressione Enter.
   2. Selecione Autenticar usando as teclas de seta para a esquerda e para a direita e pressione Enter.
   
   3. Abra o URL exibido em uma nova janela do navegador e siga o fluxo de autenticação.
   
   4. Quando terminar, clique em Copiar para a área de transferência.
   
   5. Cole o código de autenticação que você acabou de copiar no campo de texto exibido no terminal com a CLI do Antigravity em execução e pressione Enter.
   
   6. O status Autenticado agora é exibido no lugar de Autenticação necessária.
   

5. Ferramentas de teste

Agora você pode interagir com seus dados do Google Workspace usando linguagem natural. Confira alguns exemplos de comandos para cada serviço.

Observação: substitua os marcadores entre colchetes nos comandos abaixo (por exemplo, [NAME], [FILE_NAME]) por valores reais dos seus dados do Google Workspace.

Universal

Tente pesquisar em produtos diferentes:

• "Resuma em algumas frases o que aconteceu recentemente na minha conta do Google Workspace."
• "Encontre tudo relacionado a [NOME_DO_PROJETO] 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?"

Gmail

Tente pesquisar ou gerenciar seus e-mails:

• "Resuma os últimos 5 e-mails que recebi."
• "Escreva um e-mail para '[EMAIL_ADDRESS]' pedindo uma atualização sobre o projeto '[PROJECT_NAME]'."

Google Drive

Tente pesquisar ou ler arquivos:

• "Pesquise arquivos no meu Google Drive que contenham '[PALAVRA-CHAVE]'."
• "Liste os documentos mais recentes que editei."
• "Leia o conteúdo do meu documento '[FILE_NAME]' e resuma os objetivos principais."

Google Docs, Planilhas, Apresentações Google

Tente pesquisar seus recursos do Drive:

• "Mostre o conteúdo estrutural do documento Google [DOCS_TITLE]."
• "Ler a página Página1 do arquivo do Google Planilhas [SHEETS_TITLE]"
• "Mostre o layout verbalizado da apresentação do Google Slides [SLIDES_TITLE]."

Google Agenda

Tente pesquisar na sua programação:

• "Quais são minhas próximas reuniões esta semana?"
• "Tenho algum tempo livre amanhã à tarde?"

Google Chat

Tente pesquisar mensagens:

• "Procure mensagens que contenham '[PALAVRA-CHAVE]' em '[NOME_DO_ESPAÇO]'"

API People

Tente pesquisar seu perfil ou contatos:

• "De acordo com meu perfil do Google, qual é meu nome?"
• "Encontrar dados de contato de '[NOME]'."

Como combinar vários serviços

O verdadeiro poder do MCP é percebido ao orquestrar tarefas em vários serviços. Teste estes comandos que mostram os recursos de vários serviços:

• "Pesquise no Drive arquivos relacionados a 'atualizações de marcos do [NOME_DO_PROJETO]', resuma o conteúdo deles, encontre o endereço de e-mail de '[NOME]' e crie um rascunho do Gmail para essa pessoa com o resumo."

Conheça mais ferramentas

Estes são apenas alguns exemplos do que você pode fazer. Para conferir a lista completa de ferramentas disponíveis para cada serviço e testá-las, consulte a seção Produtos compatíveis da documentação oficial.

6. Limpar

Para limpar o projeto sem excluí-lo, desative as APIs e os serviços do MCP que você ativou:

1. No console do Google Cloud, acesse o Painel de APIs e serviços.
2. Clique em cada uma das APIs do Google Workspace e do MCP que você ativou (por exemplo, MCP do Agenda, MCP do Chat) e clique em Desativar API.

Exclua as credenciais de cliente OAuth no console da Google Auth Platform se não planeja mais usá-las.

7. Parabéns

Parabéns! Você configurou e testou os servidores MCP oficiais do Google Workspace usando o Antigravity.

Documentos de referência

• Introdução ao Protocolo de Contexto de Modelo (MCP)
• Configurar servidores MCP do Google Workspace
• Configurar o consentimento do OAuth
• Visão geral do Antigravity Enterprise
• Codelab sobre servidores MCP do Google Workspace com o Antigravity no Gemini Enterprise
• Antigravity