Skip to main content
This page provides practical examples of how to interact with Control Plane through AI assistants using the MCP Server. These examples work across all compatible tools.

Setting Context

Before performing operations, always set your organization and GVC context:
Setting context once at the start of a conversation helps the AI assistant understand which resources to target.

GVC Operations

Create a GVC

Create a new Global Virtual Cloud with specific locations. You can use friendly location names or technical location IDs:
You can use friendly location names (like “Frankfurt”, “Virginia”, “Dublin”) or technical location IDs (like “aws-eu-central-1”, “aws-us-east-1”). The MCP server will resolve friendly names to the appropriate location IDs.

List GVCs

Get GVC Details


Workload Operations

Create a Workload

Create a new workload with various configurations:

Update a Workload

List Workloads

Get Workload Status

Delete a Workload

Deletion operations are irreversible. The AI assistant should be configured to confirm before executing destructive operations.

Image Operations

Build an Image

The cpln CLI must be installed and configured with a profile that is authenticated to the target organization. If no Dockerfile is present, the cpln image build command will use buildpacks to automatically create an image. Control Plane images are built for the linux/amd64 platform. Local builds need Docker; on a machine without it, cpln image build --remote builds remotely and pushes the image automatically.
Build and push a container image to the Control Plane private registry:

List Images

Get Image Details


Secret Management

Create and Wire a Secret

When granting workload access to secrets, describe the desired outcome — the MCP server will automatically create the identity, policy, and workload binding in one step.

Policy & Access Control

Manage Policies


Domain Configuration


Cloud Accounts


Suggestion Tools

Plan Before Executing


Workload Logs

Query Logs

The get_workload_logs tool builds LogQL queries automatically from structured parameters. Use the query parameter for advanced LogQL syntax.

Complex Workflows

Full Application Deployment

Environment Promotion

Debugging Session


Next Steps

Tool Setup

Configure MCP for your preferred tool

Workload Reference

Learn more about workload configuration options

GVC Concepts

Understand Global Virtual Clouds

Policy Reference

Configure permissions for your authorized orgs