Control Plane MCP server
Commit 29 Okt 2026Memungkinkan AI assistant untuk melakukan deploy, troubleshooting, mengamankan, dan migrasi workload berbasis container di AWS, GCP, Azure, dan OCI menggunakan command yang terverifikasi.
Juga dikenal sebagai controlplane-com/ai-plugin, ai-plugin
- Stars
- 11
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.0.2
- Commit terakhir
- 29 Okt 2026
- Lisensi
- MIT
Apa itu Control Plane MCP?
Control Plane adalah MCP server. Memungkinkan AI assistant untuk melakukan deploy, troubleshooting, mengamankan, dan migrasi workload berbasis container di AWS, GCP, Azure, dan OCI menggunakan command yang terverifikasi.
Ringkasan dibuat dari README proyek
Tentang Control Plane MCP server
Control Plane menyediakan MCP server yang memungkinkan AI assistant untuk mengelola workload berbasis container di AWS, GCP, Azure, OCI, dan hardware lokal. Tool ini terintegrasi dengan Claude Code, Codex, dan Antigravity CLI untuk mengeksekusi command cpln yang terverifikasi guna melakukan deploy, mengamankan, dan migrasi infrastruktur. Anda dapat terhubung melalui hosted HTTP server atau menginstall plugin secara langsung ke lingkungan pengembangan pilihan Anda.
Keamanan dikelola melalui OAuth 2.1 dan PKCE, memastikan assistant hanya beroperasi di dalam organisasi spesifik yang Anda berikan izin. Sistem ini menggunakan guardrails standar produksi di mana tindakan destruktif memerlukan konfirmasi eksplisit dari user. Untuk melindungi informasi sensitif, nilai secret tidak akan pernah dikirim melalui chat; sebagai gantinya, server akan membuat nilai tersebut atau meminta input manual di Control Plane Console.
Developer dapat memanfaatkan domain skills khusus yang mencakup networking, autoscaling, dan observability. Server ini juga menyertakan guided agents yang dirancang khusus untuk troubleshooting workload serta migrasi konfigurasi Kubernetes, Compose, atau Helm. Meskipun core tools disediakan secara hosted, workflow tertentu mungkin akan memicu local tools seperti kubectl, terraform, atau pulumi menggunakan kredensial yang sudah Anda miliki.
Apa yang bisa Anda lakukan dengannya
- 1Troubleshoot workload yang gagalMinta assistant untuk mengidentifikasi penyebab mengapa service tertentu di lingkungan produksi terus-menerus mengalami restart.
- 2Migrasi konfigurasi yang sudah adaKonversi file Kubernetes atau Helm menjadi resource Control Plane dan terapkan ke lingkungan staging.
- 3Konfigurasi networking yang amanSiapkan nama domain di depan sebuah workload dengan enkripsi TLS otomatis.
- 4Kelola izin cloudBerikan akses read ke S3 bucket untuk sebuah workload tanpa perlu menggunakan IAM keys.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Control Plane MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Control Plane MCP di Claude Code
$ claude mcp add --transport http ai-plugin https://mcp.cpln.io/mcpInstal Control Plane MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://mcp.cpln.io/mcp"
}
}
}Instal Control Plane MCP di VS Code
.vscode/mcp.json
{
"servers": {
"ai-plugin": {
"type": "http",
"url": "https://mcp.cpln.io/mcp"
}
}
}Instal Control Plane MCP di VS Code CLI
$ code --add-mcp '{"name":"ai-plugin","type":"http","url":"https://mcp.cpln.io/mcp"}'Instal Control Plane MCP di Codex
$ codex mcp add ai-plugin --url https://mcp.cpln.io/mcpInstal Control Plane MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.ai-plugin] url = "https://mcp.cpln.io/mcp"
Instal Control Plane MCP di Gemini CLI
$ gemini mcp add -s user --transport http ai-plugin https://mcp.cpln.io/mcpInstal Control Plane MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://mcp.cpln.io/mcp",
"type": "http"
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaucontrolplane-com/ai-plugin is public and reachablegithub.com/controlplane-com/ai-plugin ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-29github.com/controlplane-com/ai-plugin ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPHTTPS endpoint answered 401 (sign-in required)Lolos
README
Lihat di GitHubControl 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
Pertanyaan tentang Control Plane MCP
Bagaimana cara menambahkan Control Plane MCP ke Claude Code?
Jalankan claude mcp add --transport http ai-plugin https://mcp.cpln.io/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Control Plane MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara autentikasi dengan Control Plane MCP server?
Server ini menggunakan OAuth 2.1 + PKCE. Anda dapat login melalui Claude Code, Codex, atau Antigravity CLI untuk memberikan akses assistant ke organisasi tertentu.
Apakah AI assistant bisa melakukan tindakan destruktif?
Ya, namun tindakan destruktif seperti menghapus resource atau workload memerlukan konfirmasi eksplisit dari Anda.
Jenis workload apa saja yang bisa saya kelola?
Anda dapat menjalankan workload berbasis container di AWS, GCP, Azure, OCI, maupun hardware milik Anda sendiri.