Control Plane

offiziell

Workloads, Secrets und Netzwerke über AWS, GCP, Azure und private Clouds hinweg bereitstellen und betreiben.

Was kann man mit Control Plane MCP machen?

  • Workloads beheben — Frage, warum ein Workload ständig neu startet, und erhalte Diagnosehinweise mit cpln-Befehlen.
  • Workloads mit TLS bereitstellen — Richte über den Assistenten eine Domain mit automatischem TLS vor einem Workload ein.
  • Cloud-Zugriff ohne Zugangsdaten — Gewähre einem Workload Lesezugriff auf einen S3-Bucket ohne IAM-Schlüssel.
  • Zustandsbehaftete Datenbanken bereitstellen — Fordere eine produktionsreife Postgres-Datenbank mit HA-Failover und S3-Backups an.
  • Kubernetes-Konfigurationen migrieren — Wandle eine Kustomization-Datei in Control Plane um und wende sie nach Bestätigung an.
  • Mehrstufige Vorgänge verketten — Kombiniere Schritte mit then und and, damit der Assistent sie der Reihe nach ausführt.

Gehosteter MCP-Server

npx add-mcp 'https://mcp.cpln.io/mcp'

Installiert in Claude Code, Codex, Cursor und mehr

Dokumentation

Control Plane

Control Plane AI Plugin

Führe containerisierte Workloads über AWS, GCP, Azure, OCI und deine eigene Hardware hinweg über eine einzige API aus. Das Plugin lädt das Domänenwissen, die Produktionsleitplanken und die Live-MCP-Tools von Control Plane in Claude Code, Codex und Antigravity CLI, damit dein Assistent Workloads mit verifizierten cpln-Befehlen bereitstellen, Fehler beheben, absichern und migrieren kann.

Installation

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Aktualisiere mit /plugin marketplace update controlplane und anschließend /reload-plugins (Marktplätze von Drittanbietern werden nicht automatisch aktualisiert, sofern du dies nicht unter /plugin → Marketplaces aktivierst).

Alternativ kannst du das Plugin über Anthropics Community-Plugin-Marktplatz installieren, wo jeder Eintrag die Prüfung durch Anthropic bestanden hat:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install cpln@claude-community
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Starte Codex, öffne /plugins und installiere cpln. Der MCP-Handshake stellt die Kernregeln bereit. Lokale Installationen enthalten außerdem optionale Session-Hooks, die in Codex geprüft und freigegeben werden müssen, bevor sie ausgeführt werden.

Aktualisiere mit codex plugin marketplace upgrade controlplane und starte Codex anschließend neu.

Antigravity CLI

Installiere das Plugin mit Antigravity CLI (agy):

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generischer MCP-Client

Richte jeden anderen MCP-Client auf den gehosteten Server aus:

{
  "mcpServers": {
    "cpln": {
      "type": "http",
      "url": "https://mcp.cpln.io/mcp"
    }
  }
}

Die unveränderte URL stellt den standardmäßigen core-Werkzeugsatz bereit. Ein Client, der Tools bei Bedarf lädt, kann ?toolsets=full für alle Tools hinzufügen.

Authentifizierung

MCP verwendet OAuth 2.1 + PKCE. Melde dich an, damit der Assistent auf deine Control Plane-Organisationen zugreifen kann — du wählst aus, für welche Organisationen er tätig werden darf, und das Token ist auf diese Organisationen beschränkt; dies wird bei jedem Aufruf serverseitig durchgesetzt. Melde dich erneut an, um die Berechtigung zu ändern. Behandle den MCP-Zugriff wie Produktionszugriff auf die Organisationen, denen du Zugriff gewährst. So meldest du dich an:

  • Claude Code — /mcp, wähle cpln aus und melde dich an (oder claude mcp login cpln).
  • Codex — codex mcp login cpln.
  • Antigravity CLI — /mcp, wähle cpln aus und authentifiziere dich.

Umgebungsvariablen

Optional — nur für die cpln-CLI-Workflows, die manche Skills generieren (CI/CD, Terraform, Pulumi). Siehe .env.example.

VariableZweck
CPLN_TOKENService-Account-Token für cpln-CLI-Aufrufe (sensibel).
CPLN_ORGStandardorganisation.
CPLN_GVCStandard-GVC.
CPLN_PROFILELokales cpln-CLI-Profil.

Verwendung

Stelle Fragen in natürlicher Sprache — der Assistent leitet sie an den passenden Skill oder Agenten weiter:

  • „Behebe die Ursache dafür, dass mein payments-api-Workload in production ständig neu gestartet wird.“
  • „Schalte app.example.com mit automatischem TLS vor meinen web-Workload.“
  • „Gewähre meinem analytics-Workload schreibgeschützten Zugriff auf den S3-Bucket prod-event-logs, ohne Zugangsdaten — keine IAM-Schlüssel.“
  • „Stelle eine PostgreSQL-Produktionsdatenbank mit HA-Failover und S3-Backups bereit.“
  • „Konvertiere dieses kustomization.yaml zu Control Plane und wende es nach meiner Bestätigung auf staging an.“

Zwei Workflows haben in Claude Code außerdem Slash-Befehle — /cpln:troubleshoot WORKLOAD und /cpln:migrate-k8s FILE; in anderen Clients kannst du nach denselben Workflows anhand ihres Namens fragen.

Inhalt

  • Domänen-Skills zu CLI-Nutzung, Zugriffskontrolle, Autoscaling, Netzwerken, Observability, Migration, Vorlagen, zustandsbehaftetem Speicher und Sicherheit.
  • Zwei geführte Agenten: Fehlerbehebung bei Workloads und Migration von Kubernetes / Compose / Helm.
  • Ein kurzer, stets aktiver Regelsatz, den der Assistent in jeder Sitzung anwendet, sowie ein vollständiger Betriebsleitfaden, der bei Bedarf als Skill geladen wird.
  • Vorkonfigurierter Zugriff auf den gehosteten Control Plane-MCP-Server.

Sicherheit

  • MCP-Zugriff ist Produktionszugriff — beschränkt auf die Organisationen, denen du Zugriff gewährst, und deine eigenen RBAC-Berechtigungen.
  • Destruktive Aktionen (Ressourcen löschen, Volumes verkleinern oder löschen, Workloads ersetzen, Änderungen auf die Produktion anwenden) erfordern eine ausdrückliche Bestätigung.
  • Geheime Werte werden niemals über den Chat übertragen: Control Plane generiert Werte, die niemand kennen muss; der Benutzer gibt eigene Werte in der Console ein, und Tools geben nur Metadaten zu Geheimnissen zurück.
  • Das Plugin speichert keine Protokolle, Geheimnisse, Prompts oder Telemetriedaten; dein KI-Client und Modellanbieter verarbeiten Prompts gemäß ihren jeweiligen Richtlinien.

Melde Sicherheitslücken gemäß SECURITY.md.

Wohin Daten übertragen werden

Der einzige deklarierte Connector des Plugins ist der gehostete MCP-Server unter https://mcp.cpln.io/mcp, der ausschließlich auf die Organisationen zugreift, denen du bei der Anmeldung Zugriff gewährst, und dabei deine eigenen Berechtigungen verwendet.

Wenn eine Aufgabe es erfordert, führen die Skills außerdem die folgenden Tools auf deinem Rechner aus, jeweils mit deinen eigenen Zugangsdaten:

ToolSendet Daten an
cpln CLIDie Control Plane API (api.cpln.io), die Image-Registry deiner Organisation (ORG.registry.cpln.io) und den Metrik-Endpunkt (metrics.cpln.io), unter Verwendung deines CLI-Profils oder von CPLN_TOKEN
dockerDie Image-Registries, in die du Images überträgst und aus denen du sie abrufst
kubectl, helmDen Kubernetes-Cluster, auf den du sie ausrichtest, wenn du von ihm migrierst oder den Control Plane Kubernetes-Operator installierst
terraform, pulumiDie Control Plane API über den Control Plane-Provider
gcloud und andere Cloud-CLIsDein eigenes Cloud-Konto, wenn du ein privates Netzwerk verbindest oder eine Agent-VM erstellst
curlDeine eigene Domain, um sie nach der Einrichtung zu überprüfen

Das Plugin selbst speichert nichts. Ressourcen, App-Dateien und Einladungen, die der Assistent erstellt, werden in deiner Control Plane-Organisation gespeichert, bis du sie löschst; der Audit-Trail der Organisation protokolliert jede Änderung.

Weitere Informationen