
Conectar no Codex
Codex no VS Code ou no terminal — config.toml com login OAuth ou chave em variável de ambiente.
Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.
- 1
Instale e faça login
No VS Code, instale a extensão oficial do Codex pelo marketplace e entre com a sua conta ChatGPT/OpenAI pelo painel. A extensão e o CLI compartilham a mesma configuração, em ~/.codex/config.toml.
- 2
Adicione o servidor NewAlgorithm
Abra o config.toml (no painel do Codex: engrenagem → Codex Settings → Open config.toml) e declare o servidor:
~/.codex/config.toml[mcp_servers.NewAlgorithm-TOTVS] url = "https://totvs.mcp.newalgorithm.io/mcp" - 3
Caminho 1 — login OAuth
No terminal, rode o login do servidor. O navegador abre a autorização do NewAlgorithm (app.newalgorithm.io) para você autorizar; o Codex guarda a credencial sozinho.
codex mcp login NewAlgorithm-TOTVS - 4
Gere sua chave de API
Entre em app.newalgorithm.io com sua conta, abra Chaves e apps e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chavena_live_xxxxxxxxxxxxxxxxx - 5
Caminho 2 — chave em variável de ambiente
Para não deixar a chave no arquivo, guarde-a numa variável de ambiente e aponte o Codex para ela com bearer_token_env_var:
Variável de ambienteWindows (PowerShell): setx NA_API_KEY "SUA_CHAVE" macOS / Linux: echo 'export NA_API_KEY="SUA_CHAVE"' >> ~/.zshrc # ou ~/.bashrcEsperado: Feche e abra o terminal e o VS Code — só assim os processos recebem a nova variável.
- 6
E no config.toml
~/.codex/config.toml[mcp_servers.NewAlgorithm-TOTVS] url = "https://totvs.mcp.newalgorithm.io/mcp" bearer_token_env_var = "NA_API_KEY" - 7
Confirme no painel do Codex
O comando /mcp lista os servidores MCP ativos.
/mcpEsperado: NewAlgorithm-TOTVS Connected
bearer_token_env_var guarda o NOME da variável, não a chave. Assim o config.toml pode ser lido por qualquer pessoa sem expor o segredo.
Detalhes de autenticação e ferramentas na Documentação.