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 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 CLIControl 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 組織中,直到您將其刪除;組織的稽核軌跡會記錄每項變更。

更多資訊