Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.controlplane.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Prerequisites

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

Claude Code

Download Claude Code

Control Plane account

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

​
Add the MCP server

1

Register the server

Use the claude mcp add command:
claude mcp add --transport http cpln https://mcp.cpln.io/mcp --scope user
The user scope makes the server available across all your projects. Use --scope project to add it for the current directory only.
See the Claude Code MCP installation scopes for the full set of scope options.
2

Sign in

Launch Claude Code. It detects the new server and reports that authentication is required. Run /mcp, navigate to cpln, and choose Authenticate — your browser opens:
  1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
  2. Select the orgs you want this Claude Code install to access.
  3. Click Authorize.
Your browser shows a success page — close the tab and return to Claude Code.
3

Verify

In Claude Code, 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. Claude Code prints a fallback URL — copy it into a browser on the same machine and complete sign-in there.
In Claude Code, run /mcp, select cpln, and choose Re-authenticate. 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