Control Plane
officielDéployer et exploiter des charges de travail, des secrets et des réseaux sur AWS, GCP, Azure et les clouds privés.
Que pouvez-vous faire avec Control Plane MCP ?
- Dépanner les workloads — Demandez pourquoi un workload redémarre sans cesse et obtenez des conseils de diagnostic à l’aide des commandes
cpln. - Exposer des workloads avec TLS — Associez un domaine à un workload avec TLS automatique via l’assistant.
- Accéder au cloud sans identifiants — Accordez à un workload un accès en lecture à un bucket S3 sans clés IAM.
- Provisionner des bases de données avec état — Demandez un Postgres de production avec basculement HA et sauvegardes S3.
- Migrer des configurations Kubernetes — Convertissez un fichier kustomization pour Control Plane et appliquez-le après confirmation.
- Enchaîner des opérations en plusieurs étapes — Combinez des étapes avec
thenetandpour que l’assistant les exécute dans l’ordre.
Serveur MCP hébergé
npx add-mcp 'https://mcp.cpln.io/mcp'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
Plugin IA Control Plane
Exécutez des charges de travail conteneurisées sur AWS, GCP, Azure, OCI et votre propre matériel via une seule API. Il charge les connaissances métier de Control Plane, ses garde-fous de production et ses outils MCP en direct dans Claude Code, Codex et Antigravity CLI afin que votre assistant puisse déployer, dépanner, sécuriser et migrer des charges de travail à l’aide de commandes cpln vérifiées.
Installation
Claude Code
/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins
Mettez à jour avec /plugin marketplace update controlplane, puis /reload-plugins (les marketplaces tierces ne se mettent pas à jour automatiquement, sauf si vous activez cette option dans /plugin → Marketplaces).
Vous pouvez également installer le plugin depuis la marketplace communautaire d’Anthropic, où chaque extension a été examinée par Anthropic :
/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
Démarrez Codex, ouvrez /plugins et installez cpln. La négociation MCP fournit les règles de base. Les installations locales incluent également des hooks de session facultatifs, qui doivent être examinés et approuvés dans Codex avant leur exécution.
Mettez à jour avec codex plugin marketplace upgrade controlplane, puis redémarrez Codex.
Antigravity CLI
Installez le plugin avec Antigravity CLI (agy) :
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln
Client MCP générique
Configurez tout autre client MCP pour utiliser le serveur hébergé :
{
"mcpServers": {
"cpln": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}
L’URL seule fournit l’ensemble d’outils par défaut core. Un client qui charge les outils à la demande peut ajouter ?toolsets=full pour accéder à tous les outils.
Authentification
MCP utilise OAuth 2.1 + PKCE. Connectez-vous pour permettre à l’assistant d’agir sur vos organisations Control Plane — vous choisissez les organisations sur lesquelles il peut intervenir, et le jeton est limité à ces organisations et cette restriction est appliquée côté serveur à chaque appel. Reconnectez-vous pour modifier l’autorisation accordée. Considérez l’accès MCP comme un accès de production aux organisations que vous autorisez. Pour vous connecter :
- Claude Code —
/mcp, sélectionnezcpln, connectez-vous (ouclaude mcp login cpln). - Codex —
codex mcp login cpln. - Antigravity CLI —
/mcp, sélectionnezcpln, puis authentifiez-vous.
Variables d’environnement
Facultatives — uniquement pour les workflows CLI cpln générés par certaines compétences (CI/CD, Terraform, Pulumi). Voir .env.example.
| Variable | Rôle |
|---|---|
CPLN_TOKEN | Jeton de compte de service pour les appels CLI cpln (sensible). |
CPLN_ORG | Organisation par défaut. |
CPLN_GVC | GVC par défaut. |
CPLN_PROFILE | Profil CLI cpln local. |
Utilisation
Posez vos questions en langage naturel — l’assistant choisit la compétence ou l’agent approprié :
- « Diagnostique pourquoi ma charge de travail
payments-apidansproductionredémarre sans cesse. » - « Place
app.example.comdevant ma charge de travailwebavec TLS automatique. » - « Donne à ma charge de travail
analyticsun accès en lecture au bucket S3prod-event-logssans identifiants — pas de clés IAM. » - « Provisionne une base Postgres de production avec basculement HA et sauvegardes S3. »
- « Convertis ce
kustomization.yamlvers Control Plane et applique-le àstagingaprès ma confirmation. »
Deux workflows disposent également de commandes slash dans Claude Code — /cpln:troubleshoot WORKLOAD et /cpln:migrate-k8s FILE ; dans les autres clients, demandez ces mêmes workflows par leur nom.
Contenu
- Compétences métier couvrant l’utilisation de la CLI, le contrôle d’accès, la mise à l’échelle automatique, la mise en réseau, l’observabilité, la migration, les modèles, le stockage avec état et la sécurité.
- Deux agents guidés : dépannage des charges de travail et migration Kubernetes / Compose / Helm.
- Un ensemble concis de règles toujours actives, appliquées par l’assistant à chaque session, avec le guide d’utilisation complet disponible sous forme de compétence à la demande.
- Accès préconfiguré au serveur MCP hébergé de Control Plane.
Sécurité
- L’accès MCP est un accès de production — limité aux organisations que vous autorisez et soumis à vos propres règles RBAC.
- Les actions destructrices (suppression de ressources, réduction ou suppression de volumes, remplacement de charges de travail, application en production) nécessitent une confirmation explicite.
- Les valeurs secrètes ne transitent jamais par le chat : Control Plane génère les valeurs que personne n’a besoin de connaître, l’utilisateur saisit ses propres valeurs dans la Console et les outils ne renvoient que les métadonnées des secrets.
- Le plugin ne stocke aucun journal, secret, prompt ni donnée de télémétrie ; votre client IA et votre fournisseur de modèles traitent les prompts selon leurs propres politiques.
Signalez les vulnérabilités conformément à SECURITY.md.
Où vont les données
Le seul connecteur déclaré du plugin est le serveur MCP hébergé à l’adresse https://mcp.cpln.io/mcp, qui agit uniquement sur les organisations que vous autorisez lors de la connexion, avec vos propres permissions.
Lorsque la tâche le nécessite, les compétences exécutent également ces outils sur votre machine, chacun avec vos propres identifiants :
| Outil | Envoie des données à |
|---|---|
CLI cpln | L’API Control Plane (api.cpln.io), le registre d’images de votre organisation (ORG.registry.cpln.io) et le point de terminaison des métriques (metrics.cpln.io), à l’aide de votre profil CLI ou de CPLN_TOKEN |
docker | Les registres d’images vers lesquels vous envoyez des images et depuis lesquels vous en récupérez |
kubectl, helm | Le cluster Kubernetes que vous leur indiquez, lors d’une migration depuis celui-ci ou de l’installation de l’opérateur Kubernetes Control Plane |
terraform, pulumi | L’API Control Plane, via le fournisseur Control Plane |
gcloud et autres CLI cloud | Votre propre compte cloud, lors de la connexion d’un réseau privé ou de la création d’une VM d’agent |
curl | Votre propre domaine, pour le vérifier après la configuration |
Le plugin lui-même ne stocke rien. Les ressources, fichiers d’application et invitations créés par l’assistant sont stockés dans votre organisation Control Plane jusqu’à leur suppression, et le journal d’audit de l’organisation consigne chaque modification.
En savoir plus
- Contribution : CONTRIBUTING.md
- Documentation : docs.controlplane.com · Assistance :
support@controlplane.comou Slack - Licence : MIT — voir LICENSE