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 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 CLI | Control 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 组织中,直到你将其删除;组织的审计记录会记录每项更改。
更多信息
- 贡献指南:CONTRIBUTING.md
- 文档:docs.controlplane.com · 支持:
support@controlplane.com或 Slack - 许可证:MIT — 参见 LICENSE