Conectar o GWC Bridge manualmente ao Claude

Conecte o GWC Bridge ao Claude como um conector personalizado para que o Claude 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 da interface em inglês do fornecedor. Os rótulos traduzidos não foram verificados e sua interface pode ser diferente. O GWC Bridge permite que o Claude 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. Este guia usa a configuração de conectores personalizados do Claude; adicionar um servidor manualmente não significa que a Anthropic o tenha analisado ou aprovado.

1. Quem pode usar este caminho

O Claude oferece suporte a conectores remotos personalizados nos planos Free, Pro, Max, Team e Enterprise. Contas Free podem ter um conector personalizado. Nos planos Team, um "Owner" (Proprietário) ou "Primary Owner" (Proprietário principal) deve adicionar o GWC Bridge à organização primeiro; nos planos Enterprise, isso deve ser feito primeiro por um "Owner", "Primary Owner" ou membro com uma função personalizada que inclua "Manage access to Libraries" (Gerenciar acesso às bibliotecas).^[1]

O acesso ao Claude Code depende de requisitos próprios, atendidos por uma assinatura compatível ou por um acordo de acesso da organização. Uma conta Free do Claude, por si só, não inclui acesso ao Claude Code.^[3]

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 Claude use.
Entre na mesma conta GWC no aplicativo do computador e ao autorizar o conector no Claude; adicionar a URL do GWC Bridge no Claude não instala o componente no computador.
Revise os arquivos, as pastas e as permissões de comandos que pretende disponibilizar nesse computador e comece com o mínimo de acesso necessário.
O GWC Bridge recusa solicitações de quem não está autenticado ou não tem direito de uso; adicionar a URL ou ver uma lista de ferramentas não ignora essas verificações.

3. Endereço do servidor e OAuth

Use este endereço de servidor:

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

O GWC Bridge faz a autenticação automaticamente usando o Documento de Metadados do ID do Cliente (CIMD) publicado pelo Claude e o PKCE. Você não precisa — e não deve inserir — um ID de cliente OAuth ou um segredo de cliente OAuth. Nunca cole senhas, tokens de acesso ou segredos de cliente em uma conversa com o Claude ou em cabeçalhos de solicitação.^[4]

Instalação alternativa pelo ZIP do plugin: Se a página de configuração do GWC Bridge disponibilizar o ZIP para Claude, baixe-o primeiro de lá. No Claude, escolha Customize > Plugins > Add > Upload plugin e envie o ZIP; abra GWC Bridge > Connectors > Connect e entre com a conta GWC do computador. Use este caminho ou Add custom connector abaixo, não ambos.

4. Configuração pessoal (Free, Pro ou Max)

Entre na conta Claude que pretende usar em claude.ai (ou no Claude Desktop) e abra "Customize" → "Connectors" (Personalizar → Conectores).
Clique em "+ Add" (+ Adicionar) (ou "+") → "Add custom connector" (Adicionar conector personalizado). No layout de menu unificado, clique em "Add" → "Custom" → "Web".
Dê ao conector o nome GWC Bridge e insira https://mcp.gwc-corp.com/mcp; se a caixa de diálogo mostrar uma seção "Advanced settings" (Configurações avançadas) para um ID de cliente OAuth e um segredo de cliente OAuth opcionais, deixe os dois campos em branco.
Clique em "Continue" (Continuar) (ou em "Add", se estiver usando a caixa de diálogo de etapa única) para revisar as configurações de autenticação detectadas: em "Authentication", mantenha "Sign in now" selecionado (não selecione "No sign in"); em "OAuth client", mantenha "Use Claude's published identity (Recommended)" selecionado (não selecione "Register automatically", pois o GWC Bridge não usa registro dinâmico de clientes, nem "Use your own OAuth client"); e deixe "Request headers" vazio.
Clique em "Add" para concluir a criação do conector e, em seguida, clique em "Connect" (Conectar) se o login ainda não tiver começado, concluindo o fluxo de login e consentimento do GWC no navegador.
Confirme que o GWC Bridge aparece como conectado em "Customize" → "Connectors", abra "+" → "Connectors" (ou o menu "Search and tools") em uma conversa para ativar GWC Bridge, mantenha as alterações de arquivos e os comandos configurados para exigir aprovação até estar confortável com o acesso e faça 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.), revisando o resultado real da ferramenta e não apenas a afirmação do Claude de que se conectou.^[1]

5. Configuração da organização (Team ou Enterprise)

Um "Owner" ou "Primary Owner" da organização (ou, no Enterprise, alguém com uma função personalizada que inclua "Manage access to Libraries") abre "Organization settings" → "Connectors" → "Add" → "Custom" → "Web" (ou escolhe "Add custom connector").
Insira o nome GWC Bridge e a URL do servidor https://mcp.gwc-corp.com/mcp e clique em "Continue".
Mantenha as configurações de autenticação detectadas ("Sign in now" e "Use Claude's published identity (Recommended)"), deixe "Request headers" e todos os campos de credenciais de cliente OAuth personalizado em branco e clique em "Add".
Depois que o conector for adicionado à organização, cada membro abre "Customize" → "Connectors", encontra GWC Bridge (marcado com o rótulo "Custom"), clica em "Connect" para entrar com sua própria conta GWC e o ativa em "+" → "Connectors" (ou "Search and tools").

Disponibilizar o conector para uma organização não conecta os membros automaticamente.^[1]

6. Celular e Claude Code

Configure e autentique o GWC Bridge no Claude web ou no Claude Desktop primeiro e, depois, entre na mesma conta Claude — e na mesma organização, quando aplicável — no aplicativo Claude para iOS ou Android. Os conectores web funcionam no Claude Mobile depois de configurados na sua conta; a instalação de conectores diretamente no celular está atualmente em versão beta, portanto o Claude Desktop e a versão web continuam sendo o principal caminho para configurar conectores personalizados.^[2]

No Claude Code, primeiro verifique /mcp: se você entrar com sua conta Claude, o conector adicionado em claude.ai talvez já tenha sido carregado automaticamente, portanto evite adicionar uma entrada duplicada pela interface de linha de comando se o conector da conta já estiver presente. Para adicionar (ou remover posteriormente) o GWC Bridge diretamente pela interface de linha de comando no terminal:^[3]

claude mcp add --transport http --scope user gwc-bridge https://mcp.gwc-corp.com/mcp
claude mcp remove gwc-bridge --scope user

Após adicionar o servidor, inicie o Claude Code, execute /mcp, selecione gwc-bridge, escolha "Authenticate" (Autenticar) e conclua o fluxo de login do GWC no navegador. O escopo user disponibiliza esse servidor em todos os seus projetos nessa máquina. Verifique o status do servidor e faça a primeira verificação somente de leitura descrita acima. Sua organização pode restringir quais servidores MCP o Claude Code pode carregar; não tente contornar as políticas da organização alterando a autenticação ou trocando de conta.^[3]^[4]

7. O que o Claude pode ver e como desconectar ou remover

O GWC Bridge é mais do que uma lista de nomes de ferramentas. Quando uma ferramenta autorizada lê um arquivo ou retorna a saída de um comando, esse conteúdo é enviado ao Claude, e um conector também pode disponibilizar recursos MCP e prompts de fluxo de trabalho. As ações disponíveis pelo GWC Bridge dependem das suas permissões no GWC e das políticas de pastas do computador; os controles de permissão de ferramentas do Claude podem restringir quais ferramentas o Claude invoca, mas não podem conceder um acesso que o GWC Bridge recusa. Revise os pedidos de aprovação com cuidado, especialmente antes de editar arquivos, excluir arquivos ou executar comandos. Não presuma que o tráfego de conectores remotos permaneça estritamente local: em claude.ai, Claude Desktop, Cowork e Claude Mobile, o Claude se conecta a servidores MCP remotos a partir da infraestrutura de nuvem da Anthropic. Adicionar a URL nunca concede automaticamente controle da tela, acesso irrestrito a arquivos ou execução de comandos sem aprovação — ficam disponíveis apenas as pastas compartilhadas e os recursos que você autorizou no GWC.

Para desconectar ou remover o GWC Bridge, abra "Customize" → "Connectors" e selecione GWC Bridge:

"Disconnect" (Desconectar) encerra a conexão autenticada do Claude com o GWC Bridge, mantendo o conector na sua lista.
"Remove" / "Delete" (Remover / Excluir), no menu do conector, remove um conector personalizado pessoal da sua conta.
A "Organization-wide removal" (Remoção para toda a organização) nos planos Team e Enterprise deve ser feita por um proprietário autorizado em "Organization settings" → "Connectors".
Desativar o conector no menu "+" → "Connectors" ou "Search and tools" de uma conversa só o desativa para aquela conversa; se o conector for sincronizado da sua conta claude.ai ou fornecido pela sua organização, gerencie-o ou remova-o nas configurações de conectores do Claude (ou desative-o para você em /mcp).

8. Solução de problemas

Sintoma	O que verificar
Não há opção para adicionar um conector personalizado	No plano Free, verifique se a única vaga para conector personalizado já está em uso. No Team ou Enterprise, peça a um proprietário da organização (ou a um administrador Enterprise com "Manage access to Libraries") para adicioná-lo em "Organization settings" → "Connectors".
O GWC Bridge não aparece no diretório de conectores	Use o fluxo de URL de conector personalizado (`https://mcp.gwc-corp.com/mcp`). A configuração manual não exige que o conector esteja listado no diretório.
A configuração pede um ID de cliente OAuth ou segredo de cliente OAuth	Deixe os campos opcionais de ID do cliente e segredo do cliente em "Advanced settings" em branco. Nunca tente adivinhar nem inserir credenciais estáticas de cliente.
O registro do cliente OAuth falha	Na caixa de diálogo de configuração em duas etapas, verifique se "OAuth client" está definido como "Use Claude's published identity (Recommended)", e não "Register automatically" (o GWC Bridge não usa registro dinâmico de clientes) ou "Use your own OAuth client".
O login é concluído, mas o GWC recusa o acesso	Verifique se você entrou com a conta GWC pretendida e se o Connect Pass dela está ativo. Não selecione "No sign in" para contornar a recusa.
“Couldn’t reach the MCP server” (Não foi possível acessar o servidor MCP)	Confira novamente se a URL é `https://mcp.gwc-corp.com/mcp`. Uma indisponibilidade temporária do serviço, um tempo limite na descoberta OAuth ou um bloqueio de firewall de rede/WAF entre as faixas de IP da Anthropic e o servidor pode causar esse erro. Informe o erro exato e o ID de referência ao suporte do GWC.
Está conectado, mas o Claude não usa as ferramentas	Verifique se GWC Bridge está ativado no menu "+" → "Connectors" / "Search and tools" da conversa e se as ferramentas individuais não estão desativadas. Peça explicitamente uma ação do GWC Bridge.
O computador ou uma pasta está indisponível	Confirme que o computador pretendido está online, que o GWC Studio ou o GWC for VS Code está em execução e conectado e que a pasta está compartilhada para essa conexão. Não troque para outro computador sem verificar se ele é o destino pretendido.
As leituras funcionam, mas as edições ou os comandos falham	Verifique tanto as configurações de aprovação de ferramentas do Claude quanto as permissões "Change files" (Alterar arquivos) / "Commands" (Comandos) da pasta no GWC. Trate uma recusa de permissão como uma restrição de política a resolver, não como uma falha temporária para tentar novamente às cegas.
O celular não mostra o conector	Confirme que você entrou na mesma conta Claude e na mesma organização no celular e conclua primeiro a configuração inicial do conector personalizado no Claude web ou Desktop.
O Claude Code não mostra um conector adicionado pela web	Execute `/status` para verificar seu método de login. Entrar com uma chave de API ou um perfil de provedor diferente impede o carregamento dos conectores da conta claude.ai. Verifique também as políticas de MCP da organização em `/mcp`.
O Claude Code precisa de autenticação ou o navegador não abre	Execute `/mcp`, selecione `gwc-bridge` e escolha "Authenticate". Copie e abra a URL de autorização exibida no terminal se o navegador não iniciar automaticamente.
Uma alteração de arquivo ou um comando excede o tempo limite	Não presuma que a ação falhou completamente. Inspecione o estado atual do arquivo ou a atividade recente antes de repetir uma operação que altera o estado.

Ao entrar em contato com o suporte do GWC, informe o aplicativo ou a interface do Claude que está usando, seu tipo de plano Claude, a etapa em que o problema ocorreu e qualquer mensagem de erro ou ID de referência. Nunca envie senhas, tokens bearer, segredos de cliente ou conteúdo de arquivos privados.

9. Referências oficiais

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