Conectar o GWC Bridge manualmente ao ChatGPT

Conecte o GWC Bridge ao ChatGPT como um conector personalizado para que o ChatGPT 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.

1. Quem pode usar este caminho

Use o ChatGPT na web (https://chatgpt.com) com uma conta ou um espaço de trabalho ChatGPT Business, Enterprise ou Edu que permita "Add custom MCP server". A Central de Ajuda da OpenAI documenta MCP completo, incluindo ações de escrita, para Business e Enterprise/Edu; o MCP personalizado no Pro é descrito como acesso de leitura/obtenção, e essas referências não comprovam acesso completo equivalente para Free ou Plus. No ChatGPT Business, somente os Admins and Owners (Administradores e proprietários) do espaço de trabalho podem criar e publicar plugins de servidores MCP personalizados (verifique "Workspace settings" → "Members"). No ChatGPT Enterprise e Edu, Admins and Owners podem criar, testar e publicar conexões MCP personalizadas, e os administradores também podem usar o controle de acesso baseado em funções (RBAC) em "Workspace settings" → "Permissions & roles" para conceder a membros selecionados a permissão "Create plugins with MCPs" para criar e testar conexões, enquanto Admins and Owners gerenciam a publicação no espaço de trabalho e os controles de ações. Confira os controles realmente disponíveis na sua conta; o GWC não pode alterar a elegibilidade definida pelo fornecedor nem a política do espaço de trabalho.^[2]

2. Preparar o computador

No computador de destino, use uma versão oficial compatível do GWC Studio, se disponível para seu sistema operacional, ou instale GWC for VS Code no Visual Studio Code.
Abra o aplicativo, entre na sua própria conta GWC, vincule o computador desejado e mantenha o componente GWC em execução e online. Autorize essa mesma conta GWC no conector.
Compartilhe primeiro uma pasta de teste sem dados sensíveis e revise as permissões reais Change files e Commands deste aplicativo no computador, não apenas as instruções escritas em um prompt de chat. Os limites das pastas, os caminhos protegidos, as autorizações da conexão, o princípio do privilégio mínimo e as confirmações no computador continuam sendo controles separados aplicados pelo servidor.
Mantenha um GWC Personal Connect Pass ativo (Connect Pass) para autorização remota e ações com as ferramentas. O GWC recusa chamadas não autenticadas ou sem direito de uso independentemente da sua assinatura do ChatGPT. Ver uma lista de ferramentas não comprova acesso, e adicionar um conector remoto não instala o componente no computador.

3. Endereço do servidor e OAuth

Cole este endereço HTTPS exato do servidor MCP remoto no campo de URL do servidor do conector:

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

Use o login individual por OAuth 2.1 com PKCE (S256) e descoberta automática de Documentos de Metadados do ID do Cliente (CIMD) (client_id_metadata_document_supported: true). Solicitações não autenticadas para https://mcp.gwc-corp.com/mcp retornam 401 Unauthorized com um cabeçalho WWW-Authenticate contendo resource_metadata apontando para os Metadados do Recurso Protegido (https://mcp.gwc-corp.com/.well-known/oauth-protected-resource, RFC 9728) e o Servidor de Autorização https://api.gwc-corp.com. Deixe "Advanced OAuth settings" ("Client ID" e "Client Secret") em branco e não escolha "No authentication": o GWC usa clientes públicos (none) com CIMD em vez de Registro Dinâmico de Clientes (DCR) ou segredos estáticos, e inserir credenciais estáticas substitui a descoberta automática de CIMD. Nunca cole senhas GWC, tokens de acesso/atualização ou chaves de API em prompts ou cabeçalhos de solicitação.^[3]

O suporte manual fica desativado por padrão. Quando ativado, os hosts padrão de metadados de cliente são chatgpt.com, openai.com e claude.ai. O host do Claude é exatamente claude.ai; esse padrão não admite claude.com, outros subdomínios nem portas explícitas, mesmo :443. Uma lista de hosts configurada pelo operador substitui esses valores, portanto o GWC precisa confirmar a configuração efetiva.

Quando o suporte manual está ativado, o GWC anuncia e aceita offline_access (suporte a concessões refresh_token) e o preserva quando solicitado no fluxo OAuth. Os tokens de atualização existentes são rotacionados; o cliente precisa usar cada token substituto. Esse escopo não adiciona permissões de arquivos, comandos ou outras funções do computador. O computador precisa permanecer online para as ações das ferramentas. Uma conexão revogada ou inválida exige um novo login oficial.

Instalação alternativa pelo ZIP do plugin: Se a página de configuração do GWC Bridge disponibilizar o ZIP para ChatGPT, baixe-o primeiro de lá. No ChatGPT, escolha Plugins > Add > Upload plugin e envie o ZIP; abra GWC Bridge > Connect e entre com a conta GWC do computador. Se aparecer Open in desktop app, conclua no aplicativo. Use este caminho ou Add custom MCP server abaixo, não ambos.

4. Configuração pessoal

Abra o ChatGPT na web, abra "Plugins" na barra lateral de navegação e selecione "+" → "Add custom MCP server". Você não precisa ativar primeiro uma opção separada de "Developer Mode".
Insira o nome GWC Bridge (e, opcionalmente, uma descrição) e, em "Connection", escolha "Server URL" e insira https://mcp.gwc-corp.com/mcp.
Defina "Authentication" como "OAuth" e deixe "Advanced OAuth settings" ("Client ID" e "Client Secret") em branco para que o ChatGPT descubra automaticamente os metadados OAuth do GWC por meio dos Documentos de Metadados do ID do Cliente (CIMD). Não informe um segredo de cliente nem use "No authentication".
Revise o aviso de risco específico do servidor, selecione "I understand and want to continue" e selecione "Create as a plugin". Conclua a solicitação de login e consentimento do GWC no navegador quando for redirecionado e, em seguida, revise as ferramentas e os metadados descobertos na página de detalhes do plugin.
Abra o item nos seus "Plugins" pessoais (ou mude a página inicial de "Chat" para "Work"), inicie uma nova conversa na web e selecione "+" no campo de mensagem ou digite @ / / para selecionar GWC Bridge.
Comece com um prompt de verificação somente de leitura (como identificar o computador disponível e listar os nomes dos arquivos na pasta de teste autorizada sem ler o conteúdo dos arquivos, editar arquivos ou executar comandos). Em "Settings" → "Plugins" ou "Settings" → "Apps", mantenha as confirmações de escrita e comandos ativadas; as configurações de confirmação do ChatGPT nunca substituem nem ampliam as permissões de pastas e comandos impostas pelo GWC no próprio computador.^[1]

5. Configuração da organização ou do espaço de trabalho

Um Admin or Owner autorizado verifica as permissões do espaço de trabalho ("Workspace settings" → "Members" no Business, ou "Workspace settings" → "Permissions & roles" no Enterprise/Edu, onde o RBAC pode conceder "Create plugins with MCPs") e cria o GWC Bridge por meio de "Plugins" com https://mcp.gwc-corp.com/mcp e "OAuth" sem credenciais estáticas.
Teste de forma privada em uma nova conversa na web antes da disponibilização no espaço de trabalho: verifique a seleção de ferramentas, os argumentos, os limites de autorização e uma listagem somente de leitura em uma pasta de teste sem dados sensíveis. Nunca use dados de produção, exclusão de arquivos, instalação de pacotes, implantação ou comandos de shell abrangentes como teste inicial de conexão.
Na página de detalhes do plugin GWC Bridge (ou "Admin console" → "Plugins" → "Manage Legacy Apps" → "Drafts" / "Workspace Settings" → "Apps" → "Drafts" → "Publish"), um Admin or Owner publica o plugin no espaço de trabalho ou para as funções Enterprise/Edu designadas após revisar os controles de ações. A publicação no espaço de trabalho compartilha o plugin apenas dentro da sua organização e não é um envio ao diretório público da OpenAI.
Cada membro do espaço de trabalho abre "Settings" → "Plugins" (ou "Settings" → "Apps"), seleciona GWC Bridge → "Connect" e entra com a própria conta GWC (com um Connect Pass ativo e um computador online). Conectar uma conta GWC não altera o espaço de trabalho ChatGPT ativo do usuário; nunca compartilhe credenciais de administrador nem cole tokens na conversa.

Plugins MCP publicados ou conectados mantêm em cache suas definições de ferramentas até serem atualizados. Quando o GWC adiciona ou atualiza ferramentas, um administrador ou usuário autorizado pode abrir a página de detalhes do GWC Bridge nas configurações de "Plugins" / "Apps" e selecionar "Refresh" para obter as ferramentas, descrições e instruções do servidor mais recentes sem excluir o plugin (se os metadados de descoberta OAuth .well-known mudarem, recrie o plugin). No Enterprise e Edu, administradores e proprietários também podem ativar ou desativar ações individuais do aplicativo após a publicação.^[2]

Para remover o acesso, abra "Settings" → "Plugins" (ou "Settings" → "Apps"), selecione GWC Bridge e escolha "Disconnect" para uma conta individual, ou desative/remova o plugin publicado na página de administração de "Plugins" (ou "Manage Legacy Apps") do espaço de trabalho. A desconexão interrompe futuras chamadas remotas de ferramentas sem excluir históricos de conversas anteriores nem encerrar automaticamente um processo local de longa duração já iniciado no computador; verifique sempre o GWC Studio ou o GWC for VS Code no computador antes de tentar novamente um comando ou uma edição de arquivo interrompidos.^[2]

6. Outros clientes

A OpenAI documenta conexões MCP personalizadas para espaços de trabalho e contas pessoais no ChatGPT na web. Não presuma que os aplicativos móveis do ChatGPT ou os aplicativos nativos de desktop ofereçam o mesmo caminho manual de configuração ou execução de MCP; continue usando o ChatGPT em um navegador de computador em vez de tentar se reconectar repetidamente pelos aplicativos móveis.^[2]

Se o seu espaço de trabalho exibir a visualização antiga de administração de aplicativos personalizados ("Admin console" → espaço de trabalho → "Plugins" → "Manage Legacy Apps", ou "Workspace settings" → "Apps" → "Create" com "Scan Tools" e "Workspace Settings" → "Apps" → "Drafts"), use-a apenas onde o espaço de trabalho apresentar essa interface. Não misture etapas da interface atual de "Plugins" e da interface antiga de "Apps", e não presuma que a ausência de um menu antigo significa que o GWC foi aprovado ou rejeitado.^[2]

7. Solução de problemas

O que pode aparecer	Próxima etapa
Controle de configuração ausente — "Add custom MCP server"	Confirme que você está usando o ChatGPT na web, está no espaço de trabalho Business, Enterprise ou Edu pretendido (ou em uma conta elegível) e tem a função Admin/Owner ou uma função Enterprise/Edu com a permissão "Create plugins with MCPs".
`invalid_client` — Client ID/Secret inserido manualmente ou `client_id host is not allowed`	Deixe "Client ID" e "Client Secret" em branco ao criar o plugin para que o ChatGPT use Documentos de Metadados do ID do Cliente (`client_id_metadata_document_supported: true` em `chatgpt.com` / `openai.com`), e peça ao GWC para verificar a ativação manual e a lista de hosts permitidos. O GWC não usa segredos estáticos nem Registro Dinâmico de Clientes (DCR).
`invalid_request` — `redirect_uri is not registered by the client`	O ChatGPT usa `https://chatgpt.com/connector_platform_oauth_redirect` (e `https://chatgpt.com/connector/oauth/{callback_id}` quando se aplicam redirecionamentos específicos de callback) por meio de seus metadados CIMD. Certifique-se de que nenhum proxy ou firewall reescreva `redirect_uri` ou remova o parâmetro `resource`.
`invalid_scope` — `Requested scope is not supported` ou a conexão abre sem ferramentas	Confirme que "Server URL" é `https://mcp.gwc-corp.com/mcp`, que o login OAuth foi concluído, que os escopos solicitados correspondem aos metadados habilitados do GWC e que `https://mcp.gwc-corp.com/.well-known/oauth-protected-resource` está acessível a partir dos IPs de saída dos conectores da OpenAI (`https://openai.com/chatgpt-connectors.json`).
`invalid_grant` / `GRANT_REVOKED` ou solicitações repetidas de login após expiração	O servidor de autorização do GWC (`https://api.gwc-corp.com`) oferece suporte a concessões `refresh_token` rotativas com PKCE (`S256`). Se uma autorização foi revogada ou se o ChatGPT armazenou em cache uma configuração antiga do aplicativo antes de os metadados de atualização estarem presentes, recrie ou reconecte o plugin pela interface oficial; nunca reutilize nem compartilhe um token de atualização.
`CONNECT_PASS_REQUIRED` / `connect_pass_required` — `Your GWC account does not currently have an active Connect Pass entitlement.`	Verifique se a conta GWC conectada tem um GWC Personal Connect Pass (Connect Pass) ativo. A publicação no espaço de trabalho ou uma assinatura do ChatGPT não concede um Connect Pass.
`PC_OFFLINE` / `DEVICE_NOT_ONLINE`	Confirme que o computador de destino está online, que o GWC Studio ou o GWC for VS Code está em execução e conectado à mesma conta GWC, e não mude silenciosamente para outro computador.
`ROOT_NOT_SHARED` / `PATH_PROTECTED`	Confirme que a pasta está compartilhada no GWC Bridge no computador de destino. O proprietário do computador pode revisar essa pasta e autorização específicas; os caminhos protegidos continuam indisponíveis.
`SCOPE_NOT_GRANTED` / `APPROVAL_DENIED` / `CLIENT_ACCESS_DISABLED` (leitura funciona, escrita ou comandos recusados)	Verifique os dois lados separadamente: (1) se os controles de ações do espaço de trabalho Enterprise/Edu ou os pedidos de confirmação do ChatGPT bloquearam a chamada e (2) se Change files ou Commands está ativado para aquela pasta no GWC Studio / GWC for VS Code no computador.
`UPDATE_REQUIRED` ou as ferramentas falham após uma atualização do GWC Bridge	Atualize o componente GWC instalado pelo seu canal oficial compatível, depois abra a página de detalhes do GWC Bridge nas configurações de "Plugins" / "Apps" do ChatGPT e selecione "Refresh" para obter os esquemas de ferramentas atualizados.
`RATE_LIMITED` ou tempo limite excedido em uma edição de arquivo / comando	Aguarde antes de tentar novamente uma consulta de status e inspecione primeiro o estado do arquivo ou do processo no computador; um tempo limite de rede não comprova que a ação não foi executada no computador.
`GWC_BRIDGE_PROTOCOL_ERROR` (HTTP 500, `-32603`) — `GWC Bridge could not complete this request. Check the connection and try again.`	Confira a conexão e o resultado da ação anterior no computador antes de tentar novamente. Ao entrar em contato com o suporte, registre a data e a hora, o nome do espaço de trabalho, o nome da ferramenta, o código de erro e um ID de solicitação não sensível sem senhas, tokens ou conteúdo de arquivos privados.
`Internal server error` / `INTERNAL` / `temporarily_unavailable` / HTTP 503	Peça ao GWC que confira a configuração e a disponibilidade do serviço. O caminho desativado por padrão mantém um erro genérico de protocolo; erros comuns de ferramentas e interrupções têm tratamento separado.

8. Privacidade e permissões

O ChatGPT recebe as saídas retornadas por chamadas autorizadas às ferramentas do GWC Bridge, como listagens de pastas, conteúdo de arquivos solicitado e saída de comandos; tanto content quanto structuredContent retornados por uma ferramenta entram no contexto da conversa do modelo, portanto não diga aos usuários que nenhum conteúdo de arquivo jamais sai do computador quando eles pedem ao ChatGPT para ler arquivos ou executar comandos. Quando o ChatGPT invoca uma ferramenta, ele envia os argumentos da ferramenta derivados da conversa ao GWC Bridge e ao seu computador conectado; limite as pastas compartilhadas e as permissões de comandos no GWC Studio ou no GWC for VS Code ao necessário para a tarefa.

Para ChatGPT Business, Enterprise e Edu, a OpenAI afirma que os dados do espaço de trabalho — incluindo informações acessadas por meio de plugins e aplicativos conectados — não são usados para treinar os modelos da OpenAI por padrão, enquanto as políticas de retenção da sua organização e o tratamento de dados do GWC para solicitações autenticadas de retransmissão continuam se aplicando. Conectar o GWC Bridge no ChatGPT autoriza apenas aquela conexão do ChatGPT e não compartilha suas conversas do ChatGPT com nenhum outro cliente de IA; se outro assistente estiver conectado separadamente ao mesmo computador e à mesma pasta compartilhada, ele só poderá observar as alterações gravadas no disco nessa pasta compartilhada.

9. Referências oficiais

As etapas do fornecedor foram verificadas em 2026-10-18, conferidas novamente em 2026-10-19 e verificadas de forma independente em 2026-10-21 (Asia/Singapore). As referências abaixo são as fontes oficiais em inglês. A configuração GWC em produção e a aceitação de callbacks/atualização de tokens ainda precisam ser verificadas.