Control Plane

oficial

Implantar e operar cargas de trabalho, segredos e redes em AWS, GCP, Azure e nuvens

O que você pode fazer com Control Plane MCP?

  • Solucionar problemas de workloads — Pergunte por que um workload continua reiniciando e obtenha orientações de diagnóstico usando comandos cpln.
  • Expor workloads com TLS — Configure um domínio na frente de um workload com TLS automático pelo assistente.
  • Acesso à nuvem sem credenciais — Conceda a um workload acesso de leitura a um bucket S3 sem chaves do IAM.
  • Provisionar bancos de dados com estado — Solicite um Postgres de produção com failover de alta disponibilidade e backups no S3.
  • Migrar configurações do Kubernetes — Converta um arquivo de kustomization para Control Plane e aplique-o após a confirmação.
  • Encadear operações de várias etapas — Combine etapas com then e and para que o assistente as execute em sequência.

Servidor MCP hospedado

npx add-mcp 'https://mcp.cpln.io/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Control Plane

Plugin de IA do Control Plane

Execute cargas de trabalho em contêineres na AWS, GCP, Azure, OCI e no seu próprio hardware usando uma única API. Ele carrega o conhecimento de domínio, as proteções de produção e as ferramentas MCP em tempo real do Control Plane no Claude Code, Codex e Antigravity CLI para que seu assistente possa implantar, solucionar problemas, proteger e migrar cargas de trabalho com comandos cpln verificados.

Instalação

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Atualize com /plugin marketplace update controlplane e depois /reload-plugins (marketplaces de terceiros não são atualizados automaticamente, a menos que você habilite essa opção em /plugin → Marketplaces).

Como alternativa, instale pelo marketplace de plugins da comunidade da Anthropic, onde todos os itens passaram pela análise da 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

Inicie o Codex, abra /plugins e instale cpln. A negociação MCP fornece as regras principais. As instalações locais também incluem hooks de sessão opcionais, que devem ser analisados e autorizados no Codex antes de serem executados.

Atualize com codex plugin marketplace upgrade controlplane e reinicie o Codex.

Antigravity CLI

Instale o plugin com o Antigravity CLI (agy):

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Cliente MCP genérico

Aponte qualquer outro cliente MCP para o servidor hospedado:

{
  "mcpServers": {
    "cpln": {
      "type": "http",
      "url": "https://mcp.cpln.io/mcp"
    }
  }
}

A URL sem formatação disponibiliza o conjunto padrão de ferramentas core. Um cliente que carrega ferramentas sob demanda pode adicionar ?toolsets=full para acessar todas as ferramentas.

Autenticação

O MCP usa OAuth 2.1 + PKCE. Entre para permitir que o assistente atue nas organizações do Control Plane — você escolhe em quais organizações ele pode operar, e o token fica restrito a essas organizações, com essa restrição aplicada no servidor a cada chamada. Entre novamente para alterar a autorização. Trate o acesso MCP como acesso de produção às organizações que você autorizar. Como entrar:

  • Claude Code — /mcp, selecione cpln e entre (ou claude mcp login cpln).
  • Codex — codex mcp login cpln.
  • Antigravity CLI — /mcp, selecione cpln e autentique-se.

Variáveis de ambiente

Opcional — necessário apenas para os fluxos de trabalho da CLI cpln que algumas skills geram (CI/CD, Terraform, Pulumi). Consulte .env.example.

VariávelFinalidade
CPLN_TOKENToken de conta de serviço para chamadas da CLI cpln (sensível).
CPLN_ORGOrganização padrão.
CPLN_GVCGVC padrão.
CPLN_PROFILEPerfil local da CLI cpln.

Uso

Faça perguntas em linguagem natural — o assistente encaminha a solicitação para a skill ou o agente adequado:

  • "Solucione o problema que faz minha carga de trabalho payments-api em production reiniciar continuamente."
  • "Coloque app.example.com na frente da minha carga de trabalho web com TLS automático."
  • "Conceda à minha carga de trabalho analytics acesso de leitura ao bucket S3 prod-event-logs sem credenciais — sem chaves do IAM."
  • "Provisione um Postgres de produção com failover de alta disponibilidade e backups no S3."
  • "Converta este kustomization.yaml para o Control Plane e aplique-o a staging depois que eu confirmar."

Dois fluxos de trabalho também têm comandos de barra no Claude Code — /cpln:troubleshoot WORKLOAD e /cpln:migrate-k8s FILE; em outros clientes, peça os mesmos fluxos de trabalho pelo nome.

O que está incluído

  • Skills de domínio para uso da CLI, controle de acesso, escalonamento automático, redes, observabilidade, migração, templates, armazenamento com estado e segurança.
  • Dois agentes guiados: solução de problemas de cargas de trabalho e migração de Kubernetes / Compose / Helm.
  • Um conjunto curto de regras sempre ativas, aplicado pelo assistente em todas as sessões, com o guia operacional completo disponível como uma skill carregada sob demanda.
  • Acesso pré-configurado ao servidor MCP hospedado do Control Plane.

Segurança

  • O acesso MCP é acesso de produção — restrito às organizações que você autorizar e às suas próprias permissões de RBAC.
  • Ações destrutivas (excluir recursos, reduzir ou excluir volumes, substituir cargas de trabalho, aplicar alterações em produção) exigem confirmação explícita.
  • Os valores secretos nunca passam pelo chat: o Control Plane gera valores que ninguém precisa conhecer, o usuário insere seus próprios valores no Console e as ferramentas retornam apenas metadados dos segredos.
  • O plugin não armazena logs, segredos, prompts nem telemetria; seu cliente de IA e o provedor do modelo processam os prompts de acordo com as próprias políticas.

Reporte vulnerabilidades conforme indicado em SECURITY.md.

Para onde os dados vão

O único conector declarado do plugin é o servidor MCP hospedado em https://mcp.cpln.io/mcp, que atua somente nas organizações que você autoriza ao entrar, usando suas próprias permissões.

Quando necessário para uma tarefa, as skills também executam estas ferramentas na sua máquina, cada uma com suas próprias credenciais:

FerramentaEnvia dados para
CLI cplnA API do Control Plane (api.cpln.io), o registro de imagens da sua organização (ORG.registry.cpln.io) e o endpoint de métricas (metrics.cpln.io), usando seu perfil da CLI ou CPLN_TOKEN
dockerOs registros de imagens dos quais você envia e baixa imagens
kubectl, helmO cluster Kubernetes para o qual você os direciona, ao migrar dele ou instalar o operador Kubernetes do Control Plane
terraform, pulumiA API do Control Plane, por meio do provedor do Control Plane
gcloud e outras CLIs de nuvemSua própria conta de nuvem, ao conectar uma rede privada ou criar uma VM de agente
curlSeu próprio domínio, para verificá-lo após a configuração

O plugin em si não armazena nada. Os recursos, arquivos de aplicativos e convites criados pelo assistente ficam armazenados na sua organização do Control Plane até que você os exclua, e o registro de auditoria da organização registra cada alteração.

Mais informações