Codex Setup
How do I connect Codex to Controller AI?
Section titled “How do I connect Codex to Controller AI?”Install the Controller AI plugin for Codex, then finish Codex’s OAuth login. The plugin bundles the hosted MCP connection and eleven skills. If the plugin is unavailable, add the connector URL directly. Verify the account inside Codex before you work on Support helper.
Install the plugin
Section titled “Install the plugin”In the app: open Settings → AI assistants → Connect an assistant and select Codex to copy the two commands for a direct connector.
With an assistant: install Controller AI from Codex’s plugin directory. The plugin asks for Controller AI authorization when you install it. OpenAI supports plugins in Codex in the ChatGPT desktop app and Codex CLI, but not the IDE extension. After installation, start a new desktop conversation or CLI session.
Add the connector without the plugin
Section titled “Add the connector without the plugin”These Codex commands add the server and start the browser login:
codex mcp add controllerai --url https://mcp.getcontroller.ai/mcpcodex mcp login controlleraiA saved URL is not authenticated. Complete the login, then call account_status. Without the plugin, the assistant reads the same guidance through guide_list and guide_get instead of installed skills.
Direct MCP shares one configuration across desktop, CLI, and IDE. In desktop, open Settings → MCP servers → Add server. In the IDE, use the gear menu → MCP servers → Add server. Name it controllerai, choose Streamable HTTP, and enter the URL above. Save it, select Restart on desktop or Restart extension in the IDE, then select Authenticate. See OpenAI’s MCP controls.
At browser consent, select Allow full access or Continue read-only for the access you want. Full access is enabled only if it was requested, and read-only appears only if it was requested. Then sign in to your Controller AI account, or sign up for one, and check the signed-in email before selecting Connect account.
Verify the Codex account
Section titled “Verify the Codex account”Inside Codex, call account_status with {}. Check user, account.accessMode, and grantedScopes, which report Codex’s OAuth grant. Unconfirmed email addresses are hidden, so a null user.email alone does not prove an account mismatch. If the call reports that you are not signed in, run codex mcp login controllerai again and complete the authorization with your own account.
Read guidance and check the inventory
Section titled “Read guidance and check the inventory”Call guide_get with {"name":"controllerai-start"}. The server stores no selected workflow. Pass workflowId on every workflow-scoped call, and supply instructions and file contents inline, never as local paths.
In the app: open Agents. You have no agents yet is a valid empty inventory, and that screen has no search control. Otherwise search for Support helper. All agents includes shared agents, while the query below returns only agents you own.
With an assistant: list existing matches without creating anything. Call agent_list with:
{ "ownership": "mine", "search": "Support helper" }Report names and IDs, or report no matches. Either successful result completes the inventory check.
Update Codex and its guidance
Section titled “Update Codex and its guidance”Use Codex’s host controls for its connection and plugin updates, and Skills and updates for guidance maintenance. A plugin update replaces the bundled skills.
These instructions are for external Codex. Controller AI’s in-product builder already has managed authentication and bundled guidance, so it must not install, connect, or upgrade itself.
Next: build Support helper or review Assistant access and security.