Serveur MCP Control Plane
Commit 29 oct. 2026Permet aux assistants IA de déployer, dépanner, sécuriser et migrer des charges de travail conteneurisées sur AWS, GCP, Azure et OCI à l'aide de commandes vérifiées.
Aussi connu sous controlplane-com/ai-plugin, ai-plugin
- Étoiles
- 11
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.0.2
- Dernier commit
- 29 oct. 2026
- Licence
- MIT
Qu'est-ce que Control Plane MCP ?
Control Plane est un serveur MCP. Permet aux assistants IA de déployer, dépanner, sécuriser et migrer des charges de travail conteneurisées sur AWS, GCP, Azure et OCI à l'aide de commandes vérifiées.
Résumé généré à partir du README du projet
À propos du MCP server Control Plane
Control Plane fournit un MCP server qui permet aux assistants IA de gérer des charges de travail conteneurisées sur AWS, GCP, Azure, OCI et sur du matériel local. Il s'intègre à Claude Code, Codex et Antigravity CLI pour exécuter des commandes cpln vérifiées afin de déployer, sécuriser et migrer des infrastructures. Les utilisateurs peuvent se connecter via un serveur HTTP hébergé ou installer le plugin directement dans leur environnement de développement préféré.
La sécurité est gérée via OAuth 2.1 et PKCE, garantissant que l'assistant n'opère que dans les organisations spécifiques que vous avez autorisées. Le système utilise des garde-fous de niveau production où les actions destructives nécessitent une confirmation explicite de l'utilisateur. Pour protéger les informations sensibles, les valeurs secrètes ne sont jamais transmises via le chat ; à la place, le serveur génère des valeurs ou nécessite une saisie manuelle dans la console Control Plane.
Les développeurs peuvent utiliser des Agent Skills spécialisées couvrant le réseau, l'autoscaling et l'observabilité. Le serveur inclut également des agents guidés spécifiquement conçus pour le dépannage de charges de travail et la migration de configurations Kubernetes, Compose ou Helm. Bien que les outils principaux soient hébergés, certains workflows peuvent déclencher des outils locaux comme kubectl, terraform ou pulumi en utilisant vos identifiants existants.
Ce que vous pouvez faire avec
- 1Dépanner des charges de travail défaillantesDemandez à l'assistant d'identifier pourquoi un service spécifique dans un environnement de production redémarre de manière répétée.
- 2Migrer des configurations existantesConvertissez des fichiers Kubernetes ou Helm en ressources Control Plane et appliquez-les à un environnement de staging.
- 3Configurer un réseau sécuriséConfigurez un nom de domaine devant une charge de travail avec un chiffrement TLS automatique.
- 4Gérer les permissions cloudAccordez à une charge de travail un accès en lecture à un bucket S3 sans utiliser de clés IAM.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Control Plane MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Control Plane MCP dans Claude Code
$ claude mcp add --transport http ai-plugin https://mcp.cpln.io/mcpInstaller Control Plane MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://mcp.cpln.io/mcp"
}
}
}Installer Control Plane MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"ai-plugin": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}Installer Control Plane MCP dans VS Code CLI
$ code --add-mcp '{"name":"ai-plugin","type":"http","url":"https://mcp.cpln.io/mcp"}'Installer Control Plane MCP dans Codex
$ codex mcp add ai-plugin --url https://mcp.cpln.io/mcpInstaller Control Plane MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.ai-plugin] url = "https://mcp.cpln.io/mcp"
Installer Control Plane MCP dans Gemini CLI
$ gemini mcp add -s user --transport http ai-plugin https://mcp.cpln.io/mcpInstaller Control Plane MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://mcp.cpln.io/mcp",
"type": "http"
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblecontrolplane-com/ai-plugin is public and reachablegithub.com/controlplane-com/ai-plugin ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-29github.com/controlplane-com/ai-plugin ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur GitHubControl Plane AI Plugin
Run containerized workloads across AWS, GCP, Azure, OCI, and your own hardware under one API. It loads Control Plane's domain knowledge, production guardrails, and live MCP tools into Claude Code, Codex, and Antigravity CLI so your assistant can deploy, troubleshoot, secure, and migrate workloads with verified cpln commands.
Installation
Claude Code
/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins
Update with /plugin marketplace update controlplane then /reload-plugins (third-party marketplaces don't auto-update unless you enable it in /plugin → Marketplaces).
Alternatively, install from Anthropic's community plugin marketplace, where every listing has passed Anthropic's review:
/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
Start Codex, open /plugins, and install cpln. The MCP handshake supplies the core rules. Local installations also include optional session hooks, which must be reviewed and trusted in Codex before they run.
Update with codex plugin marketplace upgrade controlplane, then restart Codex.
Antigravity CLI
Install the plugin with Antigravity CLI (agy):
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln
Generic MCP client
Point any other MCP client at the hosted server:
{
"mcpServers": {
"cpln": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}
The bare URL serves the default core tool set. A client that loads tools on demand can add ?toolsets=full for every tool.
Authentication
MCP uses OAuth 2.1 + PKCE. Sign in to let the assistant act on your Control Plane organizations — you choose which orgs it may operate on, and the token is scoped to those orgs and enforced server-side on every call. Sign in again to change the grant. Treat MCP access as production access to the orgs you grant. How to sign in:
- Claude Code —
/mcp, selectcpln, sign in (orclaude mcp login cpln). - Codex —
codex mcp login cpln. - Antigravity CLI —
/mcp, selectcpln, authenticate.
Environment variables
Optional — only for the cpln CLI workflows some skills generate (CI/CD, Terraform, Pulumi). See .env.example.
| Variable | Purpose |
|---|---|
CPLN_TOKEN |
Service-account token for cpln CLI calls (sensitive). |
CPLN_ORG |
Default organization. |
CPLN_GVC |
Default GVC. |
CPLN_PROFILE |
Local cpln CLI profile. |
Usage
Ask in natural language — the assistant routes to the right skill or agent:
- "Troubleshoot why my
payments-apiworkload inproductionkeeps restarting." - "Put
app.example.comin front of mywebworkload with auto-TLS." - "Give my
analyticsworkload credential-free read access to S3 bucketprod-event-logs— no IAM keys." - "Provision a production Postgres with HA failover and S3 backups."
- "Convert this
kustomization.yamlto Control Plane and apply it tostagingafter I confirm."
Two workflows also have slash commands in Claude Code — /cpln:troubleshoot WORKLOAD and /cpln:migrate-k8s FILE; in other clients, ask for the same workflows by name.
What's included
- Domain skills across CLI usage, access control, autoscaling, networking, observability, migration, templates, stateful storage, and security.
- Two guided agents: workload troubleshooting and Kubernetes / Compose / Helm migration.
- A short always-on rule set the assistant applies in every session, with the full operating guide as a skill read on demand.
- Pre-configured access to the hosted Control Plane MCP server.
Security
- MCP access is production access — scoped to the orgs you grant and your own RBAC.
- Destructive actions (deleting resources, shrinking/deleting volumes, replacing workloads, applying to production) require explicit confirmation.
- Secret values never pass through the chat: Control Plane generates the values nobody needs to know, the user types their own values into the Console, and tools return secret metadata only.
- The plugin stores no logs, secrets, prompts, or telemetry; your AI client and model provider process prompts per their own policies.
Report vulnerabilities per SECURITY.md.
Where data goes
The plugin's one declared connector is the hosted MCP server at https://mcp.cpln.io/mcp, which acts only on the orgs you grant when you sign in, with your own permissions.
When a task needs it, the skills also run these tools on your machine, each with your own credentials:
| Tool | Sends data to |
|---|---|
cpln CLI |
The Control Plane API (api.cpln.io), your org's image registry (ORG.registry.cpln.io), and the metrics endpoint (metrics.cpln.io), using your CLI profile or CPLN_TOKEN |
docker |
The image registries you push to and pull from |
kubectl, helm |
The Kubernetes cluster you point them at, when migrating from it or installing the Control Plane Kubernetes operator |
terraform, pulumi |
The Control Plane API, through the Control Plane provider |
gcloud and other cloud CLIs |
Your own cloud account, when connecting a private network or creating an agent VM |
curl |
Your own domain, to check it after setup |
The plugin itself stores nothing. Resources, app files, and invitations the assistant creates are stored in your Control Plane org until you delete them, and the org's audit trail records each change.
More
- Contributing: CONTRIBUTING.md
- Docs: docs.controlplane.com · Support:
support@controlplane.comor Slack - License: MIT — see LICENSE
Questions sur Control Plane MCP
Comment ajouter Control Plane MCP à Claude Code ?
Exécutez claude mcp add --transport http ai-plugin https://mcp.cpln.io/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Control Plane MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment s'authentifier auprès du MCP server Control Plane ?
Le serveur utilise OAuth 2.1 + PKCE. Vous pouvez vous connecter via Claude Code, Codex ou Antigravity CLI pour accorder à l'assistant l'accès à des organisations spécifiques.
L'assistant IA peut-il effectuer des actions destructives ?
Oui, mais les actions destructives, telles que la suppression de ressources ou de charges de travail, nécessitent une confirmation explicite de l'utilisateur.
Quel type de charges de travail puis-je gérer ?
Vous pouvez exécuter des charges de travail conteneurisées sur AWS, GCP, Azure, OCI ainsi que sur votre propre matériel.