Control Plane

Control Plane AI プラグイン

AWS、GCP、Azure、OCI、および独自のハードウェア上で、コンテナ化されたワークロードを単一の API で実行できます。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 ワークロードが再起動を繰り返す原因をトラブルシューティングして。」
• 「自動 TLS を設定して、app.example.com を web ワークロードの前段に配置して。」
• 「IAM キーを使わずに、analytics ワークロードに S3 バケット prod-event-logs への認証情報不要の読み取りアクセスを許可して。」
• 「HA フェイルオーバーと S3 バックアップに対応した、本番環境用の Postgres をプロビジョニングして。」
• 「この kustomization.yaml を Control Plane 用に変換し、確認後に staging に適用して。」

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

含まれる内容

• CLI の使用、アクセス制御、オートスケーリング、ネットワーク、オブザーバビリティ、移行、テンプレート、ステートフルストレージ、セキュリティに関するドメインスキル。
• ワークロードのトラブルシューティングと Kubernetes ／ Compose ／ Helm の移行を支援する、2 つのガイド付きエージェント。
• アシスタントが各セッションで適用する、常時有効な短いルールセット。完全な運用ガイドは必要に応じて読み込みます。
• ホスト型 Control Plane MCP サーバーへの事前設定済みアクセス。

セキュリティ

• MCP アクセスは本番環境へのアクセスです。アクセス範囲は、許可した組織とユーザー自身の RBAC に限定されます。
• 破壊的な操作（リソースの削除、ボリュームの縮小や削除、ワークロードの置き換え、本番環境への適用）には、明示的な確認が必要です。
• シークレットの値がチャットを通じて送信されることはありません。Control Plane が誰も知る必要のない値を生成し、ユーザーが Console に自分で値を入力します。ツールが返すのはシークレットのメタデータのみです。
• プラグインはログ、シークレット、プロンプト、テレメトリを保存しません。AI クライアントとモデルプロバイダーは、それぞれのポリシーに従ってプロンプトを処理します。

脆弱性は SECURITY.md から報告してください。

データの送信先

このプラグインが宣言するコネクターは、ホスト型 MCP サーバー https://mcp.cpln.io/mcp の 1 つです。このサーバーは、サインイン時に許可した組織に対し、ユーザー自身の権限でのみ操作します。

タスクで必要な場合、スキルはユーザー自身の認証情報を使って、これらのツールもローカルマシンで実行します。

ツール	データの送信先
cpln CLI	CLI プロファイルまたは CPLN_TOKEN を使用して、Control Plane API（api.cpln.io）、組織のイメージレジストリ（ORG.registry.cpln.io）、およびメトリクスエンドポイント（metrics.cpln.io）に送信します
docker	イメージのプッシュ先およびプル元のレジストリ
kubectl, helm	Kubernetes から移行する場合、または Control Plane Kubernetes オペレーターをインストールする場合に、指定した Kubernetes クラスター
terraform, pulumi	Control Plane プロバイダーを通じた Control Plane API
gcloud およびその他のクラウド CLI	プライベートネットワークへの接続時、またはエージェント VM の作成時に、ユーザー自身のクラウドアカウント
curl	セットアップ後の確認に使用する、ユーザー自身のドメイン

プラグイン自体は何も保存しません。アシスタントが作成したリソース、アプリファイル、招待は、削除するまで Control Plane 組織に保存され、組織の監査証跡には各変更が記録されます。

詳細

• コントリビューション：CONTRIBUTING.md
• ドキュメント：docs.controlplane.com · サポート：[email protected] または Slack
• ライセンス：MIT — LICENSE を参照