Principal API e integrações | Chaves, endpoints e webhooks Como conectar o MCP da Cloud Humans no Gemini Enterprise

Como conectar o MCP da Cloud Humans no Gemini Enterprise

Última atualização em Oct 14, 2026

Quando usar

  • A sua empresa usa o Gemini Enterprise (Google) e você quer usar a Cloud Humans de dentro dele
  • Você precisa saber o que o administrador do Google Cloud tem que fazer para liberar o conector

No Google, a conexão com servidores MCP de outras empresas acontece no Gemini Enterprise, administrado pelo console do Google Cloud. Este artigo não cobre o app Gemini de uso pessoal.

Pré-requisitos

  • Uma conta Cloud Humans ativa. O login do conector usa o mesmo e-mail e senha da plataforma. Pelo MCP, o login é sempre com e-mail e senha, mesmo que a sua empresa use SSO para entrar no Cloud Chat
  • Gemini Enterprise nas edições Standard, Plus, Pay-as-you-go ou Frontline
  • Um administrador do Google Cloud com o papel Discovery Engine Editor (roles/discoveryengine.editor)
  • O Client ID e o Client Secret da Cloud Humans para o Gemini, que você pede ao seu time de atendimento da Cloud Humans (Etapa 1)

Diferente do Claude, do ChatGPT e do Copilot, o Gemini Enterprise não se registra sozinho no servidor da Cloud Humans. Por isso ele precisa de um Client ID e de um Client Secret, gerados pela Cloud Humans para a sua empresa.

Passo a passo

Etapa 1 — Pedir a aprovação e as credenciais

  1. Envie ao time de segurança (ou ao administrador do Google Cloud) o artigo MCP da Cloud Humans: o que o time de segurança precisa saber para aprovar, junto com o link deste artigo

  2. Com a aprovação, peça ao seu time de atendimento da Cloud Humans o Client ID e o Client Secret para o Gemini Enterprise

O Client Secret é uma credencial da empresa, não de uma pessoa: ele identifica o Gemini da sua empresa para a Cloud Humans. Cada pessoa continua fazendo o próprio login, com as próprias permissões. Guarde o secret como qualquer outra credencial de integração.

Etapa 2 — O administrador cria o conector

Esta etapa é feita uma única vez, por um administrador do Google Cloud.

  1. No console do Google Cloud, abra o Gemini Enterprise e vá até Repositórios de dados (Data stores)

  2. Clique em Criar repositório de dados (Create data store)

  3. Procure e selecione Custom MCP Server

  4. Em autenticação, escolha OAuth 2.0 e preencha:

Campo Valor
MCP Server URL https://mcp.cloudhumans.com/openapi/cloudhumans/mcp
Authorization URL https://mcp.cloudhumans.com/authorize
Token URL https://mcp.cloudhumans.com/token
Client ID O que a Cloud Humans enviou
Client Secret O que a Cloud Humans enviou
Scopes Deixe em branco

  1. Escolha a região, dê o nome Cloud Humans e clique em Criar (Create)

  2. Vincule o repositório de dados ao app do Gemini Enterprise que a sua empresa usa

Etapa 3 — Conectar com a sua conta Cloud Humans

Cada pessoa faz esta etapa uma vez, com a própria conta.

  1. No Gemini Enterprise, faça uma pergunta que envolva a Cloud Humans

  2. O Gemini pede autorização. Clique para autorizar

  3. Na tela de login da Cloud Humans, entre com o seu e-mail e senha da Cloud Humans

  4. O navegador volta para o Gemini com a conexão feita

Etapa 4 — Testar

Peça ao Gemini:

Liste os conteúdos da minha base de conhecimento na Cloud Humans.

Problemas comuns

O que aparece Causa O que fazer
Erro de credencial ao autorizar Client ID ou Client Secret errados Confira os valores com o seu time de atendimento da Cloud Humans
O Gemini não usa a Cloud Humans O repositório de dados não foi vinculado ao app Confirme a Etapa 2, item 6
O Gemini pediu login de novo Passaram 30 dias desde o login Autorize de novo (Etapa 3)

Observações