Control Plane AI Plugin

Запуск контейнеризованных рабочих нагрузок на AWS, GCP, Azure, OCI и на вашем оборудовании через единый API. Он загружает доменные знания Control Plane, эксплуатационные guardrails и живые инструменты MCP в Claude Code, Codex и Antigravity CLI, чтобы ваш помощник мог разворачивать, диагностировать проблемы, обеспечивать безопасность и мигрировать нагрузки с проверяемыми командами cpln.

Installation

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. Инъекция guardrail зависит от плагин‑хуков, которые Codex по умолчанию отключает — включите их в ~/.codex/config.toml и перезапустите:

[features]
plugins = true
plugin_hooks = true

Обновляйте через codex plugin marketplace upgrade controlplane, затем перезапустите Codex.

Antigravity CLI

Установите плагин через Antigravity CLI (agy):

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

Generic MCP client

Укажите любой другой MCP клиент на размещённый сервер:

{
  "mcpServers": {
    "cpln": {
      "type": "http",
      "url": "https://mcp.cpln.io/mcp?toolsets=full"
    }
  }
}

Authentication

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, аутентифицируйтесь.

Environment variables

Опционально — только для workflows cpln CLI, которые создают некоторые навыки (CI/CD, Terraform, Pulumi). См. .env.example.

Переменная	Назначение
CPLN_TOKEN	Сервис‑аккаунт‑токен для вызовов cpln CLI (секретный).
CPLN_ORG	Организация по умолчанию.
CPLN_GVC	GVC по умолчанию.
CPLN_PROFILE	Локальный профиль CLI cpln.

Usage

Задавайте вопросы на естественном языке — помощник направляет запрос к нужному навыку или агенту:

"Устраните, почему workload payments-api в окружении production постоянно перезапускается."
"Выведите app.example.com вперёд моего workload web с автоматическим TLS."
"Дайте моему workload analytics доступ на чтение к S3 бакету prod-event-logs без IAM‑ключей."
"Обеспечьте продакшн Postgres с HA‑переключением и резервным копированием в S3."
"Преобразуйте этот kustomization.yaml в Control Plane и примените к staging после моего подтверждения."

Два рабочих процесса также доступны как slash-команды в Claude Code — /cpln:troubleshoot WORKLOAD и /cpln:migrate-k8s FILE; в других клиентах спрашивайте те же workflows по названию.

What's included

Доменные навыки по CLI‑использованию, управлению доступом, автошкалированию, сетям, наблюдаемости, миграции, шаблонам, хранению состояния и безопасности.
Два направляемых агента: устранение неполадок рабочих нагрузок и миграция Kubernetes / Compose / Helm.
Постоянное защитное правило, применяемое помощником в каждой сессии.
Преднастроенный доступ к размещённому серверу Control Plane MCP.

Security

Доступ к MCP — это продакшн‑доступ — ограничен организациями, которым вы предоставляете доступ, и вашей RBAC.
Деструктивные действия (удаление ресурсов, уменьшение/удаление томов, замена рабочих нагрузок, применение на продакшн) требуют явного подтверждения.
Секретные значения никогда не выводятся через инструменты MCP — секреты появляются только как метаданные.
Плагин не хранит логи, секреты, подсказки или телеметрию; ваши клиент и провайдер моделей обрабатывают подсказки в соответствии с их политиками.

Сообщайте об уязвимостях согласно SECURITY.md.

Вклад: CONTRIBUTING.md
Документация: docs.controlplane.com · Поддержка: support@controlplane.com или Slack
Лицензия: MIT — см. LICENSE