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 IDE

Download Cursor

Control Plane account

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

​
Add the MCP server

1

Open MCP settings

In Cursor, go to Settings → Tools & MCPs, then click New MCP Server under Home MCP Servers. Cursor opens your global mcp.json:
OSPath
macOS / Linux~/.cursor/mcp.json
Windows%USERPROFILE%\.cursor\mcp.json
2

Add the Control Plane server

{
  "mcpServers": {
    "cpln": {
      "type": "http",
      "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.
Save and close the file.
3

Connect

Back in Cursor’s MCP settings, the cpln server now shows a Connect button. Click it.
  1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
  2. Select the orgs you want Cursor to access.
  3. Click Authorize.
Your browser shows a success page — close the tab and return to Cursor.
4

Use it

Open Cursor’s AI chat and 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 Cursor’s MCP settings, expand the cpln server, click Logout, then Connect again. Sign in again and adjust your org selections on the consent screen.
Verify the JSON syntax in mcp.json and reload Cursor.

​
Next steps

Usage Examples

Practical prompts for common Control Plane workflows

Template Catalog

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