MCP server de Control Plane
Commit 29 oct 2026Permite a los asistentes de IA desplegar, solucionar problemas, asegurar y migrar cargas de trabajo contenedorizadas en AWS, GCP, Azure y OCI mediante comandos verificados.
También conocido como controlplane-com/ai-plugin, mcp
- Stars
- 11
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.0
- Último commit
- 29 oct 2026
- Licencia
- MIT
¿Qué es Control Plane MCP?
Permite a los asistentes de IA desplegar, solucionar problemas, asegurar y migrar cargas de trabajo contenedorizadas en AWS, GCP, Azure y OCI mediante comandos verificados.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Control Plane
Gestionar cargas de trabajo contenedorizadas en AWS, GCP, Azure y OCI se convierte en una tarea de lenguaje natural para los ingenieros de DevOps al usar este MCP server. Integra conocimiento de dominio y protecciones de producción en clientes de IA como Claude Code, Codex y Antigravity CLI para ejecutar comandos cpln verificados. Los usuarios pueden desplegar, solucionar problemas, asegurar y migrar cargas de trabajo interactuando con agentes guiados o Agent Skills específicas.
La configuración implica instalar el plugin mediante comandos del marketplace o conectar un cliente MCP genérico al servidor alojado. La autenticación utiliza OAuth 2.1 con PKCE, lo que te permite limitar el acceso del asistente a organizaciones específicas de Control Plane. Aunque el servidor alojado proporciona las herramientas principales, los clientes pueden solicitar el conjunto completo de herramientas añadiendo parámetros específicos a la URL de conexión.
La seguridad se mantiene mediante la confirmación explícita para acciones destructivas y una política en la que los valores de los secretos nunca pasan por la interfaz de chat. El servidor actúa como un puente hacia tu infraestructura existente, utilizando herramientas como kubectl, helm, terraform y pulumi para gestionar recursos respetando tus permisos de organización y RBAC actuales.
Qué puedes hacer con él
- 1Solucionar problemas en cargas de trabajo fallidasPide al asistente que diagnostique por qué un servicio específico en un entorno de producción se está reiniciando repetidamente.
- 2Migrar configuraciones existentesConvierte archivos de Kubernetes o Compose en configuraciones de Control Plane y aplícalas a un entorno de staging.
- 3Configurar redes segurasConfigura un nombre de dominio frente a una carga de trabajo con cifrado TLS automático.
- 4Provisionar infraestructura gestionadaSolicita la creación de una base de datos Postgres de alta disponibilidad con copias de seguridad automatizadas e integración con S3.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Control Plane MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Control Plane MCP en Claude Code
$ claude mcp add --transport http mcp https://mcp.cpln.io/mcpInstalar Control Plane MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.cpln.io/mcp"
}
}
}Instalar Control Plane MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}Instalar Control Plane MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.cpln.io/mcp"}'Instalar Control Plane MCP en Codex
$ codex mcp add mcp --url https://mcp.cpln.io/mcpInstalar Control Plane MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.cpln.io/mcp"
Instalar Control Plane MCP en Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.cpln.io/mcpInstalar Control Plane MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.cpln.io/mcp",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblecontrolplane-com/ai-plugin is public and reachablegithub.com/controlplane-com/ai-plugin ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-12github.com/controlplane-com/ai-plugin ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en 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
Preguntas sobre Control Plane MCP
¿Cómo agrego Control Plane MCP a Claude Code?
Ejecuta claude mcp add --transport http mcp https://mcp.cpln.io/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Control Plane MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo me autentico con el Control Plane MCP?
El servidor utiliza OAuth 2.1 + PKCE. Inicias sesión a través de tu cliente específico (Claude Code, Codex o Antigravity CLI) para otorgar al asistente acceso a organizaciones específicas.
¿Puede el asistente de IA realizar acciones destructivas?
Sí, pero las acciones destructivas, como eliminar recursos o cargas de trabajo, requieren tu confirmación explícita.
¿El plugin almacena mis secretos o el historial de chat?
No, el plugin no almacena logs, secretos, prompts ni telemetría; tu cliente de IA y tu proveedor de modelos gestionan esto según sus propias políticas.
¿Qué tipo de cargas de trabajo puedo gestionar?
Puedes ejecutar cargas de trabajo contenedorizadas en varios proveedores de nube, incluyendo AWS, GCP, Azure, OCI y tu propio hardware.