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 Gemini CLI. The plugin bundles the MCP server.

​
Prerequisites

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

Gemini CLI

Get started with Gemini CLI

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 gemini mcp add command:
gemini 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 for the current directory only.
See the Gemini CLI MCP documentation for the full set of scope options.
2

Sign in

Launch Gemini, then run the auth command inside the chat:
/mcp auth cpln
Your browser opens:
  1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
  2. Select the orgs you want this Gemini CLI install to access.
  3. Click Authorize.
Your browser shows a success page — close the tab and return to Gemini.
3

Verify

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