Connect Codex
Use the hosted MCP server to access your workspace from Codex. You need an Orchestor account with access to the target workspace. Hosted OAuth does not require an API key in the client configuration.
1. Register the server
Add the following server to ~/.codex/config.toml. Merge it with existing configuration; preserve other servers and settings.
[mcp_servers.orchestor]
url = "https://mcp.orchestor.io/mcp"If an orchestor entry already exists, inspect its URL and reuse the intended connection rather than creating a duplicate.
2. Complete OAuth
codex mcp login orchestor
codex mcp listIn the browser, check the selected workspace and permissions before authorizing. Use read access for analysis tasks.
3. Verify a read
List the brands in my Orchestor workspace, including IDs and names.
A successful brands_list response confirms the first read. If authentication fails, check the client’s MCP status and sign in again. If the server is registered but no tools appear, reload the client session.