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 Plugin
透過單一 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 → Marketplaces 中啟用自動更新,否則第三方市集不會自動更新)。
或者,從 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 設定檔。 |
使用方式
以自然語言提出要求 — 助理會將請求導向適當的技能或代理程式:
- 「疑難排解為什麼我在
production中的payments-api工作負載一直重新啟動。」 - 「在我的
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 運算子時 |
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