OpenAI Codex

We recommend the Control Plane AI Plugin for Codex. The plugin bundles the MCP server.

Prerequisites

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

Use the codex mcp add command:

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

Run the login command:

codex mcp login cpln

Your browser opens:

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.

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.

Browser didn't open for sign-in

Need to change which orgs are authorized

Re-run codex mcp login cpln, sign in again, and adjust your org selections on the consent screen.