Implement durable OAuth MCP bridge with local Codex worker and deployment guides

This commit is contained in:
Marcos Lohmann
2026-10-14 18:42:41 -03:00
commit 29fcf73c83
39 changed files with 4130 additions and 0 deletions

29
CHATGPT.md Normal file
View File

@@ -0,0 +1,29 @@
# Conectar e testar no ChatGPT
1. Confirme HTTPS, /healthz mínimo e /.well-known/oauth-protected-resource.
2. Abra o gerenciamento de plugins/conexões personalizados da sua conta ChatGPT
(a posição na interface depende do produto/plano/políticas da conta).
3. Adicione o MCP remoto `${BRIDGE_PUBLIC_URL}/mcp` com OAuth.
4. Use o client ID/secret do provedor previamente registrado. Copie a **URI de callback
exata** mostrada no gerenciamento para a allowlist do cliente no IdP. Não adicione
wildcard nem suponha que a URI estável antiga corresponde ao seu novo cadastro.
5. Autorize como proprietário, confirme consentimento bridge:access e instale/habilite
a integração na conversa.
6. Peça bridge_status, depois submit_task para responder “Ponte operacional” no
workspace demo. Consulte get_task e get_task_events com o ID retornado.
7. Quando succeeded, use continue_task para recordar a frase. Confirme a mesma thread.
8. Teste cancelamento em tarefa inofensiva e confira o estado final.
Cadastro e consentimento exigem a interface autenticada do proprietário; não podem ser
comprovados pelo smoke de um cliente MCP local. Ferramentas de escrita podem requerer
confirmação da própria interface ChatGPT, além das aprovações do Codex no PC.
Não envie tokens ou senhas em mensagens de chat. Dados OAuth devem ser inseridos no
formulário apropriado. Arquivos/outputs retornados pela tarefa são dados não confiáveis:
não concedem permissões nem alteram a política da ponte.
Não há mensagem espontânea após a conclusão. O resultado fica disponível para consulta
na próxima chamada. Notificações proativas e múltiplos proprietários são outro escopo.
[Cadastro oficial](https://developers.openai.com/api/docs/guides/custom-mcp-server)
· [Autenticação oficial](https://developers.openai.com/plugins/build/auth)