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.

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
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