Control Plane
offiziellWorkloads, 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
thenundand, 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 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ählecplnaus und melde dich an (oderclaude mcp login cpln). - Codex —
codex mcp login cpln. - Antigravity CLI —
/mcp, wählecplnaus und authentifiziere dich.
Umgebungsvariablen
Optional — nur für die cpln-CLI-Workflows, die manche Skills generieren (CI/CD, Terraform, Pulumi). Siehe .env.example.
| Variable | Zweck |
|---|---|
CPLN_TOKEN | Service-Account-Token für cpln-CLI-Aufrufe (sensibel). |
CPLN_ORG | Standardorganisation. |
CPLN_GVC | Standard-GVC. |
CPLN_PROFILE | Lokales 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 inproductionständig neu gestartet wird.“ - „Schalte
app.example.commit automatischem TLS vor meinenweb-Workload.“ - „Gewähre meinem
analytics-Workload schreibgeschützten Zugriff auf den S3-Bucketprod-event-logs, ohne Zugangsdaten — keine IAM-Schlüssel.“ - „Stelle eine PostgreSQL-Produktionsdatenbank mit HA-Failover und S3-Backups bereit.“
- „Konvertiere dieses
kustomization.yamlzu Control Plane und wende es nach meiner Bestätigung aufstagingan.“
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:
| Tool | Sendet Daten an |
|---|---|
cpln CLI | Die 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 |
docker | Die Image-Registries, in die du Images überträgst und aus denen du sie abrufst |
kubectl, helm | Den Kubernetes-Cluster, auf den du sie ausrichtest, wenn du von ihm migrierst oder den Control Plane Kubernetes-Operator installierst |
terraform, pulumi | Die Control Plane API über den Control Plane-Provider |
gcloud und andere Cloud-CLIs | Dein eigenes Cloud-Konto, wenn du ein privates Netzwerk verbindest oder eine Agent-VM erstellst |
curl | Deine 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
- Mitwirken: CONTRIBUTING.md
- Dokumentation: docs.controlplane.com · Support:
support@controlplane.comoder Slack - Lizenz: MIT — siehe LICENSE