Control Plane

npx add-mcp 'https://mcp.cpln.io/mcp'

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 → 마켓플레이스에서 활성화하지 않으면 자동 업데이트되지 않습니다).

또는 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 워크로드가 계속 재시작되는 이유를 문제 해결해 줘."
• "내 web 워크로드 앞에 자동 TLS로 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; 다른 클라이언트에서는 동일한 워크플로를 이름으로 요청하세요.

포함 내용

• CLI 사용, 액세스 제어, 자동 확장, 네트워킹, 관찰 가능성, 마이그레이션, 템플릿, 상태 저장 스토리지 및 보안에 걸친 도메인 스킬.
• 두 가지 안내 에이전트: 워크로드 문제 해결 및 Kubernetes / Compose / Helm 마이그레이션.
• 어시스턴트가 모든 세션에서 적용하는 짧은 상시 규칙 세트와 요청 시 읽는 전체 운영 가이드.
• 호스팅된 Control Plane MCP 서버에 대한 사전 구성된 액세스.

보안

• MCP 액세스는 프로덕션 액세스입니다 — 부여한 조직 및 자체 RBAC로 범위가 제한됩니다.
• 파괴적 작업(리소스 삭제, 볼륨 축소/삭제, 워크로드 교체, 프로덕션 적용)은 명시적 확인이 필요합니다.
• 비밀 값은 채팅을 통과하지 않습니다: Control Plane이 아무도 알 필요가 없는 값을 생성하고, 사용자가 콘솔에 자신의 값을 입력하며, 도구는 비밀 메타데이터만 반환합니다.
• 플러그인은 로그, 비밀, 프롬프트 또는 원격 측정을 저장하지 않습니다. AI 클라이언트와 모델 제공자는 자체 정책에 따라 프롬프트를 처리합니다.

취약점은 SECURITY.md에 따라 보고하세요.

데이터 위치

플러그인의 유일한 선언된 커넥터는 https://mcp.cpln.io/mcp의 호스팅된 MCP 서버로, 로그인 시 부여한 조직에서만 자체 권한으로 작동합니다.

작업에 필요할 때 스킬은 다음 도구를 자체 자격 증명으로 컴퓨터에서 실행합니다:

도구	데이터 전송 대상
cpln CLI	Control Plane API(api.cpln.io), 조직의 이미지 레지스트리(ORG.registry.cpln.io) 및 메트릭 엔드포인트(metrics.cpln.io), CLI 프로필 또는 CPLN_TOKEN 사용
docker	푸시 및 풀하는 이미지 레지스트리
kubectl, helm	마이그레이션하거나 Control Plane Kubernetes 운영자를 설치할 때 지정한 Kubernetes 클러스터
terraform, pulumi	Control Plane 제공자를 통한 Control Plane API
gcloud 및 기타 클라우드 CLI	프라이빗 네트워크 연결 또는 에이전트 VM 생성 시 자체 클라우드 계정
curl	설정 후 확인할 자체 도메인

플러그인 자체는 아무것도 저장하지 않습니다. 어시스턴트가 생성한 리소스, 앱 파일 및 초대는 삭제할 때까지 Control Plane 조직에 저장되며, 조직의 감사 추적이 각 변경을 기록합니다.

추가 정보

• 기여: CONTRIBUTING.md
• 문서: docs.controlplane.com · 지원: support@controlplane.com 또는 Slack
• 라이선스: MIT — LICENSE 참조