Skip to main content
Version: 2.2

Codex

Codex supports MCP servers via a TOML configuration file.

Configuration​

Add the following to your Codex configuration file:

  • macOS / Linux: ~/.codex/config.toml
  • Windows: %USERPROFILE%\.codex\config.toml
[mcp_servers.maestrohub]
url = "https://<your-instance>/api/v1/mcp"
http_headers = { "Authorization" = "ApiKey <your-token>", "X-Organization-ID" = "<your-org-id>" }

Replace the placeholders:

  • <your-instance> — your MaestroHub domain (e.g., maestro.example.com)
  • <your-token> — the Personal Access Token you created
  • <your-org-id> — your organization ID (found in the URL or organization settings)
note

For local deployments without TLS, change https:// to http:// in the URL (e.g., http://localhost:8080/api/v1/mcp).

Tips​

  • Codex uses TOML format instead of JSON.
  • The config file is global, so MaestroHub will be available in all projects.
  • Create the directory if it doesn't exist:
    • macOS / Linux: mkdir -p ~/.codex
    • Windows: mkdir %USERPROFILE%\.codex