Codex Desktop

Codex Desktop is OpenAI's desktop coding assistant application. By connecting Codex Desktop to Sazabi's MCP server, you can investigate production issues from within the Codex interface.

About Codex Desktop

Codex Desktop provides a dedicated application for AI-assisted coding. With MCP support, it can connect to external services like Sazabi, giving you access to observability data alongside your development work.

Prerequisites

Before configuring Codex Desktop to use Sazabi, make sure you have:

• Codex Desktop installed: Download from OpenAI's website.
• A Sazabi secret key: Create one in Settings -> API Keys in the Sazabi dashboard. Select Secret as the key type.

Configuration

Codex Desktop uses MCP servers defined in its configuration file.

{
  "mcpServers": {
    "sazabi": {
      "type": "http",
      "url": "https://mcp.sazabi.com/mcp",
      "headers": {
        "X-Sazabi-Secret-Key": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

{
  "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.

Verifying the connection

After configuring Codex Desktop:

1. Restart Codex Desktop completely.
2. Start a new session.
3. Ask Codex to use Sazabi:

Use Sazabi to list my projects

Using Sazabi tools

Once connected, you can ask Codex Desktop to query your observability data:

Ask Sazabi about recent errors in production
Use Sazabi to search for database timeouts
What does Sazabi show for the checkout service?

Troubleshooting

MCP server not appearing

If Sazabi does not appear as an available MCP server:

1. Verify the configuration file exists at the correct path.
2. Ensure the JSON is valid.
3. Completely quit and restart Codex Desktop.

Connection errors

If you see connection errors:

1. Verify your secret key is correct and has not been revoked.
2. Check that the URL is exactly https://mcp.sazabi.com/mcp.
3. Ensure your network can reach mcp.sazabi.com.

Next steps