Prepare o client OAuth

Solicite um client público autorizado para o Codex, com PKCE S256 e audience nexxo-work-api. Não presuma que o client registrado para o callback do ChatGPT aceite o callback do Codex.

O Codex mostra o callback que deve ser autorizado ao cadastrar um client pré-existente. Use o endereço exato e a política de portas loopback esperada por sua versão. O issuer atual anuncia suporte à identificação do emissor na resposta OAuth.

Cadastre o servidor

Defina ORBITA_MCP_CLIENT_ID com o ID público fornecido pelo administrador. Ele não é uma senha.

codex mcp add orbita   --url https://mcp.nexxo.tec.br/mcp   --oauth-client-id "$ORBITA_MCP_CLIENT_ID"

codex mcp login orbita
codex mcp list

Conclua o fluxo no navegador. Se o terminal estiver sem navegador local, a versão atual do Codex também oferece codex mcp login orbita --no-browser; siga as instruções da CLI.

Configuração TOML

O cadastro é mantido em ~/.codex/config.toml. Este é um exemplo da parte correspondente ao servidor:

[mcp_servers.orbita]
url = "https://mcp.nexxo.tec.br/mcp"
scopes = ["openid", "profile", "email", "offline_access"]

[mcp_servers.orbita.oauth]
client_id = "CLIENT_ID_CADASTRADO_PARA_CODEX"

Substitua o placeholder pelo client real. Preserve o callback_url que a CLI salvar para seu cadastro quando aplicável. Não substitua o callback por um endereço de outro aplicativo.

Verifique o contexto

Peça ao assistente para executar resolve_work_context e listar os projetos autorizados. Confira a organização antes de solicitar uma alteração. Adicionar a entrada no TOML não autentica por si só.

Referência do cliente: MCP no Codex.