OpenAI Codex
Connect Causely to OpenAI Codex to run reliability checks and incident triage alongside your coding workflows.
Prerequisites
- Active Causely account
- OpenAI Codex CLI installed
Configuration
Add the following to ~/.codex/config.toml or project .codex/config.toml:
[mcp_servers.causely]
url = "https://api.causely.app/mcp"
enabled = true
Config file location
| Scope | Path |
|---|---|
| User | ~/.codex/config.toml |
| Project | .codex/config.toml at the repository root |
Restart
Codex reads config.toml once at launch. After editing, start a new Codex session to pick up the change.
Skills are not yet supported for Codex. You'll interact with the Causely MCP server directly; the example prompts in the Key Workflows section still work, but tool selection is handled by Codex's agent rather than a Causely skill router.
Try It Now
- "List my clusters."
- "Are there any active symptoms right now?"
- "What services are currently degraded?"
Known Gotcha
For machine credentials, use env_http_headers (reads from environment variables at runtime) instead of http_headers (static values in the file) to keep secrets out of the config:
[mcp_servers.causely]
url = "https://api.causely.app/mcp"
enabled = true
[mcp_servers.causely.env_http_headers]
"X-Causely-Client-Basic" = "CAUSELY_MCP_CLIENT_BASIC"
Export CAUSELY_MCP_CLIENT_BASIC to the Base64-encoded client_id:client_secret string before launching Codex. See Advanced Authentication for encoding instructions.