Skip to main content
Connect Google Antigravity to Control Plane to manage your infrastructure with AI-powered development workflows.

​
Prerequisites

Google Antigravity

Download Antigravity

Service Account Token

Create a service account with appropriate permissions
For the latest MCP configuration options in Antigravity, refer to the official Google Antigravity Documentation.

​
Configuration

1

Open MCP Store

In Antigravity, open the MCP store via the ”…” dropdown at the top of the editor’s agent panel.
2

Access MCP Configuration

Click on “Manage MCP Servers”, then click on “View raw config” to open the mcp_config.json file.
3

Add the MCP Server Configuration

Add the Control Plane MCP Server to the mcp_config.json file:
{
  "mcpServers": {
    "cpln": {
      "env": {
        "BEARER_TOKEN": "<your-service-account-token>"
      },
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.cpln.io/mcp",
        "--header",
        "Authorization: ${BEARER_TOKEN}"
      ]
    }
  }
}
Replace <your-service-account-token> with your actual service account token.
This method requires Node.js and npm to be installed on your system.
4

Save Configuration

Save the mcp_config.json file. Antigravity will automatically reload the MCP server configuration.

​
Verify the Connection

After configuration, verify the connection by asking the AI agent: 
List all cpln mcp server tools
The agent should list the available Control Plane MCP tools.

​
Example Usage

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

  • Check that your service account token is valid.
  • Ensure the token is entered without extra spaces or quotes.
  • Verify the token has appropriate permissions (see Service Account Permissions).
  • Check for typos in the org name you’re using for context, this is a common cause of authentication failures.
  • Ensure Node.js and npm are installed (required for npx).
  • Verify the JSON syntax is valid.
  • Check the AI agent panel for error messages.
  • Restart Antigravity if the server doesn’t appear.

​
Next Steps

Usage Examples

See practical examples of Control Plane operations

Policy Reference

Learn about permissions and access control