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

# Antigravity

> Connect Google Antigravity (CLI or IDE) to Control Plane to manage your infrastructure with AI-powered development workflows.

## Prerequisites

<CardGroup cols={2}>
  <Card title="Google Antigravity" icon="https://mintcdn.com/controlplanecorporation/rFQpIcXts1y-5L7u/icons/antigravity.png?fit=max&auto=format&n=rFQpIcXts1y-5L7u&q=85&s=48d54825666f9af129853a040db724a6" width="128" height="128" data-path="icons/antigravity.png">
    Download [Antigravity](https://antigravity.google)
  </Card>

  <Card title="Control Plane account" icon="user">
    Sign up at [console.cpln.io](https://console.cpln.io) if you don't have an account yet
  </Card>
</CardGroup>

<Note>
  For the latest MCP configuration options in Antigravity, see the official [Google Antigravity documentation](https://antigravity.google/docs).
</Note>

## Add the MCP server

<Steps>
  <Step title="Edit the MCP config file">
    Open `mcp_config.json` in your editor:

    | OS            | Path                                           |
    | ------------- | ---------------------------------------------- |
    | macOS / Linux | `~/.gemini/config/mcp_config.json`             |
    | Windows       | `%USERPROFILE%\.gemini\config\mcp_config.json` |

    Create the `.gemini/config` directory and `mcp_config.json` file if they don't exist.
  </Step>

  <Step title="Add the Control Plane server">
    ```json theme={null}
    {
      "mcpServers": {
        "cpln": {
          "serverUrl": "https://mcp.cpln.io/mcp"
        }
      }
    }
    ```

    <Note>
      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](/ai/mcp#toolset-profiles).
    </Note>

    Save the file.
  </Step>

  <Step title="Authenticate">
    Trigger the OAuth flow:

    * **Antigravity CLI** — run `/mcp`, select `cpln`, and choose **Authenticate**.
    * **Antigravity IDE** — the agent reports an **MCP Error** for the new server; click it, then **View MCP Settings → Authenticate** (or **Settings → Customizations → Authenticate** next to the `cpln` MCP).

    Your browser opens:

    1. Sign in to Control Plane (Google, GitHub, Microsoft, or SAML).
    2. Select the orgs you want Antigravity to access.
    3. Click **Authorize**.

    The browser redirects to an Antigravity page with a code — copy it.
  </Step>

  <Step title="Paste the code">
    Back in Antigravity, paste the code into the prompt. The `cpln` server is now connected.
  </Step>

  <Step title="Use it">
    In the agent, ask "list GVCs in org `<your-org>`" (using one of the orgs you authorized) to confirm.
  </Step>
</Steps>

## Example conversation

<Steps>
  <Step title="Set Context">
    ```
    Use org "my-org" and gvc "my-gvc" for context.
    ```
  </Step>

  <Step title="Deploy a Workload">
    ```
    Create a publicly accessible workload called "my-api" using nginx:latest on port 80.
    ```
  </Step>

  <Step title="Get the Endpoint">
    ```
    Monitor the readiness of my-api and give me the public endpoint once it's ready.
    ```
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Need to change which orgs are authorized">
    Open **Settings → Customizations**, click **Sign Out** next to the `cpln` MCP, then click **Authenticate** to start the OAuth flow again. Sign in again and adjust your org selections on the consent screen.
  </Accordion>
</AccordionGroup>

## Next steps

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

  <Card title="Template Catalog" icon="grid" href="/template-catalog/overview">
    30+ production-ready templates your AI can deploy on request
  </Card>
</CardGroup>