Control Plane

chính thức

Triển khai và vận hành khối lượng công việc, bí mật và mạng trên AWS, GCP, Azure và các đám mây riêng.

Bạn có thể làm gì với Control Plane MCP?

  • Khắc phục sự cố workload — Hỏi vì sao một workload liên tục khởi động lại và nhận hướng dẫn chẩn đoán bằng các lệnh cpln.
  • Công khai workload với TLS — Đặt một tên miền phía trước workload với TLS tự động thông qua trợ lý.
  • Truy cập đám mây không cần thông tin xác thực — Cấp quyền đọc cho workload đối với một bucket S3 mà không cần khóa IAM.
  • Cấp phát cơ sở dữ liệu có trạng thái — Yêu cầu một cơ sở dữ liệu Postgres dùng cho môi trường production, có chuyển đổi dự phòng HA và sao lưu lên S3.
  • Di chuyển cấu hình Kubernetes — Chuyển đổi một tệp kustomization sang Control Plane và áp dụng sau khi xác nhận.
  • Kết hợp các thao tác nhiều bước — Kết hợp các bước bằng then và and để trợ lý thực hiện chúng theo trình tự.

Máy chủ MCP được lưu trữ

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

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Control Plane

Plugin AI Control Plane

Chạy các khối lượng công việc được đóng gói trong container trên AWS, GCP, Azure, OCI và phần cứng của riêng bạn thông qua một API duy nhất. Plugin tải kiến thức chuyên môn về Control Plane, các biện pháp bảo vệ trong môi trường production và các công cụ MCP trực tiếp vào Claude Code, Codex và Antigravity CLI để trợ lý có thể triển khai, khắc phục sự cố, bảo mật và di chuyển khối lượng công việc bằng các lệnh cpln đã được xác minh.

Cài đặt

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Cập nhật bằng /plugin marketplace update controlplane, sau đó /reload-plugins (các marketplace của bên thứ ba không tự động cập nhật trừ khi bạn bật tùy chọn này trong /plugin → Marketplaces).

Ngoài ra, hãy cài đặt từ marketplace plugin cộng đồng của Anthropic, nơi mọi mục đều đã qua quy trình đánh giá của 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

Khởi động Codex, mở /plugins và cài đặt cpln. MCP handshake cung cấp các quy tắc cốt lõi. Các bản cài đặt cục bộ cũng bao gồm các hook phiên tùy chọn; bạn phải xem xét và tin cậy chúng trong Codex trước khi chúng chạy.

Cập nhật bằng codex plugin marketplace upgrade controlplane, sau đó khởi động lại Codex.

Antigravity CLI

Cài đặt plugin bằng Antigravity CLI (agy):

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

MCP client chung

Trỏ mọi MCP client khác đến máy chủ được lưu trữ:

{
  "mcpServers": {
    "cpln": {
      "type": "http",
      "url": "https://mcp.cpln.io/mcp"
    }
  }
}

URL trần cung cấp bộ công cụ core mặc định. Client tải công cụ theo yêu cầu có thể thêm ?toolsets=full để truy cập mọi công cụ.

Xác thực

MCP sử dụng OAuth 2.1 + PKCE. Đăng nhập để trợ lý có thể thao tác trên các tổ chức Control Plane của bạn — bạn chọn những tổ chức mà trợ lý được phép thao tác, còn token được giới hạn trong các tổ chức đó và được thực thi ở phía máy chủ trong mọi lệnh gọi. Đăng nhập lại để thay đổi quyền đã cấp. Hãy xem quyền truy cập MCP như quyền truy cập production vào các tổ chức bạn cấp quyền. Cách đăng nhập:

  • Claude Code — /mcp, chọn cpln, đăng nhập (hoặc claude mcp login cpln).
  • Codex — codex mcp login cpln.
  • Antigravity CLI — /mcp, chọn cpln, xác thực.

Biến môi trường

Không bắt buộc — chỉ dùng cho các quy trình CLI cpln mà một số skill tạo ra (CI/CD, Terraform, Pulumi). Xem .env.example.

BiếnMục đích
CPLN_TOKENToken tài khoản dịch vụ cho các lệnh gọi CLI cpln (nhạy cảm).
CPLN_ORGTổ chức mặc định.
CPLN_GVCGVC mặc định.
CPLN_PROFILEHồ sơ CLI cpln cục bộ.

Cách sử dụng

Đặt câu hỏi bằng ngôn ngữ tự nhiên — trợ lý sẽ chuyển yêu cầu đến skill hoặc agent phù hợp:

  • "Khắc phục sự cố vì sao khối lượng công việc payments-api của tôi trong production liên tục khởi động lại."
  • "Đặt app.example.com phía trước khối lượng công việc web của tôi và bật auto-TLS."
  • "Cấp cho khối lượng công việc analytics của tôi quyền đọc bucket S3 prod-event-logs mà không cần thông tin xác thực — không dùng khóa IAM."
  • "Cấp phát một Postgres production có chuyển đổi dự phòng HA và sao lưu S3."
  • "Chuyển đổi kustomization.yaml này sang Control Plane và áp dụng cho staging sau khi tôi xác nhận."

Hai quy trình cũng có lệnh slash trong Claude Code — /cpln:troubleshoot WORKLOAD và /cpln:migrate-k8s FILE; trong các client khác, hãy yêu cầu các quy trình tương tự theo tên.

Nội dung bao gồm

  • Các skill chuyên môn về cách sử dụng CLI, kiểm soát truy cập, tự động mở rộng quy mô, mạng, khả năng quan sát, di chuyển, mẫu, lưu trữ trạng thái và bảo mật.
  • Hai agent hướng dẫn: khắc phục sự cố khối lượng công việc và di chuyển Kubernetes / Compose / Helm.
  • Một bộ quy tắc ngắn luôn được áp dụng trong mọi phiên, cùng hướng dẫn vận hành đầy đủ dưới dạng skill được đọc theo yêu cầu.
  • Quyền truy cập được cấu hình sẵn vào máy chủ MCP Control Plane được lưu trữ.

Bảo mật

  • Quyền truy cập MCP là quyền truy cập production — được giới hạn theo các tổ chức bạn cấp quyền và RBAC của riêng bạn.
  • Các thao tác phá hủy (xóa tài nguyên, thu nhỏ/xóa volume, thay thế khối lượng công việc, áp dụng vào production) cần có xác nhận rõ ràng.
  • Giá trị bí mật không bao giờ đi qua cuộc trò chuyện: Control Plane tạo ra các giá trị mà không ai cần biết, người dùng tự nhập giá trị của mình vào Console và các công cụ chỉ trả về siêu dữ liệu bí mật.
  • Plugin không lưu nhật ký, bí mật, prompt hay dữ liệu đo từ xa; client AI và nhà cung cấp mô hình của bạn xử lý prompt theo chính sách riêng của họ.

Báo cáo lỗ hổng theo SECURITY.md.

Dữ liệu được gửi đến đâu

Connector duy nhất được khai báo của plugin là máy chủ MCP được lưu trữ tại https://mcp.cpln.io/mcp, chỉ thao tác trên các tổ chức bạn cấp quyền khi đăng nhập và bằng quyền hạn của chính bạn.

Khi cần thiết, các skill cũng chạy những công cụ sau trên máy của bạn, mỗi công cụ sử dụng thông tin xác thực của riêng bạn:

Công cụGửi dữ liệu đến
CLI cplnAPI Control Plane (api.cpln.io), registry image của tổ chức bạn (ORG.registry.cpln.io) và endpoint metrics (metrics.cpln.io), sử dụng hồ sơ CLI của bạn hoặc CPLN_TOKEN
dockerCác registry image mà bạn đẩy image lên và kéo image xuống
kubectl, helmCụm Kubernetes mà bạn chỉ định, khi di chuyển từ cụm đó hoặc cài đặt Kubernetes operator của Control Plane
terraform, pulumiAPI Control Plane thông qua provider của Control Plane
gcloud và các CLI đám mây khácTài khoản đám mây của riêng bạn, khi kết nối mạng riêng hoặc tạo máy ảo agent
curlTên miền của riêng bạn để kiểm tra sau khi thiết lập

Bản thân plugin không lưu trữ dữ liệu. Tài nguyên, tệp ứng dụng và lời mời do trợ lý tạo sẽ được lưu trong tổ chức Control Plane của bạn cho đến khi bạn xóa chúng; nhật ký kiểm tra của tổ chức sẽ ghi lại từng thay đổi.

Thông tin thêm