Control Plane

公式

AWS、GCP、Azure、およびプライベートクラウド全体でワークロード、シークレット、ネットワーキングをデプロイおよび運用します。

GitHub
9

Control Plane MCPで何ができますか？

  • ワークロードのトラブルシューティング — ガイド付きトラブルシューティングエージェントを使用して、ワークロードが再起動や失敗を繰り返す原因をアシスタントに診断してもらいます。
  • Kubernetes、Compose、またはHelmマニフェストの移行 — アシスタントにkustomization.yamlまたは類似のファイルをControl Planeワークロードに変換させ、確認後に適用してもらいます。
  • マネージドステートフルサービスのプロビジョニング — 自然言語で、HAフェイルオーバーとS3バックアップを備えた本番用Postgres、またはその他のステートフルストレージをリクエストします。
  • ネットワーキングとTLSの設定 — アシスタントに、ワークロードの前にauto-TLS付きのカスタムドメインを配置するよう指示します。
  • クラウドに依存しないワークロードIDの設定 — IAMキーを管理せずにS3バケットなどのクラウドリソースへのクレデンシャル不要のアクセスを依頼します。

ドキュメント

Control Plane

Control Plane AI プラグイン

AWS、GCP、Azure、OCI、そして自社ハードウェア上でコンテナ化されたワークロードを単一のAPIで実行できます。Claude Code、Codex、Antigravity CLIにControl Planeのドメイン知識、本番環境向けガードレール、そしてライブMCPツールを読み込むことで、アシスタントは検証済みの 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 → マーケットプレイス で有効にしない限り自動更新されません）。

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Codexを起動し、/plugins を開き、cpln をインストールします。ガードレール注入にはプラグインフックが必要ですが、Codexではデフォルトで無効になっています。~/.codex/config.toml で有効にして再起動してください。

[features]
plugins = true
plugin_hooks = true

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?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_TOKENcpln CLI呼び出し用のサービスアカウントトークン（機密情報）。
CPLN_ORGデフォルトの組織。
CPLN_GVCデフォルトのGVC。
CPLN_PROFILEローカルの cpln CLIプロファイル。

使用方法

自然言語で質問してください。アシスタントが適切なスキルまたはエージェントにルーティングします。

  • 「production にある payments-api ワークロードが再起動を繰り返す原因をトラブルシューティングして。」
  • 「自動TLSを使用して、web ワークロードの前に app.example.com を配置して。」
  • 「analytics ワークロードに、IAMキーなしでS3バケット prod-event-logs への認証情報不要の読み取りアクセスを付与して。」
  • 「HAフェイルオーバーとS3バックアップを備えた本番用Postgresをプロビジョニングして。」
  • 「この kustomization.yaml をControl Planeに変換し、確認後に staging に適用して。」

Claude Codeでは、/cpln:troubleshoot WORKLOAD と /cpln:migrate-k8s FILE の2つのワークフローにスラッシュコマンドもあります。他のクライアントでは、同じワークフローを名前で要求してください。

含まれるもの

  • CLIの使用法、アクセス制御、オートスケーリング、ネットワーキング、可観測性、移行、テンプレート、ステートフルストレージ、セキュリティにわたるドメインスキル。
  • 2つのガイド付きエージェント: ワークロードのトラブルシューティングと、Kubernetes / Compose / Helmの移行。
  • アシスタントがすべてのセッションで適用する常時オンのガードレールルール。
  • ホストされたControl Plane MCPサーバーへの事前設定済みアクセス。

セキュリティ

  • MCPアクセスは本番アクセスです。許可した組織と自身のRBACにスコープされます。
  • 破壊的なアクション（リソースの削除、ボリュームの縮小/削除、ワークロードの置き換え、本番環境への適用）には明示的な確認が必要です。
  • シークレット値は reveal 権限でのみ公開されます。最小権限の原則を使用してください。
  • プラグインはログ、シークレット、プロンプト、テレメトリを一切保存しません。お客様のAIクライアントとモデルプロバイダーは、それぞれのポリシーに従ってプロンプトを処理します。

脆弱性は SECURITY.md に従って報告してください。

詳細