Control Plane

oficial

Implementar 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 then y and para 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

Control Plane

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, selecciona cpln e inicia sesión (o claude mcp login cpln).
  • Codex — codex mcp login cpln.
  • Antigravity CLI — /mcp, selecciona cpln y 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.

VariablePropósito
CPLN_TOKENToken de cuenta de servicio para llamadas de CLI cpln (sensible).
CPLN_ORGOrganización predeterminada.
CPLN_GVCGVC predeterminado.
CPLN_PROFILEPerfil 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-api en production se reinicia continuamente."
  • "Coloca app.example.com delante de mi carga de trabajo web con TLS automático."
  • "Dale a mi carga de trabajo analytics acceso de solo lectura al bucket S3 prod-event-logs sin 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.yaml a Control Plane y aplícalo a staging cuando 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:

HerramientaEnvía datos a
CLI cplnLa 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
dockerLos registros de imágenes desde los que extraes imágenes y a los que las envías
kubectl, helmEl clúster de Kubernetes que indiques, al migrar desde él o instalar el operador de Kubernetes de Control Plane
terraform, pulumiLa API de Control Plane, a través del proveedor de Control Plane
gcloud y otras CLI de nubeTu propia cuenta de nube, al conectar una red privada o crear una VM de agente
curlTu 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