Skip to main content

​
Prerequisites

The Codex app is available on macOS (Apple Silicon). Download it from OpenAI. The Codex app, Codex CLI, and Codex IDE extension all share the same ~/.codex/config.toml configuration. Setting up Danube in any one of them makes it available in all three.

​
Setup

1

Open MCP Settings

Go to Codex Settings → MCP Servers → + Add Server.
2

Add the Danube Server

Fill in the “Connect to a custom MCP” form:Leave all other fields empty and click Save.
3

Authenticate

After saving, click Authenticate on the Danube server entry. Danube opens in your browser: sign in with your Danube account, pick a workspace if you belong to an organization, and click Allow.
4

Verify Connection

The Danube server should now show as connected in your MCP Servers list. Tools will be available to the Codex agent across all threads.
The connection is listed under Connected apps, where you can disconnect it.

​
Troubleshooting

  • Verify the server shows as connected in Settings → MCP Servers
  • Check that the transport is set to Streamable HTTP, not STDIO
  • Try clicking Authenticate again to re-authorize
  • Click Authenticate again: a sign-in request expires after 15 minutes
  • If the connection was disconnected under Connected apps, connect it again
  • Ensure your Danube account is active
  • Check your internet connection
  • Test the health check: curl https://mcp.danubeai.com/health