Skip to main content
We recommend the Control Plane AI Plugin for Codex. The plugin bundles the MCP server.

​
Prerequisites

https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/codex.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=7f6290d9a955377990c873b308593f35

OpenAI Codex

Install Codex CLI

Control Plane account

Sign up at console.cpln.io if you don’t have an account yet
For the latest MCP configuration options, refer to the official OpenAI Codex documentation.

​
Add the MCP server

1

Register the server

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 — a focused set that already covers the whole build-and-operate workflow (it can read and delete any resource kind generically, and reach anything else through the raw-API tool), which is the right fit for this client. Append ?toolsets=mk8s to add BYOK Kubernetes tools, or ?toolsets=full for everything. See toolset profiles.
2

Sign in

Run the login command:
codex mcp login cpln
Your browser opens:
  1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
  2. Select the orgs you want this Codex install to access.
  3. Click Authorize.
Your browser shows a success page — close the tab and return to Codex.
3

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
4

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.

​
Example conversation

1

Set Context

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

Deploy a Workload

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

Get the Endpoint

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

​
Troubleshooting

Some terminal setups can’t launch a browser. codex mcp login cpln prints a fallback URL — copy it into a browser on the same machine and complete sign-in there.
Re-run codex mcp login cpln, sign in again, and adjust your org selections on the consent screen.

​
Next steps

Usage Examples

Practical prompts for common Control Plane workflows

AI Plugin

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