Connect the Codex App to Agent Authority

OpenAI's desktop app for Codex with MCP support. Once connected, the Codex App reaches every tool your organization has approved through a single governed endpoint — every call authenticated, policy-checked, and audited.

Setup

1. Add the MCP server — Add the following to ~/.codex/config.toml:

[mcp_servers.secureauth]
url = "https://your-gateway-url/gateway/mcp"

2. Authenticate

codex mcp login secureauth

3. Open Codex App — Launch the Codex desktop app.

The agent is auto-registered on first connect.

Connecting to just one MCP?To stay under an agent's tool limit, point the URL at a single MCP — /gateway/mcp/{slug} instead of /gateway/mcp. Grab the exact URL from the resource's detail page; see Scope a connection to one MCP.

Next steps

• Create a policy — control which tools the Codex App can call.
• Monitor activity — watch its tool calls appear in the dashboard and audit log.
• Send Codex telemetry — track its token usage and cost in Analytics.