Configurar o servidor MCP do chat

O Google Chat oferece um servidor remoto do Protocolo de Contexto de Modelo (MCP) que permite que agentes de IA interajam com segurança com os dados do Google Chat. Ao configurar o servidor MCP do Google Chat, você permite que aplicativos de IA, como o Google Antigravity e o Claude, realizem ações no Google Chat.

O servidor MCP do Google Chat oferece uma maneira padronizada para os agentes de IA:

  • Ler dados: listar e pesquisar conversas e ler mensagens.
  • Respeitar a segurança: herdar as mesmas permissões e controles de governança de dados do usuário.

Pré-requisitos

Configurar o servidor MCP do Google Chat

Para usar o servidor MCP do Google Chat, é 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 do Google Chat, ative as seguintes APIs no seu projeto na nuvem do Google Cloud:

  • API Google Chat

CLI

gcloud services enable chat.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

Ativar os serviços do MCP

Para ativar os componentes do MCP para o Google Chat, ative o seguinte serviço no seu projeto do Google Cloud:

  • API MCP do Google Chat

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

Console

Ative os serviços do MCP no console do Google Cloud:

Ativar os serviços do MCP

Configurar o app do Chat

Para usar o servidor MCP do Google Chat para realizar operações somente leitura, como pesquisar conversas, é necessário ativar a API e criar um cliente OAuth. Não é necessário configurar um app do Chat.

Para realizar operações de gravação, como enviar mensagens, é necessário configurar 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:

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

  3. Clique em Salvar.

Para saber como criar um app do Chat, consulte Escolher uma arquitetura de app do Google Chat.

O servidor MCP do Google Chat 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.

  1. No console do Google Cloud, acesse Plataforma de autenticação do Google > Branding.

    Acessar Branding

  2. Se você já configurou a Plataforma de autenticação do Google, é possível definir as seguintes configurações da tela de permissão OAuth em Branding, Público e Acesso a dados. Se aparecer a mensagem A plataforma de autenticação do Google ainda não está configurada, clique em Começar:

    1. Em Informações do app, em Nome do app, digite Chat MCP Server.
    2. Em E-mail para suporte do usuário, selecione seu endereço de e-mail ou um Grupo do Google adequado.
    3. Clique em Próxima.
    4. Em Público-alvo, selecione Interno. Se não for possível selecionar Interno, selecione Externo.
    5. Clique em Próxima.
    6. Em Dados de contato, insira um endereço de e-mail para receber notificações sobre mudanças no projeto.
    7. Clique em Próxima.
    8. Em Concluir, leia a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a Política de dados do usuário dos serviços de API do Google.
    9. Clique em Continuar.
    10. Clique em Criar.
    11. Se você selecionou Externo como tipo de usuário, adicione usuários de teste:
      1. Clique em Público-alvo.
      2. Em Usuários de teste, clique em Adicionar usuários.
      3. Insira seu endereço de e-mail e os outros usuários de teste autorizados. Depois, clique em Salvar.

  3. Clique em Acesso a dados > Adicionar ou remover escopos. Um painel é exibido com uma lista de escopos para cada API que você ativou no projeto do Google Cloud.

    1. Em Adicionar escopos manualmente, cole os escopos do servidor MCP do 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
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. Clique em Adicionar à tabela.

    3. Clique em Atualizar.

    4. Depois de selecionar os escopos necessários para o app, na página Acesso a dados, clique em Salvar.

Configurar o cliente MCP

Para adicionar o servidor MCP remoto do Google Chat ao seu cliente MCP, siga as instruções do cliente.

Antigravity

Para adicionar o servidor MCP remoto do Google Chat 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.

  1. Crie um ID do cliente OAuth 2.0 e uma chave secreta:

    1. No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes > Criar cliente

      Acesse "Criar cliente"

    2. Selecione Aplicativo da Web como o tipo de aplicativo.

    3. Digite um Nome.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione https://antigravity.google/oauth-callback no campo URIs.

    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.

  2. Abra ou crie o arquivo de configuração ~/.gemini/config/mcp_config.json.

  3. Adicione a configuração mcpServers a mcp_config.json:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.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 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 chat 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 chat, vá para 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 corretamente e em execução:

    • Para o IDE ou a GUI do Antigravity: um botão Sair é exibido ao lado do servidor 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 qualquer servidor na visualização do painel para inspecionar o status dele e listar todas as ferramentas disponíveis.

O servidor MCP remoto está pronto para uso no Antigravity.

Claude

Para usar o servidor MCP remoto do Google Chat com o Claude.ai ou o Claude Desktop, você precisa ter o plano Claude Enterprise, Pro, Max ou Team.

Para adicionar o servidor MCP remoto do Google Chat ao Claude, configure um conector personalizado com um ID do cliente e uma chave secreta do cliente OAuth.

  1. Crie um ID do cliente OAuth 2.0 e uma chave secreta:

    1. No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes > Criar cliente

      Acesse "Criar cliente"

    2. Selecione Aplicativo da Web como o tipo de aplicativo.

    3. Digite um Nome.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione https://claude.ai/api/mcp/auth_callback no campo URIs.

    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.

  2. Configure o servidor MCP no Claude:

    1. No Claude.ai ou no Claude Desktop, acesse Configurações (ou Configurações de administrador) > Conectores.
    2. Clique em Adicionar conector personalizado.
    3. Insira os detalhes de conexão do produto Google Chat:
      • Nome do servidor: Google Chat.
      • URL do servidor MCP remoto: https://chatmcp.googleapis.com/mcp/v1
    4. Em Configurações avançadas, insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
    5. Clique em Adicionar.

Outros

Muitos aplicativos de IA têm maneiras de se conectar a um servidor MCP remoto. Normalmente, é necessário inserir detalhes sobre o servidor, como nome, endpoints, protocolo de transporte e método de autenticação. Para o servidor MCP remoto do Google Chat, insira o seguinte:

  • Nome do servidor: chat

  • URL do servidor: https://chatmcp.googleapis.com/mcp/v1

  • Transporte: HTTP com streaming

  • Autenticação: o servidor MCP remoto do Google Chat usa o OAuth 2.0. Ao criar o cliente OAuth 2.0, selecione Usar este cliente para um agente com tecnologia de IA. Para mais detalhes, consulte Saiba mais sobre autenticação e autorização.

Para mais detalhes sobre como conectar diferentes tipos de clientes, consulte Configurar o MCP em um aplicativo de IA.

Testar o servidor MCP do Google Chat

Depois de configurar o cliente MCP, verifique a conexão executando alguns comandos de teste.

Faça as seguintes perguntas ao seu cliente do MCP:

  • "Qual foi a última mensagem no espaço 'Projeto X'?"

    O cliente encontra o espaço usando search_conversations e recupera as mensagens usando list_messages.

Se as ferramentas forem executadas com sucesso e você receber respostas relevantes, seu servidor MCP do Google Chat está configurado corretamente.

Solução de problemas

Se você tiver problemas para se conectar ao servidor MCP, verifique se há erros nos registros do OAuth. Peça para o administrador verificar os eventos de registro do OAuth na ferramenta de investigação de segurança.

Se as solicitações para o servidor MCP forem rejeitadas, verifique se o cliente OAuth 2.0 tem a opção Usar este cliente para um agente com tecnologia de IA selecionada em Plataforma de autenticação do Google > Clientes. Se não for possível mudar essa configuração em um cliente OAuth atual, crie um novo cliente OAuth com a opção Usar este cliente para um agente com tecnologia de IA selecionada e atualize seu app para usá-lo. Se um cliente OAuth atual for usado para recursos de agente de IA e não agente, crie um cliente OAuth separado para o agente de IA e mantenha o cliente atual para os recursos não agente. Para instruções, consulte Configurar o cliente MCP e Gerenciar clientes OAuth.

Se você precisar fazer login novamente a cada hora, seu cliente MCP não está recebendo um token de atualização. O servidor de autorização do Google emite tokens de atualização somente quando a solicitação de autorização inclui access_type=offline. Solicitar apenas o escopo offline_access do OIDC não é suficiente. Se o cliente do MCP aceitar parâmetros de autorização personalizados, adicione access_type=offline à solicitação de autorização. Para receber um novo token de atualização para um usuário que já concedeu acesso, adicione também prompt=consent.

Referência de ferramentas

As seguintes ferramentas estão disponíveis para o servidor MCP do Google Chat:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

Consideração importante sobre segurança: injeção indireta de comando

Quando você expõe um modelo de linguagem a dados não confiáveis, há o risco de um ataque de injeção de comando indireto. Como os hosts MCP, como o Google Antigravity, têm acesso a ferramentas e APIs avançadas pelo servidor MCP do Google Chat, eles podem ler, modificar e excluir dados na sua Conta do Google.

Para reduzir esses riscos, é preciso analisar os comandos e as respostas em busca de conteúdo malicioso ou ataques de injeção de comandos. Você pode usar o Model Armor fornecido pelo Google ou sua própria solução, se documentá-la para que os usuários aceitem esse risco. Para mais informações, consulte Configurar a segurança dos servidores MCP do Google Workspace.

Siga estas práticas recomendadas:

  • Use apenas ferramentas confiáveis. Nunca conecte o servidor MCP do Google Chat a aplicativos não confiáveis ou não verificados.
  • Tenha cuidado com entradas não confiáveis. Evite pedir que o cliente MCP processe mensagens ou outros recursos de fontes não verificadas. Essas entradas podem conter instruções ocultas que podem sequestrar sua sessão, permitindo que um invasor modifique, roube ou exclua seus dados.
  • Revise todas as ações. Sempre revise com cuidado as ações realizadas pelo cliente de IA em seu nome para garantir que estejam corretas e alinhadas com suas intenções.