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

# Teach your AI coding agent to use Control Plane

> Two paths — the AI Plugin for Claude Code, Codex, and Antigravity CLI, or the MCP Server for any other MCP-compatible client.

<CardGroup cols={2}>
  <Card title="AI Plugin (Recommended)" icon="puzzle-piece" href="/ai/plugin">
    For **Claude Code, Codex, and Antigravity CLI**. Includes the MCP server plus skills, agents, slash commands, and guardrails.
  </Card>

  <Card title="MCP Server" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/mcp.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=cb54e1afd80c8345d82dc3e4c9ca2e32" href="/ai/mcp" width="24" height="24" data-path="icons/mcp.svg">
    For **any other MCP-compatible AI** — Cursor, Claude Web, Claude Desktop, VS Code, Antigravity IDE, Amp, OpenCode.
  </Card>
</CardGroup>

## What you can do

<CardGroup cols={2}>
  <Card title="Manage Resources" icon="cloud">
    Create and configure GVCs, workloads, identities, and more
  </Card>

  <Card title="Deploy Applications" icon="rocket">
    Build images and deploy applications across global locations
  </Card>

  <Card title="Query Infrastructure" icon="magnifying-glass">
    Get real-time information about your Control Plane resources
  </Card>

  <Card title="Automate Workflows" icon="robot">
    Streamline DevOps tasks through conversational AI
  </Card>
</CardGroup>

## Which path for which tool?

<CardGroup cols={3}>
  <Card title="Claude Code" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/claude.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=8b0f9fcceff42ac846ff975af5126fb4" href="/ai/plugin" width="248" height="248" data-path="icons/claude.svg">
    **AI Plugin** · [MCP only](/ai/claude)
  </Card>

  <Card title="Codex" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/codex.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=7f6290d9a955377990c873b308593f35" href="/ai/plugin" width="2406" height="2406" data-path="icons/codex.svg">
    **AI Plugin** · [MCP only](/ai/codex)
  </Card>

  <Card title="Antigravity CLI" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/antigravity.png?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=48d54825666f9af129853a040db724a6" href="/ai/plugin" width="128" height="128" data-path="icons/antigravity.png">
    **AI Plugin** · [MCP only](/ai/antigravity)
  </Card>

  <Card title="Cursor" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/cursor.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=074f2c93b5c6063ae950a872e7821eb3" href="/ai/cursor" width="24" height="24" data-path="icons/cursor.svg">
    MCP Server
  </Card>

  <Card title="Claude Desktop" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/claude.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=8b0f9fcceff42ac846ff975af5126fb4" href="/ai/claude-desktop" width="248" height="248" data-path="icons/claude.svg">
    MCP Server
  </Card>

  <Card title="Claude Web" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/claude.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=8b0f9fcceff42ac846ff975af5126fb4" href="/ai/claude-web" width="248" height="248" data-path="icons/claude.svg">
    MCP Server
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/vscode.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=68f269932eab223833a1c4f78d6be90a" href="/ai/vscode" width="100" height="100" data-path="icons/vscode.svg">
    MCP Server
  </Card>

  <Card title="Antigravity IDE" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/antigravity.png?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=48d54825666f9af129853a040db724a6" href="/ai/antigravity" width="128" height="128" data-path="icons/antigravity.png">
    MCP Server
  </Card>

  <Card title="Amp" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/amp.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=727a834ec66ee41c3e405eb04f9097be" href="/ai/amp" width="21" height="21" data-path="icons/amp.svg">
    MCP Server
  </Card>

  <Card title="OpenCode" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/opencode.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=f58ee6d5c9eb2828f371a72d7ba8c8fc" href="/ai/opencode" width="512" height="512" data-path="icons/opencode.svg">
    MCP Server
  </Card>

  <Card title="Other MCP clients" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/mcp.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=cb54e1afd80c8345d82dc3e4c9ca2e32" href="/ai/mcp" width="24" height="24" data-path="icons/mcp.svg">
    Any remote-MCP client
  </Card>
</CardGroup>

## Sign in

Each tool triggers OAuth its own way — see your tool's setup page for the specifics. Once your browser lands on Control Plane:

<Steps>
  <Step title="Sign in to Control Plane">
    Use Google, GitHub, Microsoft, or SAML.
  </Step>

  <Step title="Authorize orgs">
    Pick the orgs this AI client may access and click **Authorize**.
  </Step>
</Steps>

## Best practices

<CardGroup cols={2}>
  <Card title="Authorize only the orgs you need" icon="shield">
    Per-client consent lets you scope each AI tool to the smallest org set that makes sense for its job
  </Card>

  <Card title="Start with context" icon="bullseye">
    Always set your org and GVC context at the start of a conversation
  </Card>

  <Card title="Be specific" icon="list-check">
    Provide specific values for resources (memory, CPU, replicas) when possible
  </Card>

  <Card title="Use tags" icon="tags">
    Add tags to resources for better organization and filtering
  </Card>
</CardGroup>

### Recommended prompt structure

For the best results, structure your prompts with:

1. **Context** — Org and GVC
2. **Action** — What you want to do
3. **Target** — Which resource
4. **Details** — Specific configuration values

<CodeGroup>
  ```text Good prompt theme={null}
  Using org "my-org" and GVC "production", create a workload called "api-v2"
  with image nginx:latest, 512Mi memory, port 8080, and minimum 2 replicas.
  ```

  ```text Less effective theme={null}
  Make a new workload.
  ```
</CodeGroup>

## References

<CardGroup cols={2}>
  <Card title="AI Plugin" icon="puzzle-piece" href="/ai/plugin">
    Install guide and the full inventory of skills, agents, commands, and guardrails
  </Card>

  <Card title="MCP Server" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/mcp.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=cb54e1afd80c8345d82dc3e4c9ca2e32" href="/ai/mcp" width="24" height="24" data-path="icons/mcp.svg">
    Endpoint and the compatible-tools list
  </Card>

  <Card title="Tools Reference" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/mcp.svg?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=cb54e1afd80c8345d82dc3e4c9ca2e32" href="/ai/tools" width="24" height="24" data-path="icons/mcp.svg">
    Every tool the MCP server exposes, grouped by resource
  </Card>

  <Card title="Usage Examples" icon="lightbulb" href="/ai/examples">
    Practical prompts for common Control Plane workflows
  </Card>

  <Card title="AI Plugin on GitHub" icon="github" href="https://github.com/controlplane-com/ai-plugin">
    Source, release notes, and contribution guide
  </Card>
</CardGroup>