OpenAI Codex

We recommend the Control Plane AI Plugin for Codex. It configures the MCP server on the full toolset profile and adds skills, agents, slash commands, and guardrails on top.

Pick your Codex surface

Codex ships three clients, and how you connect Control Plane differs by surface:

Surface	Control Plane AI Plugin	ChatGPT Plugin directory	Direct MCP registration
Codex CLI	Yes, `codex plugin marketplace add`	Yes, through `/plugins`	Yes, `codex mcp add`
Codex in the ChatGPT desktop app	No	Yes, install it in ChatGPT	No
Codex IDE extension	No	Yes, synced from ChatGPT	Yes, Settings → MCP servers

Prerequisites

Install Codex CLI

Control Plane account

For the latest MCP configuration options, refer to the official OpenAI Codex documentation.

Add Control Plane

Codex CLI
ChatGPT desktop app
Codex IDE extension

Use the codex mcp add command:

codex mcp add cpln --url https://mcp.cpln.io/mcp

Connecting to the bare URL uses the default core toolset profile. Append ?toolsets=mk8s to add BYOK Kubernetes tools, or ?toolsets=full for everything. See toolset profiles.

Run the login command:

codex mcp login cpln

Your browser opens:

Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
Select the orgs you want this Codex install to access.
Click Authorize.

Your browser shows a success page. Close the tab and return to Codex.

Verify the registration

codex mcp list

You should see cpln with enabled status and OAuth auth:

Name  Url                      Bearer Token Env Var  Status   Auth
cpln  https://mcp.cpln.io/mcp  -                     enabled  OAuth

Verify live access

Launch Codex and ask: “list GVCs in org <your-org>” (using one of the orgs you authorized). You should see the GVCs in that org.

Codex CLI can also install Control Plane from the ChatGPT Plugin directory: start Codex, run /plugins, switch to the directory tab, and install Control Plane. That route is fixed on core, so use codex mcp add above for a wider profile. Details on ChatGPT.

Codex running inside the ChatGPT desktop app uses ChatGPT’s own plugin surface, not Codex CLI configuration. Install the Control Plane plugin once in ChatGPT and Codex picks it up there.

Install the plugin

Open the Control Plane plugin listing and click Install plugin. If that link doesn’t open the listing, click Plugins in the left sidebar and search for Control Plane.

Authorize your orgs

When prompted to Connect, sign in to Control Plane, select the orgs you want to expose, and click Authorize.

Use it

Start a new Codex session in the desktop app, then type @ and pick Control Plane to invoke it explicitly.

The listing is fixed on the default core toolset profile and takes no query parameter. Full setup notes are on the ChatGPT page.

Open Codex settings → Plugins. A plugin you already installed in ChatGPT or the Codex app appears there as installed and enabled, so Control Plane needs no further setup on this surface.Register the MCP server directly when you want a toolset profile other than core.

Add the server

In the extension settings, select MCP servers → Add server, then fill in:

Field	Value
Name	`cpln`
Type	`Streamable HTTP`
URL	`https://mcp.cpln.io/mcp`

Connecting to the bare URL uses the default core toolset profile. Append ?toolsets=mk8s to add BYOK Kubernetes tools, or ?toolsets=full for everything. See toolset profiles.

Restart

Save the server, then select Restart.

On first use the extension opens your browser:

Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
Select the orgs you want this Codex install to access.
Click Authorize.

Verify live access

Ask Codex to “list GVCs in org <your-org>” (using one of the orgs you authorized).

Example conversation

Set Context

Use org "my-org" and gvc "my-gvc" for context.

Deploy a Workload

Create a publicly accessible workload called "my-api" using nginx:latest on port 80.

Get the Endpoint

Monitor the readiness of my-api and give me the public endpoint once it's ready.

Troubleshooting

Need to change which orgs are authorized

On Codex CLI, re-run codex mcp login cpln, sign in again, and adjust your org selections on the consent screen. On the ChatGPT desktop app, click Plugins in the left sidebar, open Control Plane, disconnect it, then connect again.

Control Plane isn't listed in Codex CLI after installing it in ChatGPT

Run /plugins in Codex CLI and install Control Plane from the directory tab there, or register the MCP server with codex mcp add cpln --url https://mcp.cpln.io/mcp. Either way, start a new CLI session afterwards.

Next steps

AI Plugin

Layer skills, agents, slash commands, and guardrails on top of the MCP server

ChatGPT

Install the Control Plane plugin for ChatGPT on the web, desktop, and mobile

Usage Examples

Practical prompts for common Control Plane workflows

Tools Reference

Every tool the MCP server exposes, grouped by resource

Getting Started

MCP Clients

OpenAI Codex

Pick your Codex surface

Prerequisites

OpenAI Codex

Control Plane account

Add Control Plane

Example conversation

Troubleshooting

Next steps

AI Plugin

ChatGPT

Usage Examples

Tools Reference

​Pick your Codex surface

​Prerequisites

OpenAI Codex

Control Plane account

​Add Control Plane

​Example conversation

​Troubleshooting

​Next steps

AI Plugin

ChatGPT

Usage Examples

Tools Reference

Pick your Codex surface

Prerequisites

Add Control Plane

Example conversation

Troubleshooting

Next steps