> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# MCP no Codex

## 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.

```bash
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:

```toml
[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](https://developers.openai.com/codex/mcp).
