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. Mais informações sobre como fazer a transição podem ser encontradas neste post oficial do blog.

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, IDE e/ou CLI. O MCP é um padrão aberto que permite que 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 Agenda, o Google Chat e a API People sem escrever nenhum código.

Atividades deste laboratório

• Ativar os serviços do MCP do Google Workspace no seu projeto do Google Cloud.
• Configurar o Antigravity para acessar esses serviços do MCP.
• Testar 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;
• Uma conta do Google Workspace
• O Antigravity 2.0, o IDE e/ou a CLI instalados na sua máquina local. Você pode encontrar 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 do MCP do Google Workspace faz parte do Programa de prévia pública para desenvolvedores. Se ainda não fez isso, inscreva-se e verifique se sua conta foi aceita no programa em https://developers.google.com/workspace/preview.

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 do MCP do Google Workspace, ative as APIs padrão do Google Workspace. Embora alguns servidores do MCP operem de forma independente, outros ainda exigem que a API padrão subjacente seja ativada:

• O Gmail e o Chat ainda exigem as APIs padrão.
• O Drive exige a API padrão para determinadas ferramentas.
• O Agenda não exige que a API padrão seja ativada.
• A API People processa o acesso padrão e a funcionalidade do MCP. Portanto, ela não tem um serviço do MCP separado para ativar.

Ative as APIs

Ativar serviços do MCP

Em seguida, ative os serviços do MCP dedicados aos produtos.

Ativar os serviços do MCP

Configurar o app do Chat

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

1. No console do Google Cloud, pesquise a 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, insira Chat MCP.
   • No campo URL do avatar, insira 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 a permissão e o cliente do OAuth

Os servidores do MCP do Google Workspace usam o OAuth 2.0 para autenticação segura. Você precisa configurar uma tela de permissão OAuth e criar um cliente de aplicativo da Web.

Configurar a tela de permissão OAuth

Os servidores do MCP do Google Workspace usam o OAuth 2.0 para autenticação. Primeiro, configure a tela de permissão.

1. No console do Google Cloud, acesse Google Auth Platform > 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 de suporte ao usuário: selecione seu e-mail.
3. Configure o público-alvo: selecione Interno (ou Externo se 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 a dados > Adicionar ou remover escopos. Em Adicionar escopos manualmente, adicione o seguinte para os servidores que você quer usar:
   • 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • 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, depois em Atualizar e, por fim, 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.
4. Em URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://antigravity.google/oauth-callback.
5. 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 IDE e/ou a CLI instalados, siga as instruções no site do Antigravity.

Adicionar servidores do 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 no seu editor de texto preferido.

   Observação:você pode acessar o arquivo diretamente no IDE do Antigravity se ele estiver instalado seguindo estas etapas:

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

{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

3. Salve.

Autenticar servidores do MCP personalizados

Todos os servidores do MCP configurados serão exibidos como instalados no Antigravity: gws-calendar, gws-chat, gws-drive, gws-gmail e gws-people. Você precisa autenticar cada um deles para cada superfície do Antigravity, porque os tokens OAuth não são centralizados.

Antigravity 2.0

1. Clique em Configurações na parte de baixo à esquerda.
2. Acesse Personalizações.
3. Em Servidores do MCP instalados, clique em Atualizar.

4. Para cada servidor do 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. Um botão Sair será exibido substituindo 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 do MCP instalados, clique em Atualizar.

4. Para cada servidor do 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 IDE do Antigravity e clique em Enviar.
   
   5. Um botão Sair será exibido substituindo Autenticar.
   

CLI do Antigravity

1. Digite /mcp e pressione Enter.

2. Para cada servidor do 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. Um status Autenticado será exibido substituindo 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.

Google Agenda

Pesquise sua programação:

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

Antigravity 2.0

IDE do Antigravity

CLI do Antigravity

Google Chat

Pesquise mensagens:

• "Procure mensagens que contenham ‘[KEYWORD]' em ‘[SPACE_NAME]'"

Google Drive

Pesquise ou leia arquivos:

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

Gmail

Pesquise ou gerencie seus e-mails:

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

API People

Pesquise seu perfil ou contatos:

• "De acordo com meu perfil do Google, qual é meu nome?"
• "Encontre informações de contato para ‘[NAME]'."

Combinar vários serviços

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

• "Pesquise arquivos no Drive relacionados a ‘atualizações de marcos do [PROJECT_NAME]', resuma o conteúdo deles, encontre o endereço de e-mail de ‘[NAME]' e crie um rascunho do Gmail para eles 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 seu 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 do cliente OAuth no console da Google Auth Platform se não planeja mais usá-las.

7. Parabéns

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

Documentos de referência

• Introdução ao Protocolo de Contexto de Modelo (MCP)
• Configurar servidores do MCP do Google Workspace
• Configurar a permissão do OAuth
• Antigravity