Control Plane
oficialImplementar y operar cargas de trabajo, secretos y redes en AWS, GCP, Azure y nubes privadas.
¿Qué puedes hacer con Control Plane MCP?
- Solucionar problemas de cargas de trabajo — Pregunta por qué una carga de trabajo se reinicia continuamente y obtén orientación para diagnosticarla mediante comandos de
cpln. - Exponer cargas de trabajo con TLS — Asigna un dominio a una carga de trabajo con TLS automático a través del asistente.
- Acceso a la nube sin credenciales — Concede a una carga de trabajo acceso de lectura a un bucket de S3 sin claves de IAM.
- Aprovisionar bases de datos con estado — Solicita una base de datos Postgres de producción con conmutación por error de alta disponibilidad y copias de seguridad en S3.
- Migrar configuraciones de Kubernetes — Convierte un archivo de kustomization a Control Plane y aplícalo tras la confirmación.
- Encadenar operaciones de varios pasos — Combina pasos con
thenyandpara que el asistente los ejecute en secuencia.
Servidor MCP alojado
npx add-mcp 'https://mcp.cpln.io/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Plugin de IA de Control Plane
Ejecuta cargas de trabajo en contenedores en AWS, GCP, Azure, OCI y tu propio hardware mediante una sola API. Carga el conocimiento del dominio de Control Plane, las protecciones para producción y las herramientas MCP en tiempo real en Claude Code, Codex y Antigravity CLI para que tu asistente pueda implementar, solucionar problemas, proteger y migrar cargas de trabajo con comandos cpln verificados.
Instalación
Claude Code
/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins
Actualiza con /plugin marketplace update controlplane y luego /reload-plugins (los marketplaces de terceros no se actualizan automáticamente a menos que lo habilites en /plugin → Marketplaces).
Como alternativa, instala desde el marketplace de plugins comunitarios de Anthropic, donde todos los listados han superado la revisión de 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
Inicia Codex, abre /plugins e instala cpln. El protocolo de enlace MCP proporciona las reglas principales. Las instalaciones locales también incluyen hooks de sesión opcionales, que deben revisarse y autorizarse en Codex antes de ejecutarse.
Actualiza con codex plugin marketplace upgrade controlplane y luego reinicia Codex.
Antigravity CLI
Instala el plugin con Antigravity CLI (agy):
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln
Cliente MCP genérico
Conecta cualquier otro cliente MCP al servidor alojado:
{
"mcpServers": {
"cpln": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}
La URL sin formato proporciona el conjunto de herramientas predeterminado core. Un cliente que carga herramientas bajo demanda puede añadir ?toolsets=full para acceder a todas las herramientas.
Autenticación
MCP usa OAuth 2.1 + PKCE. Inicia sesión para permitir que el asistente actúe en tus organizaciones de Control Plane: tú eliges en cuáles puede operar, y el token queda limitado a esas organizaciones y se aplica en el servidor en cada llamada. Vuelve a iniciar sesión para cambiar la autorización. Trata el acceso MCP como acceso de producción a las organizaciones que autorizas. Cómo iniciar sesión:
- Claude Code —
/mcp, seleccionacplne inicia sesión (oclaude mcp login cpln). - Codex —
codex mcp login cpln. - Antigravity CLI —
/mcp, seleccionacplny autentícate.
Variables de entorno
Opcionales: solo para los flujos de trabajo de CLI cpln que generan algunas habilidades (CI/CD, Terraform, Pulumi). Consulta .env.example.
| Variable | Propósito |
|---|---|
CPLN_TOKEN | Token de cuenta de servicio para llamadas de CLI cpln (sensible). |
CPLN_ORG | Organización predeterminada. |
CPLN_GVC | GVC predeterminado. |
CPLN_PROFILE | Perfil local de CLI cpln. |
Uso
Pide lo que necesites en lenguaje natural: el asistente recurrirá a la habilidad o al agente adecuado:
- "Soluciona por qué mi carga de trabajo
payments-apienproductionse reinicia continuamente." - "Coloca
app.example.comdelante de mi carga de trabajowebcon TLS automático." - "Dale a mi carga de trabajo
analyticsacceso de solo lectura al bucket S3prod-event-logssin credenciales; sin claves de IAM." - "Aprovisiona una instancia de Postgres de producción con conmutación por error de alta disponibilidad y copias de seguridad en S3."
- "Convierte este
kustomization.yamla Control Plane y aplícalo astagingcuando lo confirme."
Dos flujos de trabajo también tienen comandos de barra en Claude Code: /cpln:troubleshoot WORKLOAD y /cpln:migrate-k8s FILE; en otros clientes, pide esos mismos flujos por su nombre.
Qué incluye
- Habilidades de dominio sobre el uso de CLI, control de acceso, escalado automático, redes, observabilidad, migración, plantillas, almacenamiento con estado y seguridad.
- Dos agentes guiados: solución de problemas de cargas de trabajo y migración de Kubernetes / Compose / Helm.
- Un conjunto breve de reglas siempre activas que el asistente aplica en cada sesión, con la guía operativa completa disponible como habilidad bajo demanda.
- Acceso preconfigurado al servidor MCP alojado de Control Plane.
Seguridad
- El acceso MCP es acceso de producción: está limitado a las organizaciones que autorizas y sujeto a tus propios permisos de RBAC.
- Las acciones destructivas (eliminar recursos, reducir o eliminar volúmenes, reemplazar cargas de trabajo, aplicar cambios en producción) requieren confirmación explícita.
- Los valores secretos nunca pasan por el chat: Control Plane genera valores que nadie necesita conocer, el usuario introduce sus propios valores en la consola y las herramientas solo devuelven metadatos de secretos.
- El plugin no almacena registros, secretos, prompts ni telemetría; tu cliente de IA y el proveedor del modelo procesan los prompts según sus propias políticas.
Informa de vulnerabilidades según las indicaciones de SECURITY.md.
Dónde van los datos
El único conector declarado del plugin es el servidor MCP alojado en https://mcp.cpln.io/mcp, que solo actúa en las organizaciones que autorizas al iniciar sesión y con tus propios permisos.
Cuando una tarea lo requiere, las habilidades también ejecutan estas herramientas en tu máquina, cada una con tus propias credenciales:
| Herramienta | Envía datos a |
|---|---|
CLI cpln | La API de Control Plane (api.cpln.io), el registro de imágenes de tu organización (ORG.registry.cpln.io) y el endpoint de métricas (metrics.cpln.io), usando tu perfil de CLI o CPLN_TOKEN |
docker | Los registros de imágenes desde los que extraes imágenes y a los que las envías |
kubectl, helm | El clúster de Kubernetes que indiques, al migrar desde él o instalar el operador de Kubernetes de Control Plane |
terraform, pulumi | La API de Control Plane, a través del proveedor de Control Plane |
gcloud y otras CLI de nube | Tu propia cuenta de nube, al conectar una red privada o crear una VM de agente |
curl | Tu propio dominio, para comprobarlo después de la configuración |
El plugin no almacena nada. Los recursos, archivos de aplicaciones e invitaciones que crea el asistente se guardan en tu organización de Control Plane hasta que los elimines, y el registro de auditoría de la organización registra cada cambio.
Más información
- Contribuciones: CONTRIBUTING.md
- Documentación: docs.controlplane.com · Soporte:
support@controlplane.como Slack - Licencia: MIT — consulta LICENSE