Codex CLI
Set up OpenAI's Codex CLI to use Sazabi's MCP server for observability queries and debugging.
Codex CLI is OpenAI's terminal-based coding assistant. By connecting Codex CLI to Sazabi's MCP server, you can query your production systems directly from your terminal.
About Codex CLI
Codex CLI brings AI-powered coding assistance to your command line. With MCP support, it can connect to external services like Sazabi, giving you access to observability data while working in the terminal.
Prerequisites
Before configuring Codex CLI to use Sazabi, make sure you have:
- Codex CLI installed: See OpenAI's documentation for installation instructions.
- A Sazabi secret key: Create one in Settings -> API Keys in the Sazabi dashboard. Select Secret as the key type.
Configuration
Codex CLI uses MCP servers defined in its configuration file.
Edit ~/.codex/config.json:
{
"mcpServers": {
"sazabi": {
"type": "http",
"url": "https://mcp.sazabi.com/mcp",
"headers": {
"X-Sazabi-Secret-Key": "<YOUR_SECRET_KEY>"
}
}
}
}Edit %USERPROFILE%\.codex\config.json:
{
"mcpServers": {
"sazabi": {
"type": "http",
"url": "https://mcp.sazabi.com/mcp",
"headers": {
"X-Sazabi-Secret-Key": "<YOUR_SECRET_KEY>"
}
}
}
}Replace <YOUR_SECRET_KEY> with your actual Sazabi secret key.
Keep your secret key secure. Do not commit configuration files containing secret keys to version control.
Verifying the connection
After configuring Codex CLI:
- Start a new Codex CLI session.
- Ask Codex to use Sazabi:
Use Sazabi to list my projectsUsing Sazabi tools
Once connected, you can ask Codex CLI to query your observability data:
Ask Sazabi about errors in the API service
Use Sazabi to search for logs containing "timeout"
What does Sazabi show for recent deployments?Troubleshooting
MCP server not found
If Codex CLI reports that the Sazabi MCP server is not available:
- Verify the configuration file path is correct.
- Ensure the JSON is valid.
- Restart Codex CLI after making configuration changes.
Connection errors
If you see connection errors:
- Verify your secret key is correct and has not been revoked.
- Check that the URL is exactly
https://mcp.sazabi.com/mcp. - Ensure your network can reach
mcp.sazabi.com.