Skip to main content

​
Prerequisites

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

OpenCode

Install OpenCode

Control Plane account

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

​
Add the MCP server

1

Run the add wizard

opencode mcp add
Answer the prompts:
PromptValue
LocationGlobal
MCP server namecpln
MCP server typeRemote
MCP server URLhttps://mcp.cpln.io/mcp
Does this server require OAuth authentication?Yes
Do you have a pre-registered client ID?No
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.
OpenCode writes the entry to ~/.config/opencode/opencode.jsonc.
2

Authenticate

opencode mcp auth cpln
Your browser opens:
  1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
  2. Select the orgs you want OpenCode to access.
  3. Click Authorize.
Your browser shows a success page — close the tab and return to the terminal. OpenCode prints Authentication successful!.
3

Use it

Launch OpenCode and ask “list GVCs in org <your-org>” (using one of the orgs you authorized) to confirm.

​
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

Re-run opencode mcp auth cpln. 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