Conectar o GWC Bridge manualmente ao Gemini

Conecte o GWC Bridge ao Gemini para que o Gemini possa trabalhar com os arquivos e comandos que você autorizar no seu próprio computador.

Nota sobre os rótulos da interface: Os rótulos entre aspas seguem a documentação atual em inglês do Google. Sua interface pode variar à medida que o Google disponibiliza novos recursos. O GWC Bridge permite que o Gemini trabalhe com arquivos e comandos autorizados no seu próprio computador, onde o GWC for VS Code ou o GWC Studio está em execução. Adicionar um servidor MCP personalizado não significa que o Google tenha analisado ou aprovado o GWC Bridge.

1. Quem pode usar este caminho

Gemini: Um administrador pode adicionar um armazenamento de dados (data store) Custom MCP Server depois que a política da organização gerenciada do projeto permitir conectores MCP personalizados. O Google exige a função Discovery Engine Editor para o administrador que cria o data store, e alterações adicionais nas políticas de saída (egress) e de fontes de dados podem ser aplicáveis quando o VPC Service Controls ou a aplicação gerenciada de políticas estiver ativada.^[1]^[2]

Gemini CLI: O GWC Bridge ainda não suporta este caminho. Não configure um cliente OAuth estático do Gemini CLI.

Aplicativos personalizados do Gemini para consumidores: Atualmente, o Google limita os aplicativos personalizados a usuários qualificados: maiores de 18 anos, localizados nos EUA, conectados com uma Google Account pessoal, com “Keep Activity” (Manter atividade) ativado e usando o idioma inglês para esse recurso. A configuração começa no aplicativo web do Gemini.^[4] O GWC Bridge ainda não está habilitado para esse fluxo voltado ao consumidor. O Google documenta a inserção de credenciais em “Advanced features” (Recursos avançados) quando um servidor não oferece suporte a Dynamic Client Registration, mas a página de ajuda atual não publica o URI de callback que o GWC precisaria autorizar. O GWC não tentará adivinhá-lo nem aceitará um redirecionamento com curinga (wildcard).

2. Antes de começar

Tenha sua conta GWC pronta, um Connect Pass ativo e o GWC for VS Code ou o GWC Studio em execução e conectado no computador que você pretende permitir que o Gemini use.
Entre na mesma conta GWC quando a janela do OAuth for aberta. Adicionar a URL do MCP não instala nem inicia o componente no computador.
Revise os arquivos, as pastas e as permissões de comando expostos por esse computador. Comece com o mínimo de acesso necessário.
O GWC Bridge continua aplicando suas próprias políticas de conta, concessão (grant), pasta, recurso, aprovação e comando. O Gemini não pode conceder a si mesmo um acesso que o GWC recusa.

3. Endereço do servidor e OAuth

Use este endereço de servidor MCP:

https://mcp.gwc-corp.com/mcp

Os endpoints OAuth do GWC são:

Authorization URL: https://api.gwc-corp.com/oauth/authorize
Token URL:         https://api.gwc-corp.com/oauth/token
Issuer:            https://api.gwc-corp.com

O caminho suportado para Gemini usa Authorization Code com PKCE S256. O ID de cliente estático é um identificador público associado ao callback alojado exato da Google. O GWC Bridge não regista atualmente um cliente OAuth para Gemini CLI.

4. Configuração do administrador no Gemini

O Google trata a configuração de um Custom MCP Server como uma operação de administrador em toda a organização.^[1]

No Google Cloud, selecione o projeto proprietário do aplicativo Gemini.
Abra Organization Policies (Políticas da organização) e localize Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). Substitua a política pai para este projeto e defina a aplicação como Off. Não desative a política para um escopo organizacional mais amplo, a menos que essa seja uma decisão intencional de governança da sua organização.^[2]
Se o seu projeto for protegido pelo VPC Service Controls, ou se as políticas gerenciadas de conectores relacionadas forem aplicadas a este projeto, permita custom_mcp como fonte de dados e permita o tráfego de saída (egress) para mcp.gwc-corp.com e api.gwc-corp.com.^[1]^[5]
Conceda ao administrador que cria o data store a função obrigatória Discovery Engine Editor (roles/discoveryengine.editor).^[1]
Abra Gemini Enterprise → Data stores → Create data store → Custom MCP Server → Add MCP server.
Escolha OAuth 2.0 e insira:

Campo	Valor
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	Deixe em branco (Leave blank)
Token URL	`https://api.gwc-corp.com/oauth/token`
Client ID	`gwc-google-gemini-v1`
Client Secret	`none`
Scopes	`files:read files:write commands:run`
Enable PKCE Support	On
Use HTTP Basic	Off

O exemplo atual do Google Cloud para um aplicativo MCP do Gemini também mostra o PKCE habilitado e o HTTP Basic desmarcado.^[7]

O redirecionamento documentado pelo Google para esse conector é exatamente https://vertexaisearch.cloud.google.com/oauth-redirect; o perfil de cliente do GWC aceita apenas esse URI e nenhum caminho irmão, host alternativo ou curinga.^[1] O valor none não é um segredo compartilhado. As próprias instruções do Google para o servidor MCP do Looker usam esse valor literal quando o formulário exige o preenchimento do campo Client Secret para um cliente público PKCE.^[6]

Clique em Verify Auth (Verificar autenticação), entre no GWC, revise as permissões solicitadas pelo GWC e aprove somente se a conta e o destino estiverem corretos.
Conclua a criação do data store e aguarde até que o status passe para Active (Ativo).
Abra a visualização Actions (Ações) do data store, recarregue as ações personalizadas se necessário e habilite apenas as ferramentas do GWC Bridge que você pretende permitir que o Gemini use. O Google desativa as ações de servidores MCP personalizados por padrão.^[1]
Conecte o data store ao aplicativo Gemini pretendido e execute uma primeira verificação somente de leitura: Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.

5. Gemini CLI

O Gemini CLI pode ligar-se a servidores MCP remotos, mas o GWC Bridge não ativa atualmente um cliente OAuth para Gemini CLI. Não adicione ainda um perfil OAuth do GWC Bridge ao Gemini CLI. Este caminho continua sem suporte até a GWC publicar um mecanismo de identidade do cliente revisto separadamente.

6. Aplicativos personalizados do Gemini para consumidores

A ajuda do Google para os aplicativos Gemini voltados ao consumidor informa que usuários qualificados podem abrir Settings → Connected Apps (Configurações → Aplicativos conectados), adicionar um aplicativo personalizado pela URL do servidor MCP e — quando o servidor não oferece suporte a Dynamic Client Registration — abrir Advanced features (Recursos avançados) e inserir as credenciais.^[4]

Não insira nenhum dos dois Client IDs estáticos do GWC nessa tela hoje. A página de ajuda atual do Google não documenta o URI de callback OAuth dos aplicativos personalizados para consumidores, e o GWC não possui um endpoint de Dynamic Client Registration. Reutilizar o callback do Enterprise ou o callback de loopback da CLI seria incorreto; aceitar um curinga enfraqueceria a vinculação de redirecionamento OAuth.

Esse caminho só poderá ser suportado depois que pelo menos uma destas condições for verdadeira:

O Google publicar um URI de callback para consumidor estável e exato que o GWC possa vincular a um Client ID público dedicado; ou
O GWC implementar e aprovar em revisão de segurança uma Dynamic Client Registration que atenda ao fluxo de registro de cliente do Gemini.

Até lá, o único caminho de cliente suportado neste guia é Gemini.

7. O que o Gemini pode ver e como desconectar

Quando o Gemini invoca uma ferramenta do GWC Bridge, o resultado da ferramenta pode incluir nomes de arquivos, conteúdo de arquivos, saída de comandos, rótulos de dispositivos ou outros dados retornados pela ferramenta autorizada. Esse conteúdo sai do seu computador e é processado pela interface do Gemini que você escolheu. O Google afirma que servidores MCP personalizados de terceiros estão fora do controle do Google e recomenda conectar apenas servidores em que você confia.^[4]

As permissões do GWC Bridge continuam sendo a autoridade final:

A leitura de arquivos é limitada às pastas compartilhadas com a conexão ativa do GWC Bridge.
As alterações de arquivos exigem que a conexão e a pasta permitam alterações, além das verificações de ações protegidas.
Os comandos exigem que a conexão permita Commands e ainda podem exigir aprovação.
Outro computador, outra conta ou uma concessão revogada não são intercambiáveis com aqueles que você autorizou.

Para desconectar:

Gemini: um administrador pode desativar ações, desconectar o data store do aplicativo ou remover o data store MCP personalizado de acordo com a política da organização.
Gemini CLI: não existe um cliente OAuth GWC ativado. Remova qualquer perfil OAuth experimental do GWC Bridge em vez de tentar autenticá-lo.
No GWC, revogar a concessão subjacente do Bridge invalida o acesso independentemente da configuração no lado do Gemini.

8. Solução de problemas

Sintoma	O que verificar
É tentado OAuth com Gemini CLI	Pare. O GWC Bridge não suporta atualmente OAuth para Gemini CLI.
O Gemini informa que o Custom MCP Server está bloqueado	Confirme se a restrição gerenciada no nível do projeto Disable custom MCP server connector for Gemini Enterprise foi substituída para Off. Se o VPC Service Controls ou a aplicação gerenciada estiverem ativos, permita também `custom_mcp` e os FQDNs de egress necessários.
O Verify Auth informa um redirecionamento inválido	Confirme se o Client ID é exatamente `gwc-google-gemini-v1`. O GWC aceita apenas o URI documentado pelo Google `https://vertexaisearch.cloud.google.com/oauth-redirect` para esse cliente.
O Verify Auth informa um Client Secret inválido	Insira exatamente `none`, habilite o PKCE e deixe Use HTTP Basic como Off. O GWC trata esse valor apenas como o espaço reservado exigido pelo formulário do Google para esse cliente público específico; qualquer outro segredo é recusado.
A autorização falha imediatamente	Confirme se o GWC habilitou o OAuth manual do Gemini. O sinalizador de compatibilidade no servidor fica desativado por padrão.
O Gemini não consegue alcançar o servidor ou os endpoints OAuth	Se houver controles de tráfego de saída (egress), permita `mcp.gwc-corp.com` e `api.gwc-corp.com`. Verifique novamente se as URLs HTTPS estão exatas.
O data store está Active, mas o Gemini não chama as ferramentas	As ações de servidores MCP personalizados ficam desativadas por padrão. Habilite as ações pretendidas e conecte o data store ao aplicativo Gemini desejado.

| O login funciona, mas o GWC recusa o acesso | Verifique a conta GWC e se o Connect Pass está ativo; em seguida, inspecione a concessão do Bridge e as permissões do computador. Não tente repetir às cegas uma ferramenta que altera o estado. | | O computador ou a pasta está indisponível | Confirme se o computador pretendido está online, se o GWC Studio ou o GWC for VS Code está em execução e conectado e se a pasta está compartilhada com essa conexão. | | As leituras funcionam, mas as edições ou os comandos falham | Revise as permissões Change files / Commands do GWC Bridge e qualquer solicitação de aprovação. Uma recusa é um limite de política, não evidência de falha na autenticação. | | O aplicativo personalizado do Gemini para consumidor pede credenciais | Não use os Client IDs do Enterprise nem da CLI. O URI de callback para consumidor não está documentado atualmente, portanto o GWC recusa esse caminho intencionalmente. |

Ao entrar em contato com o suporte do GWC, informe a plataforma Gemini (Enterprise ou CLI), a etapa da configuração e a mensagem de erro exata. Nunca envie senhas, tokens bearer, conteúdo de arquivos privados ou qualquer segredo de cliente real.

9. Referências oficiais

As etapas do fornecedor foram verificadas em 2026-10-22 (Asia/Singapore) com base na documentação oficial atual em inglês do Google: