Control Plane MCPサーバー
コミット 2026年10月29日検証済みのコマンドを使用して、AWS、GCP、Azure、OCIにわたるコンテナ化されたワークロードのデプロイ、トラブルシューティング、セキュリティ確保、および移行をAIアシスタント経由で実行できます。
別名 controlplane-com/ai-plugin, ai-plugin
- スター
- 11
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.2
- 最終コミット
- 2026年10月29日
- ライセンス
- MIT
Control Plane MCPとは
Control PlaneはMCPサーバーです。 検証済みのコマンドを使用して、AWS、GCP、Azure、OCIにわたるコンテナ化されたワークロードのデプロイ、トラブルシューティング、セキュリティ確保、および移行をAIアシスタント経由で実行できます。.
プロジェクトのREADMEから生成された概要
Control Plane MCP server について
Control Planeは、AWS、GCP、Azure、OCI、およびローカルハードウェアにわたるコンテナ化されたワークロードをAIアシスタントが管理できるようにするMCP serverを提供します。Claude Code、Codex、Antigravity CLIと統合されており、インフラストラクチャのデプロイ、セキュリティ確保、および移行のために検証済みのcplnコマンドを実行します。ユーザーは、ホストされたHTTPサーバー経由で接続するか、好みの開発環境にプラグインを直接インストールして利用できます。
セキュリティはOAuth 2.1とPKCEを通じて管理されており、アシスタントがユーザーが許可した特定の組織内でのみ動作することを保証します。システムには本番環境レベルのガードレールが備わっており、破壊的な操作にはユーザーによる明示的な確認が求められます。機密情報を保護するため、シークレット値がチャットを通じて渡されることはありません。代わりに、サーバーが値を生成するか、Control Plane Consoleでの手動入力を要求します。
開発者は、ネットワーキング、オートスケーリング、オブザーバビリティをカバーする専門的なドメインスキルを活用できます。また、このサーバーには、ワークロードのトラブルシューティングや、Kubernetes、Compose、またはHelm構成の移行に特化したガイデッドエージェントも含まれています。コアツールはホストされていますが、特定のワークフローでは、既存の認証情報を使用してkubectl、terraform、またはpulumiなどのローカルツールが呼び出される場合があります。
できること
- 1失敗しているワークロードのトラブルシューティング本番環境の特定のサービスが繰り返し再起動している原因を特定するようアシスタントに依頼します。
- 2既存の構成の移行KubernetesまたはHelmファイルをControl Planeのリソースに変換し、ステージング環境に適用します。
- 3セキュアなネットワーキングの設定自動TLS暗号化を備えたドメイン名をワークロードの前面に設定します。
- 4クラウド権限の管理IAMキーを使用せずに、ワークロードにS3バケットへの読み取りアクセス権を付与します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Control Plane MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにControl Plane MCPをインストール
$ claude mcp add --transport http ai-plugin https://mcp.cpln.io/mcpCursorにControl Plane MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://mcp.cpln.io/mcp"
}
}
}VS CodeにControl Plane MCPをインストール
.vscode/mcp.json
{
"servers": {
"ai-plugin": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}VS Code CLIにControl Plane MCPをインストール
$ code --add-mcp '{"name":"ai-plugin","type":"http","url":"https://mcp.cpln.io/mcp"}'CodexにControl Plane MCPをインストール
$ codex mcp add ai-plugin --url https://mcp.cpln.io/mcpCodex config.tomlにControl Plane MCPをインストール
~/.codex/config.toml
[mcp_servers.ai-plugin] url = "https://mcp.cpln.io/mcp"
Gemini CLIにControl Plane MCPをインストール
$ gemini mcp add -s user --transport http ai-plugin https://mcp.cpln.io/mcpGemini settings.jsonにControl Plane MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://mcp.cpln.io/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能controlplane-com/ai-plugin is public and reachablegithub.com/controlplane-com/ai-plugin ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-29github.com/controlplane-com/ai-plugin ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答HTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見るControl Plane AI Plugin
Run containerized workloads across AWS, GCP, Azure, OCI, and your own hardware under one API. It loads Control Plane's domain knowledge, production guardrails, and live MCP tools into Claude Code, Codex, and Antigravity CLI so your assistant can deploy, troubleshoot, secure, and migrate workloads with verified cpln commands.
Installation
Claude Code
/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins
Update with /plugin marketplace update controlplane then /reload-plugins (third-party marketplaces don't auto-update unless you enable it in /plugin → Marketplaces).
Alternatively, install from Anthropic's community plugin marketplace, where every listing has passed Anthropic's review:
/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
Start Codex, open /plugins, and install cpln. The MCP handshake supplies the core rules. Local installations also include optional session hooks, which must be reviewed and trusted in Codex before they run.
Update with codex plugin marketplace upgrade controlplane, then restart Codex.
Antigravity CLI
Install the plugin with Antigravity CLI (agy):
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln
Generic MCP client
Point any other MCP client at the hosted server:
{
"mcpServers": {
"cpln": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}
The bare URL serves the default core tool set. A client that loads tools on demand can add ?toolsets=full for every tool.
Authentication
MCP uses OAuth 2.1 + PKCE. Sign in to let the assistant act on your Control Plane organizations — you choose which orgs it may operate on, and the token is scoped to those orgs and enforced server-side on every call. Sign in again to change the grant. Treat MCP access as production access to the orgs you grant. How to sign in:
- Claude Code —
/mcp, selectcpln, sign in (orclaude mcp login cpln). - Codex —
codex mcp login cpln. - Antigravity CLI —
/mcp, selectcpln, authenticate.
Environment variables
Optional — only for the cpln CLI workflows some skills generate (CI/CD, Terraform, Pulumi). See .env.example.
| Variable | Purpose |
|---|---|
CPLN_TOKEN |
Service-account token for cpln CLI calls (sensitive). |
CPLN_ORG |
Default organization. |
CPLN_GVC |
Default GVC. |
CPLN_PROFILE |
Local cpln CLI profile. |
Usage
Ask in natural language — the assistant routes to the right skill or agent:
- "Troubleshoot why my
payments-apiworkload inproductionkeeps restarting." - "Put
app.example.comin front of mywebworkload with auto-TLS." - "Give my
analyticsworkload credential-free read access to S3 bucketprod-event-logs— no IAM keys." - "Provision a production Postgres with HA failover and S3 backups."
- "Convert this
kustomization.yamlto Control Plane and apply it tostagingafter I confirm."
Two workflows also have slash commands in Claude Code — /cpln:troubleshoot WORKLOAD and /cpln:migrate-k8s FILE; in other clients, ask for the same workflows by name.
What's included
- Domain skills across CLI usage, access control, autoscaling, networking, observability, migration, templates, stateful storage, and security.
- Two guided agents: workload troubleshooting and Kubernetes / Compose / Helm migration.
- A short always-on rule set the assistant applies in every session, with the full operating guide as a skill read on demand.
- Pre-configured access to the hosted Control Plane MCP server.
Security
- MCP access is production access — scoped to the orgs you grant and your own RBAC.
- Destructive actions (deleting resources, shrinking/deleting volumes, replacing workloads, applying to production) require explicit confirmation.
- Secret values never pass through the chat: Control Plane generates the values nobody needs to know, the user types their own values into the Console, and tools return secret metadata only.
- The plugin stores no logs, secrets, prompts, or telemetry; your AI client and model provider process prompts per their own policies.
Report vulnerabilities per SECURITY.md.
Where data goes
The plugin's one declared connector is the hosted MCP server at https://mcp.cpln.io/mcp, which acts only on the orgs you grant when you sign in, with your own permissions.
When a task needs it, the skills also run these tools on your machine, each with your own credentials:
| Tool | Sends data to |
|---|---|
cpln CLI |
The Control Plane API (api.cpln.io), your org's image registry (ORG.registry.cpln.io), and the metrics endpoint (metrics.cpln.io), using your CLI profile or CPLN_TOKEN |
docker |
The image registries you push to and pull from |
kubectl, helm |
The Kubernetes cluster you point them at, when migrating from it or installing the Control Plane Kubernetes operator |
terraform, pulumi |
The Control Plane API, through the Control Plane provider |
gcloud and other cloud CLIs |
Your own cloud account, when connecting a private network or creating an agent VM |
curl |
Your own domain, to check it after setup |
The plugin itself stores nothing. Resources, app files, and invitations the assistant creates are stored in your Control Plane org until you delete them, and the org's audit trail records each change.
More
- Contributing: CONTRIBUTING.md
- Docs: docs.controlplane.com · Support:
support@controlplane.comor Slack - License: MIT — see LICENSE
Control Plane MCPのよくある質問
Control Plane MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http ai-plugin https://mcp.cpln.io/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Control Plane MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Control Plane MCP serverへの認証方法を教えてください。
このサーバーはOAuth 2.1 + PKCEを使用しています。Claude Code、Codex、またはAntigravity CLIを通じてサインインすることで、アシスタントに特定の組織へのアクセス権を付与できます。
AIアシスタントは破壊的な操作を実行できますか?
はい。ただし、リソースやワークロードの削除などの破壊的な操作には、ユーザーによる明示的な確認が必要です。
どのようなワークロードを管理できますか?
AWS、GCP、Azure、OCI、および独自のハードウェア上で動作するコンテナ化されたワークロードを管理できます。