← Alle Verbindungen

Mit Codex verbinden

Codex in VS Code or the terminal — config.toml with OAuth sign-in or a key in an environment variable.

Erstellen Sie vorab Ihr kostenloses Konto.Konto erstellen

Dieser Inhalt ist auf Englisch verfügbar.

Welchen MCP möchten Sie verbinden? Die Befehle unten passen sich Ihrer Auswahl an.

  1. 1

    Install and sign in

    In VS Code, install the official Codex extension from the marketplace and sign in with your ChatGPT/OpenAI account from the panel. The extension and the CLI share the same configuration, in ~/.codex/config.toml.

  2. 2

    Add the NewAlgorithm server

    Open config.toml (in the Codex panel: gear → Codex Settings → Open config.toml) and declare the server:

    ~/.codex/config.toml
    [mcp_servers.NewAlgorithm-TOTVS]
    url = "https://totvs.mcp.newalgorithm.io/mcp"
  3. 3

    Path 1 — OAuth sign-in

    In the terminal, run the server sign-in. The browser opens the NewAlgorithm authorization page (app.newalgorithm.io) for you to authorize; Codex stores the credential on its own.

    codex mcp login NewAlgorithm-TOTVS
  4. 4

    Generate your API key

    Sign in to app.newalgorithm.io with your account, open Keys & apps and generate a key. It is shown only once: copy it and store it somewhere safe.

    Key format
    na_live_xxxxxxxxxxxxxxxxx
  5. 5

    Path 2 — key in an environment variable

    To keep the key out of the file, store it in an environment variable and point Codex to it with bearer_token_env_var:

    Environment variable
    Windows (PowerShell):  setx NA_API_KEY "YOUR_API_KEY"
    macOS / Linux:         echo 'export NA_API_KEY="YOUR_API_KEY"' >> ~/.zshrc   # or ~/.bashrc

    Erwartet: Close and reopen the terminal and VS Code — only then do the processes pick up the new variable.

  6. 6

    And in 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

    Confirm in the Codex panel

    The /mcp command lists the active MCP servers.

    /mcp

    Erwartet: NewAlgorithm-TOTVS Connected

bearer_token_env_var holds the NAME of the variable, not the key. That way anyone can read config.toml without exposing the secret.

Details zu Authentifizierung und Tools in der Dokumentation.