Codex — MCP Configs
- File format
- TOML
- Syllago install method
- JSON merge
- Symlink support
- No
- Config file
-
.codex/config.toml - Transports
-
stdio
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Config key | Conversion | Canonical key | Summary |
|---|---|---|---|
enabled_tools | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | — | Per-server enabled_tools (allowlist) and disabled_tools (blocklist) arrays restrict which tools an MCP server exposes. |
mcp_oauth_credentials_store | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | — | OAuth fields mcp_oauth_callback_port, mcp_oauth_callback_url, and mcp_oauth_credentials_store (keyring/file/auto), plus per-server oauth_resource and scopes. |
mcp_servers | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | — | MCP servers declared under mcp_servers in config.toml as RawMcpServerConfig entries (command/url, args, env, headers, OAuth, timeouts, enabled/disabled tools). |
tools.approval_mode | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | — | Each MCP server can set per-tool approval_mode via the tools map, overriding session-level approval policy for individual tools. |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
auto_approve | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | mcp_per_tool_approval: Codex supports per-tool approval configuration to suppress confirmation prompts for trusted tools |
oauth_support | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | mcp_oauth_support: Codex supports OAuth 2.0 authentication for remote MCP servers |
tool_filtering | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | mcp_enabled_disabled_tools: Codex supports per-server tool enable/disable configuration controlling which tools are exposed to the agent |
| Codex MCP Server Interface (codex mcp-server) | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Codex exposes itself as an MCP server via `codex mcp-server` (JSON-RPC 2.0 over stdio) for thread, turn, config, and event-stream control. |
Sources
| Source |
|---|
| https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/config.schema.json |
| https://raw.githubusercontent.com/openai/codex/main/codex-rs/docs/codex_mcp_interface.md |