Skip to main content

​
Prerequisites

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

Answer the prompts:
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

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

2

Deploy a Workload

3

Get the Endpoint

​
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