Comece a usar o MCP do Google Workspace e a CLI do Gemini

1. Introdução

Observação: você ainda está usando a CLI do Gemini? Acesse este codelab para saber como configurar servidores MCP do Google Workspace com a CLI do Antigravity. Confira mais informações sobre a transição neste post oficial do blog.

Neste codelab, você vai aprender a usar o Protocolo de Contexto de Modelo (MCP) para conectar a CLI do Gemini aos seus dados do Google Workspace. O MCP é um padrão aberto que permite que os modelos de IA usem com segurança ferramentas fornecidas por servidores remotos. Você vai usar a CLI do Gemini como cliente 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

• Ative os serviços do MCP do Google Workspace no seu projeto na nuvem do Google Cloud.
• Configure a CLI do Gemini para usar 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 do Google Cloud;
• Uma conta do Google Workspace
• CLI do Gemini instalada na máquina local

Este codelab leva aproximadamente 30 minutos para ser concluído.

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.

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. Embora alguns servidores MCP operem de forma independente, outros ainda exigem que a API padrão subjacente esteja ativada:

• O Gmail e o Chat ainda exigem as APIs padrão.
• O Drive exige a API padrão para algumas ferramentas.
• O Google Agenda não exige que a API padrão esteja ativada.
• A API People lida com o acesso padrão e a funcionalidade do MCP. Por isso, não tem um serviço do MCP separado para ativar.

Ativar as APIs

Ativar serviços do MCP

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

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

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

Configurar a tela de permissão OAuth

Os servidores 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 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 os Dados 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:
   • 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, em Atualizar e em Salvar.

Criar um ID do cliente OAuth

Ao configurar um cliente OAuth 2.0 para os servidores MCP do Google Workspace, é necessário ativar a configuração de classificação agêntica (is_agentic) selecionando Usar este cliente para um agente com tecnologia de IA. Os clientes OAuth sem essa configuração ativada não podem chamar endpoints MCP do Google Workspace.

1. Acesse Plataforma Google Auth > Clientes > Criar cliente (ou APIs e serviços > Credenciais > Criar credenciais > ID do cliente OAuth).
2. Selecione App para computador como o tipo de aplicativo.
3. Dê o nome Gemini CLI a ela.
4. Selecione Usar este cliente para um agente com tecnologia de IA para ativar a flag de classificação is_agentic no cliente OAuth.
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 a CLI do Gemini

Agora vamos configurar a CLI do Gemini para usar esses endpoints. Se você não tiver a CLI do Gemini instalada, siga as instruções de instalação no site da CLI do Gemini.

Ambiente local obrigatório: não use o Cloud Shell nesta etapa. A CLI do Gemini exige um navegador local para autenticação OAuth. Use o terminal da sua máquina local. Consulte os requisitos de redirecionamento do navegador para mais informações.

Crie o arquivo de configuração

Abra ou crie ~/.gemini/settings.json no diretório inicial e adicione a configuração a seguir. Substitua os marcadores de posição pelas suas credenciais do OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Autenticar e verificar servidores MCP

Antes de usar os servidores MCP, é necessário autenticar e verificar se eles estão conectados.

Iniciar a CLI do Gemini

Execute o seguinte comando no terminal para iniciar a CLI do Gemini:

gemini

Autenticar

Autentique-se nos serviços que você quer testar executando o comando correspondente na CLI do Gemini. Você só precisa se autenticar nos serviços que planeja usar neste codelab.

Agenda

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Pessoas

/mcp auth people

Siga as instruções no navegador para autorizar cada serviço.

Verificar conexão

Verifique se as ferramentas estão carregadas e prontas:

/mcp list

Você vai ver uma saída indicando que os serviços estão Ready com as ferramentas listadas.

6. Testar servidores MCP

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

Pergunte ao Gemini sobre sua agenda:

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

Google Chat

Peça ao Gemini para pesquisar mensagens:

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

Google Drive

Peça ao Gemini para encontrar 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."

Gmail

Peça ao Gemini para 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]'."

API People

Peça ao Gemini para falar sobre seu perfil ou seus 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 quando o Gemini orquestra 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.

7. 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.

8. Parabéns

Parabéns! Você configurou e testou os servidores MCP oficiais do Google Workspace usando a CLI do Gemini.

O que você aprendeu

• Como ativar os serviços do MCP do Google Workspace no Google Cloud.
• Como configurar um cliente OAuth para o MCP.
• Como usar a CLI do Gemini para interagir com os dados do Google Workspace usando ferramentas padrão.

Documentos de referência

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