Control Plane
oficialImplantar 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
theneandpara 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
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, selecionecplne entre (ouclaude mcp login cpln). - Codex —
codex mcp login cpln. - Antigravity CLI —
/mcp, selecionecplne 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ável | Finalidade |
|---|---|
CPLN_TOKEN | Token de conta de serviço para chamadas da CLI cpln (sensível). |
CPLN_ORG | Organização padrão. |
CPLN_GVC | GVC padrão. |
CPLN_PROFILE | Perfil 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-apiemproductionreiniciar continuamente." - "Coloque
app.example.comna frente da minha carga de trabalhowebcom TLS automático." - "Conceda à minha carga de trabalho
analyticsacesso de leitura ao bucket S3prod-event-logssem credenciais — sem chaves do IAM." - "Provisione um Postgres de produção com failover de alta disponibilidade e backups no S3."
- "Converta este
kustomization.yamlpara o Control Plane e aplique-o astagingdepois 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:
| Ferramenta | Envia dados para |
|---|---|
CLI cpln | A 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 |
docker | Os registros de imagens dos quais você envia e baixa imagens |
kubectl, helm | O cluster Kubernetes para o qual você os direciona, ao migrar dele ou instalar o operador Kubernetes do Control Plane |
terraform, pulumi | A API do Control Plane, por meio do provedor do Control Plane |
gcloud e outras CLIs de nuvem | Sua própria conta de nuvem, ao conectar uma rede privada ou criar uma VM de agente |
curl | Seu 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
- Contribuição: CONTRIBUTING.md
- Documentação: docs.controlplane.com · Suporte:
support@controlplane.comou Slack - Licença: MIT — consulte LICENSE