Conectar a Dapper ao Gemini Enterprise

Para equipes que usam o Gemini com contas do Google Workspace. O administrador conecta a Dapper uma vez; depois cada pessoa autoriza a própria conta Dapper.

Endpoint MCP

https://api.dapperglobal.com/mcp

Antes de começar

Conta: Uma conta do Workspace com papel de administrador da equipe no Gemini Enterprise. Cada pessoa da equipe precisa, além disso, da própria conta ativa na Dapper.
Plano: Gemini Enterprise. No Business, é configurado em business.gemini.google; no Standard e no Plus, pelo console do Google Cloud. A conexão MCP própria está em Preview (Pre-GA) em ambos.
Onde funciona: No app web do Gemini Enterprise e nos agentes da equipe, onde sua organização tiver o Gemini Enterprise.
Permissões: No Business, administrador da equipe. No Standard e no Plus, o papel Discovery Engine Editor para criar o data store e Organization Policy Administrator para a política do primeiro passo.

Passo a passo

Registre o Gemini Enterprise na Dapper

O Gemini Enterprise não registra clientes OAuth sozinho: ele pede um client ID e um client secret. Eles são obtidos com uma única chamada ao registro de clientes da Dapper, sem pedir nada ao suporte. Rode isto uma vez e guarde o client_id e o client_secret da resposta — o secret não é exibido de novo.

curl -s https://api.dapperglobal.com/mcp/register \
  -H 'Content-Type: application/json' \
  -d '{
    "client_name": "Gemini Enterprise",
    "redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
    "grant_types": ["authorization_code", "refresh_token"],
    "token_endpoint_auth_method": "client_secret_post",
    "scope": "mcp:read offline_access"
  }'

# -> {"client_id": "...", "client_secret": "...", ...}

2
Abra Connected apps
Entre em business.gemini.google, clique em Settings & help, escolha sua equipe e vá em Manage team → Connected apps.
3
Adicione o servidor
Clique em Add MCP Server. Em MCP info, preencha Server URL com o endpoint da Dapper e Name com Dapper. Clique em Next.
```
https://api.dapperglobal.com/mcp
```
4
Configure o OAuth
Em Authentication settings, escolha OAuth 2.0 e preencha os campos. Os scopes precisam ser exatamente os do registro do passo 1: a Dapper recusa um scope com o qual o cliente não se registrou. Se o formulário oferecer Enable PKCE Support, ative — a Dapper exige PKCE.
Authorization URL
https://api.dapperglobal.com/mcp/authorize
Token URL
https://api.dapperglobal.com/mcp/token
Authorization URL Parameters
Vazio
Client ID
O client_id do passo 1
Client Secret
O client_secret do passo 1
Scopes
mcp:read offline_access
5
Verifique
Clique em Verify Auth: o login da Dapper se abre. Entre e aprove. Depois, Continue.
6
Crie o conector
Em Configure your data connector, escolha a localização no campo Multi-region, dê um nome ao conector e clique em Add.
7
Ative para a equipe
O conector é criado, mas desligado. Na lista de conectores, ative-o para que a equipe o veja.
8
Pergunte algo
Cada pessoa autoriza a própria conta Dapper na primeira vez que usa. Experimente: «Encontre consultas públicas abertas da ANEEL sobre distribuição de energia elétrica.»

Problemas comuns

O servidor não conecta: o Gemini Enterprise só aceita transporte Streamable HTTP. O endpoint da Dapper já usa esse transporte, então verifique se a URL termina em /mcp.
Verify Auth falha: quase sempre são os scopes (precisam coincidir com o registro do passo 1), a redirect URL (o registro precisa incluir https://vertexaisearch.cloud.google.com/oauth-redirect) ou o PKCE desligado.
«Client ID not found»: o registro do passo 1 é apagado após um ano sem uso. Repita o passo 1 e atualize o Client ID e o Client Secret no conector.
A equipe não vê a Dapper: o conector é criado desligado; ative-o na lista de conectores.

Outra forma de fazer

Standard e Plus (console do Google Cloud)

Os valores são os mesmos da tabela do passo 4 (e o registro do passo 1 também é necessário); muda onde eles são inseridos:

Revise a política da organização. O Gemini Enterprise bloqueia por padrão os conectores MCP próprios. Em IAM e administrador → Políticas da organização, escolha seu projeto (não a organização), busque «Disable custom MCP server connector for Gemini Enterprise», substitua a política do pai por uma regra em Off e salve.
Se sua organização restringe o tráfego de saída, adicione api.dapperglobal.com aos FQDN de saída permitidos.
Crie o data store. No console, abra Gemini Enterprise → Data stores → Create data store, busque Custom MCP Server (Preview) e preencha a URL, as credenciais OAuth e a localização com os mesmos valores. Ative Enable PKCE Support.
Conecte ao seu app. Associe o data store ao seu app do Gemini Enterprise e autorize a conexão.

Documentação do Google

Passos tirados da documentação do Google (com link acima) em outubro de 2026, ainda sem capturas próprias. Se um menu mudou de lugar, o endpoint do início desta página continua o mesmo.