← Todas as conexões

Conectar no Codex

Codex no VS Code ou no terminal — config.toml com login OAuth ou chave em variável de ambiente.

Antes de começar, crie a sua conta gratuita.Criar conta

Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.

  1. 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. 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. 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. 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 chave
    na_live_xxxxxxxxxxxxxxxxx
  5. 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 ambiente
    Windows (PowerShell):  setx NA_API_KEY "SUA_CHAVE"
    macOS / Linux:         echo 'export NA_API_KEY="SUA_CHAVE"' >> ~/.zshrc   # ou ~/.bashrc

    Esperado: Feche e abra o terminal e o VS Code — só assim os processos recebem a nova variável.

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

    Confirme no painel do Codex

    O comando /mcp lista os servidores MCP ativos.

    /mcp

    Esperado: 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.