Docs
Agents and APIClients

Codex

Add Xentropy to OpenAI Codex in config.toml and sign in with OAuth or a bearer token from the environment.

Codex reads MCP servers from ~/.codex/config.toml.

Connect with OAuth

  1. Add the server to ~/.codex/config.toml:

    [mcp_servers.xentropy]
    url = "https://api.xentropy.ai/mcp"
  2. Sign in:

    codex mcp login xentropy
  3. Sign in to Xentropy in the browser and review the requested access.

Headless or CI

For codex exec and CI, create a key with the Agent preset under Settings → API Keys and keep it in your environment as XENTROPY_API_KEY. Codex reads it through bearer_token_env_var:

[mcp_servers.xentropy]
url = "https://api.xentropy.ai/mcp"
bearer_token_env_var = "XENTROPY_API_KEY"

The config file names the variable, never the key itself.

Plugin

The Xentropy plugin for Codex adds Xentropy skills. Add the marketplace with codex plugin marketplace add xentropyai/xentropy-plugins, then install xentropy from /plugins or with codex plugin add xentropy@xentropy. Keep the [mcp_servers.xentropy] entry above: it is what connects Codex to Xentropy.

Scopes to grant

OAuth sign-in offers the agent default scopes: artifacts:read, artifacts:write, artifacts:render, dashboards:read, dashboards:write, data:read, data:write and connections:read. The Agent preset for API keys matches that set. See API keys and scopes.

Troubleshooting

  • New tools are missing. Codex lists tools when a session starts. After a Xentropy update, start a new session.
  • Authentication needed again. Run codex mcp login xentropy.
  • 401 in CI. Check that XENTROPY_API_KEY is set in the job and that the key is not revoked under Settings → API Keys.

On this page