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
-
Add the server to
~/.codex/config.toml:[mcp_servers.xentropy] url = "https://api.xentropy.ai/mcp" -
Sign in:
codex mcp login xentropy -
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_KEYis set in the job and that the key is not revoked under Settings → API Keys.