Você clica em conectar um plugin no app do Codex (GitHub, Slack, Webflow, OpenAI Developers ou um MCP seu), termina a autorização no navegador sem nenhum erro, volta para o app e aparece o aviso OAuth state not found. O plugin continua desconectado.
O erro aparece desde 16/10/2026 em pelo menos três issues do repositório oficial openai/codex (#54924, #54626 e #55314), no Windows e no macOS, com o app na versão 26.1013. Até 20/10/2026 a OpenAI não publicou causa nem correção.
Por que o Codex mostra "OAuth state not found"?
Porque o servidor da OpenAI não reconhece a conexão que o próprio app acabou de abrir. Relatos com log do app mostram a chamada POST /aip/connectors/links/oauth/callback voltando com HTTP 404 e {"detail":"OAuth state not found"} de 3 a 9 segundos depois de o app registrar a tentativa.
Não é token vencido nem aba velha do navegador: o app recebe o retorno normalmente e o log marca o callback como dele. A falha está na rota hospedada, então nada que você mude no seu computador corrige a raiz. O que dá para fazer é contornar, e o contorno depende do tipo de conexão.
| Situação | O que tentar | Resultado relatado |
|---|---|---|
| Plugin hospedado (GitHub, Slack, Webflow) | Entrar no ChatGPT web e conectar de novo | Resolveu em #55314, falhou em um relato de #54924 |
| MCP seu, com OAuth, por URL | codex mcp add e codex mcp login | Login nativo concluído em relato de #54924 |
| Qualquer caso | Recriar o conector | Não resolve, conexão nova falha igual |
| Qualquer caso | Sair e entrar de novo no app | Não resolve (#54924) |
Como resolver em plugin hospedado (GitHub, Slack, Webflow)?
Entre na sua conta em chatgpt.com no navegador padrão, com a mesma conta do app, e repita a conexão pelo app. Foi o que resolveu a conexão do GitHub relatada em #55314.
- No navegador padrão do sistema, abra
chatgpt.come confirme que está logado na mesma conta do app do Codex. - Volte ao app, abra Plugins e clique em conectar de novo.
- Termine a autorização no navegador e volte ao app.
Não é garantia. Em #54924 outro usuário saiu e entrou de novo no ChatGPT web e o erro do Webflow continuou. Se não funcionar, pare de recriar o conector: em #54924 um conector registrado do zero falhou do mesmo jeito, e no caso de MCP customizado o plugin quebrado ainda pode ficar impossível de apagar (#54626).
Como conectar um MCP próprio sem o fluxo de plugin?
Registre o servidor direto na configuração local do Codex e faça o OAuth pela CLI. Esse caminho roda o OAuth a partir do processo local e não passa pela rota hospedada que devolve 404. A documentação oficial de MCP diz que o app desktop, a CLI e a extensão de IDE compartilham a mesma configuração em ~/.codex/config.toml, então o servidor aparece no app também.
codex mcp add meu-mcp --url https://seu-servidor.exemplo/mcpSe o servidor anuncia suporte a OAuth, o próprio add já abre o fluxo e a CLI imprime Detected OAuth support. Starting OAuth flow…. Para refazer o login depois, ou se o navegador não abriu:
codex mcp login meu-mcpO login por OAuth só vale para servidor HTTP (streamable HTTP). Em servidor local por --command, a CLI recusa com OAuth login is only supported for streamable HTTP servers.
Quais opções do codex mcp login ajudam aqui?
Três flags, todas conferidas no código de codex-rs/cli/src/mcp_cmd.rs em 20/10/2026:
| Flag | O que faz |
|---|---|
--oauth-client-registration auto|cimd|dcr | Escolhe a estratégia de registro do cliente OAuth só para esse login. Em um relato de #54924, cimd concluiu o login no mesmo servidor que falhava no app. |
--no-browser | Imprime a URL de autorização e aceita a URL de callback colada, sem abrir navegador. Útil em máquina remota. |
--scopes a,b | Lista de escopos OAuth separada por vírgula. |
codex mcp login meu-mcp --oauth-client-registration cimdConfira o resultado com codex mcp list. Para apagar as credenciais salvas e começar do zero, use codex mcp logout meu-mcp. Se um firewall exige porta fixa para o retorno do OAuth, a documentação indica a chave mcp_oauth_callback_port no config.toml.
E se nada disso funcionar?
Mande o Feedback ID do app na issue #54924, que concentra os relatos. Os comentários mais úteis ali trazem versão do app, sistema, horário em UTC da tentativa e o provedor afetado, sem token nem URL de callback. Plugin hospedado depende de correção do lado da OpenAI.
Se você quer um agente de programação no terminal sem ficar preso a cota semanal, a Verboo Code oferece tokens ilimitados.
