Control Plane

officiel

Dé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 then et and pour 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

Control Plane

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électionnez cpln, connectez-vous (ou claude mcp login cpln).
  • Codex — codex mcp login cpln.
  • Antigravity CLI — /mcp, sélectionnez cpln, 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.

VariableRôle
CPLN_TOKENJeton de compte de service pour les appels CLI cpln (sensible).
CPLN_ORGOrganisation par défaut.
CPLN_GVCGVC par défaut.
CPLN_PROFILEProfil 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-api dans production redémarre sans cesse. »
  • « Place app.example.com devant ma charge de travail web avec TLS automatique. »
  • « Donne à ma charge de travail analytics un accès en lecture au bucket S3 prod-event-logs sans identifiants — pas de clés IAM. »
  • « Provisionne une base Postgres de production avec basculement HA et sauvegardes S3. »
  • « Convertis ce kustomization.yaml vers Control Plane et applique-le à staging aprè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 :

OutilEnvoie des données à
CLI cplnL’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
dockerLes registres d’images vers lesquels vous envoyez des images et depuis lesquels vous en récupérez
kubectl, helmLe 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, pulumiL’API Control Plane, via le fournisseur Control Plane
gcloud et autres CLI cloudVotre propre compte cloud, lors de la connexion d’un réseau privé ou de la création d’une VM d’agent
curlVotre 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