Skip to main content

​
Prerequisites

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

Cursor Web

Open Cursor on the web

Control Plane account

Sign up at console.cpln.io if you don’t have an account yet

​
Add the MCP server

1

Open the MCPs dropdown

In Cursor on the web, click the MCPs dropdown.
2

Add a Custom MCP

Click +, select Custom MCP, and fill in:
FieldValue
Namecpln
Server URLhttps://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.
Click Add MCP.
3

Login

On the new cpln item in the MCPs dropdown, click Login.
  1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
  2. Select the orgs you want Cursor to access.
  3. Click Authorize.
You’re returned to the same Cursor page.
4

Use it

Ask “list GVCs in org <your-org>” (using one of the orgs you authorized) to confirm.
For the latest UI changes, see Cursor’s MCP documentation.

​
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

In the MCPs dropdown, click Edit on the cpln MCP, click Logout in the popup, then Login again. Sign in again and adjust your org selections on the consent screen.

​
Next steps

Usage Examples

Practical prompts for common Control Plane workflows

Template Catalog

30+ production-ready templates your AI can deploy on request