Skip to main content

​
Connect Codex to Ocoya MCP

Use this MCP URL when configuring Codex: 
https://mcp.ocoya.com

​
Config file

1

Open Codex config

Open ~/.codex/config.toml.
2

Add the Ocoya MCP server

Add this server entry:
[mcp_servers.ocoya]
url = "https://mcp.ocoya.com"
3

Run CLI to authenticate

Run the OAuth login command:
codex mcp login ocoya
4

Approve OAuth access

When Ocoya opens in your browser, sign in, approve permissions, and select the workspaces Codex can access.
5

Reload Codex

Restart Codex Desktop or open a new thread so the authenticated Ocoya tools are loaded.

​
CLI setup

1

Add the MCP server

Run:
codex mcp add ocoya --url https://mcp.ocoya.com
2

Run CLI to authenticate

Run:
codex mcp login ocoya
3

Approve OAuth access

Complete the Ocoya OAuth page by approving permissions and selecting the workspaces Codex can access.
4

Reload Codex

Restart Codex Desktop or open a new thread before using the Ocoya tools.
If codex is not on your PATH on macOS, use the bundled app CLI: 
/Applications/Codex.app/Contents/Resources/codex mcp add ocoya --url https://mcp.ocoya.com
/Applications/Codex.app/Contents/Resources/codex mcp login ocoya

​
Test the connection

Start with a read-only request: 
List my Ocoya workspaces.
If Codex does not expose Ocoya tools after authentication, restart Codex Desktop and open a new thread. You can also check MCP status with /mcp. Only approve write actions such as publishing, deleting posts, or running workflows when the intended action is clear.