​
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 brands 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 brands 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 brands.

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.