Control Plane MCP server
2026년 10월 29일 커밋검증된 명령어를 사용하여 AWS, GCP, Azure, OCI 전반에서 컨테이너화된 워크로드를 배포, 트러블슈팅, 보안 설정 및 마이그레이션할 수 있도록 AI 어시스턴트 기능을 지원합니다.
다른 이름 controlplane-com/ai-plugin, ai-plugin
- 스타
- 11
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.2
- 마지막 커밋
- 2026년 10월 29일
- 라이선스
- MIT
Control Plane MCP란?
Control Plane은(는) MCP server입니다. 검증된 명령어를 사용하여 AWS, GCP, Azure, OCI 전반에서 컨테이너화된 워크로드를 배포, 트러블슈팅, 보안 설정 및 마이그레이션할 수 있도록 AI 어시스턴트 기능을 지원합니다.
프로젝트 README에서 생성된 요약
Control Plane MCP server 정보
Control Plane은 AI 어시스턴트가 AWS, GCP, Azure, OCI 및 로컬 하드웨어 전반에서 컨테이너화된 워크로드를 관리할 수 있도록 하는 MCP server를 제공합니다. Claude Code, Codex, Antigravity CLI와 통합되어 인프라 배포, 보안 설정 및 마이그레이션을 위한 검증된 cpln 명령어를 실행합니다. 사용자는 hosted HTTP server를 통해 연결하거나 선호하는 개발 환경에 플러그인을 직접 설치할 수 있습니다.
보안은 OAuth 2.1 및 PKCE를 통해 관리되므로, 어시스턴트는 사용자가 승인한 특정 조직 내에서만 작동합니다. 시스템에는 프로덕션급 가드레일이 적용되어 파괴적인 작업 시 사용자의 명시적인 확인을 요구합니다. 민감한 정보를 보호하기 위해 비밀 값은 채팅을 통해 전달되지 않으며, 대신 서버가 값을 생성하거나 Control Plane Console에서 수동 입력을 요구합니다.
개발자는 네트워킹, 오토스케일링, 옵저버빌리티를 아우르는 전문화된 도메인 SKILL을 활용할 수 있습니다. 또한 워크로드 트러블슈팅과 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Control Plane MCP server 인증은 어떻게 하나요?
서버는 OAuth 2.1 + PKCE를 사용합니다. Claude Code, Codex 또는 Antigravity CLI를 통해 로그인하여 어시스턴트가 특정 조직에 접근할 수 있도록 권한을 부여할 수 있습니다.
AI 어시스턴트가 파괴적인 작업을 수행할 수 있나요?
네, 하지만 리소스나 워크로드를 삭제하는 것과 같은 파괴적인 작업은 사용자의 명시적인 확인이 필요합니다.
어떤 종류의 워크로드를 관리할 수 있나요?
AWS, GCP, Azure, OCI 및 자체 하드웨어에서 컨테이너화된 워크로드를 실행할 수 있습니다.