Control Plane

官方

跨AWS、GCP、Azure及私有云部署和运维工作负载、密钥及网络。

你可以用 Control Plane MCP 做什么?

  • 排查工作负载问题 — 询问工作负载为何不断重启,并获取使用 cpln 命令进行诊断的指导。
  • 为工作负载配置 TLS 访问 — 通过助手为工作负载配置域名,并启用自动 TLS。
  • 无需凭据即可访问云服务 — 授予工作负载对 S3 存储桶的只读访问权限,无需 IAM 密钥。
  • 配置有状态数据库 — 请求一个具备 HA 故障转移和 S3 备份的生产级 Postgres。
  • 迁移 Kubernetes 配置 — 将 kustomization 文件转换为 Control Plane 配置,并在确认后应用。
  • 串联多步操作 — 使用 then 和 and 组合步骤,让助手按顺序执行。

托管 MCP 服务器

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

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Control Plane

Control Plane AI 插件

通过一个 API,在 AWS、GCP、Azure、OCI 和自有硬件上运行容器化工作负载。它会将 Control Plane 的领域知识、生产环境防护措施和实时 MCP 工具加载到 Claude Code、Codex 和 Antigravity CLI 中,让你的助手能够使用经过验证的 cpln 命令部署、排查故障、保护和迁移工作负载。

安装

Claude Code

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

使用 /plugin marketplace update controlplane 更新,然后使用 /reload-plugins(第三方市场不会自动更新,除非你在 /plugin → 市场中启用自动更新)。

或者,从 Anthropic 的社区插件市场安装,其中的每个插件都已通过 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

启动 Codex,打开 /plugins,然后安装 cpln。MCP 握手会提供核心规则。本地安装还包含可选的会话钩子,这些钩子必须先在 Codex 中审核并信任,才能运行。

使用 codex plugin marketplace upgrade controlplane 更新,然后重启 Codex。

Antigravity CLI

使用 Antigravity CLI 安装插件(agy):

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

通用 MCP 客户端

将任何其他 MCP 客户端指向托管服务器:

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

裸 URL 提供默认的 core 工具集。按需加载工具的客户端可以添加 ?toolsets=full,以使用所有工具。

身份验证

MCP 使用 OAuth 2.1 + PKCE。登录后,助手即可操作你的 Control Plane 组织——你可以选择允许它操作哪些组织,令牌的作用范围仅限于这些组织,并且每次调用都会在服务器端强制执行此限制。再次登录即可更改授权范围。请将 MCP 访问权限视为对你授权的组织的生产环境访问权限。登录方法:

  • Claude Code — /mcp,选择 cpln,然后登录(或 claude mcp login cpln)。
  • Codex — codex mcp login cpln。
  • Antigravity CLI — /mcp,选择 cpln,然后进行身份验证。

环境变量

可选——仅用于某些技能生成的 cpln CLI 工作流(CI/CD、Terraform、Pulumi)。请参阅 .env.example。

变量用途
CPLN_TOKEN用于 cpln CLI 调用的服务账户令牌(敏感信息)。
CPLN_ORG默认组织。
CPLN_GVC默认 GVC。
CPLN_PROFILE本地 cpln CLI 配置文件。

用法

用自然语言提问——助手会调用合适的技能或代理:

  • “排查我的 payments-api 工作负载在 production 中不断重启的原因。”
  • “在我的 web 工作负载前部署 app.example.com,并启用自动 TLS。”
  • “让我的 analytics 工作负载无需凭据即可读取 S3 存储桶 prod-event-logs——不使用 IAM 密钥。”
  • “配置一个具有 HA 故障转移和 S3 备份的生产级 Postgres。”
  • “将此 kustomization.yaml 转换为 Control Plane 配置,并在我确认后将其应用到 staging。”

Claude Code 中还有两个工作流支持斜杠命令——/cpln:troubleshoot WORKLOAD 和 /cpln:migrate-k8s FILE;在其他客户端中,可以按名称请求相同的工作流。

包含内容

  • 涵盖 CLI 用法、访问控制、自动扩缩、网络、可观测性、迁移、模板、有状态存储和安全的领域技能。
  • 两个引导式代理:工作负载故障排查,以及 Kubernetes / Compose / Helm 迁移。
  • 一组简短的常驻规则,助手会在每次会话中应用;完整操作指南则作为技能按需读取。
  • 已预先配置对托管 Control Plane MCP 服务器的访问。

安全

  • MCP 访问权限属于生产环境访问权限——受你授权的组织范围和你自身的 RBAC 限制。
  • 破坏性操作(删除资源、缩小或删除卷、替换工作负载、应用到生产环境)需要明确确认。
  • 密钥值不会经过聊天传递:Control Plane 会生成无需任何人知晓的值;用户在 Console 中输入自己的值;工具只返回密钥元数据。
  • 插件不会存储日志、密钥、提示词或遥测数据;你的 AI 客户端和模型提供商会根据各自的政策处理提示词。

请按照 SECURITY.md 报告漏洞。

数据去向

插件声明的唯一连接器是位于 https://mcp.cpln.io/mcp 的托管 MCP 服务器;它只会操作你登录时授权的组织,并使用你自己的权限。

任务需要时,技能还会在你的计算机上运行以下工具,每个工具都使用你自己的凭据:

工具数据发送至
cpln CLIControl Plane API(api.cpln.io)、你所在组织的镜像仓库(ORG.registry.cpln.io)和指标端点(metrics.cpln.io),使用你的 CLI 配置文件或 CPLN_TOKEN
docker你推送镜像和拉取镜像所使用的镜像仓库
kubectl、helm你指定的 Kubernetes 集群(从该集群迁移或安装 Control Plane Kubernetes operator 时)
terraform、pulumi通过 Control Plane provider 访问 Control Plane API
gcloud 和其他云 CLI你自己的云账户(连接私有网络或创建代理 VM 时)
curl你自己的域名,用于在设置完成后检查域名

插件本身不存储任何内容。助手创建的资源、应用文件和邀请会存储在你的 Control Plane 组织中,直到你将其删除;组织的审计记录会记录每项更改。

更多信息