Codex
Connect OmniDimension to Codex in one terminal command. OAuth sign-in via the browser, shared config across the Codex CLI, IDE extension, and the ChatGPT desktop app.
One command:
codex mcp add omnidim --url https://mcp.omnidim.io/mcpCodex detects that the server supports OAuth and starts the sign-in flow immediately. A browser tab opens to the OmniDimension consent screen. Sign in, click Allow, and the terminal prints Successfully logged in.
Verify
codex mcp listThe omnidim row shows enabled with OAuth in the Auth column. Then, inside a Codex session, ask:
What OmniDimension agents do I have?Codex will call listAgents and report your agent list. If you see your agents, you're set.
ChatGPT desktop app and IDE extension
The Codex CLI, the Codex IDE extension, and the ChatGPT desktop app all read the same config at ~/.codex/config.toml, so the one-command setup above covers all three. Configure once in the terminal and the connector shows up everywhere.
To add it from the desktop app UI instead:
- Open Settings, then MCP servers.
- Select Add server.
- Name it
omnidim, choose Streamable HTTP, and enterhttps://mcp.omnidim.io/mcp. - Save, then select Restart.
- If the server list shows it needs sign-in, select Authenticate to open the OmniDimension consent screen.
Config file
codex mcp add writes this block to ~/.codex/config.toml. You can also add it by hand:
[mcp_servers.omnidim]
url = "https://mcp.omnidim.io/mcp"To scope the server to a single project instead of your whole machine, put the same block in a .codex/config.toml inside the project (trusted projects only).
Re-authenticate
If the token expires or you signed in to the wrong account, run the OAuth flow again:
codex mcp login omnidimAPI key instead of OAuth
For headless or CI use, run the local stdio server with an API key from omnidim.io/api-management:
codex mcp add omnidim-local --env OMNIDIM_API_KEY=sk_xxx -- npx -y @omnidim-ai/mcp-serverNote that the npm package's setup command does not auto-configure Codex; use the command above.
Remove
codex mcp remove omnidimThis deletes the local config. To also revoke the OAuth token on the server side, remove the corresponding credential at omnidim.io/api-management.
Windsurf
Add OmniDimension to Windsurf via ~/.codeium/windsurf/mcp_config.json. OAuth sign-in in the browser, no API key handling.
Local MCP server
Run the OmniDimension MCP server locally as a stdio child process. Distributed as @omnidim-ai/mcp-server on npm. One command auto-configures every detected MCP client.