Control Plane

официальный

Развёртывание и управление рабочими нагрузками, секретами и сетями в AWS, GCP, Azure и частных облаках.

Что можно делать с Control Plane MCP?

  • Устранение неполадок с рабочими нагрузками — Узнайте, почему рабочая нагрузка постоянно перезапускается, и получите рекомендации по диагностике с помощью команд cpln.
  • Публикация рабочих нагрузок с TLS — Настройте домен для рабочей нагрузки с автоматическим TLS через ассистента.
  • Доступ к облаку без учетных данных — Предоставьте рабочей нагрузке доступ на чтение к бакету S3 без ключей IAM.
  • Развертывание баз данных с сохранением состояния — Запросите готовую к эксплуатации базу Postgres с отказоустойчивым переключением и резервным копированием в S3.
  • Миграция конфигураций Kubernetes — Преобразуйте файл kustomization в формат Control Plane и примените его после подтверждения.
  • Объединение многоэтапных операций — Объединяйте шаги с помощью then и and, чтобы ассистент выполнял их последовательно.

Размещённый MCP-сервер

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

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Control Plane

Плагин Control Plane AI

Запускайте контейнеризированные рабочие нагрузки в AWS, GCP, Azure, OCI и на собственном оборудовании через единый API. Плагин загружает в Claude Code, Codex и Antigravity CLI знания Control Plane о предметной области, защитные механизмы для production-среды и работающие инструменты MCP, чтобы ваш помощник мог развертывать, диагностировать, защищать и переносить рабочие нагрузки с помощью проверенных команд 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 доступом к production-среде тех организаций, которым вы его предоставили. Как войти:

  • Claude Code — /mcp, выберите cpln, войдите в систему (или claude mcp login cpln).
  • Codex — codex mcp login cpln.
  • Antigravity CLI — /mcp, выберите cpln, пройдите аутентификацию.

Переменные среды

Необязательны — нужны только для рабочих процессов CLI cpln, которые генерируют некоторые навыки (CI/CD, Terraform, Pulumi). См. .env.example.

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

Использование

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

  • «Выясни, почему моя рабочая нагрузка payments-api в production постоянно перезапускается».
  • «Размести app.example.com перед моей рабочей нагрузкой web и включи автоматический TLS».
  • «Предоставь моей рабочей нагрузке analytics доступ только для чтения к бакету S3 prod-event-logs без учетных данных — никаких ключей IAM».
  • «Разверни production-базу Postgres с отказоустойчивым переключением и резервным копированием в S3».
  • «Преобразуй этот kustomization.yaml для Control Plane и примени его к staging после моего подтверждения».

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

Что входит в состав

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

Безопасность

  • Доступ MCP — это доступ к production-среде, ограниченный организациями, которым вы его предоставили, и вашими собственными правилами RBAC.
  • Для деструктивных действий (удаления ресурсов, уменьшения размера или удаления томов, замены рабочих нагрузок, применения изменений в production-среде) требуется явное подтверждение.
  • Значения секретов никогда не передаются через чат: Control Plane генерирует значения, которые никому не нужно знать, пользователь вводит собственные значения в Console, а инструменты возвращают только метаданные секретов.
  • Плагин не хранит журналы, секреты, запросы или телеметрию; ваш клиент ИИ и поставщик модели обрабатывают запросы в соответствии со своими правилами.

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

Куда передаются данные

Единственный объявленный коннектор плагина — размещенный сервер MCP по адресу https://mcp.cpln.io/mcp. Он работает только с организациями, которым вы предоставили доступ при входе, и использует ваши собственные разрешения.

Когда это необходимо для задачи, навыки также запускают на вашем компьютере следующие инструменты, каждый с вашими собственными учетными данными:

ИнструментКуда отправляются данные
CLI cplnAPI Control Plane (api.cpln.io), реестр образов вашей организации (ORG.registry.cpln.io) и конечная точка метрик (metrics.cpln.io) с использованием вашего профиля CLI или CPLN_TOKEN
dockerРеестры образов, в которые вы отправляете образы и из которых загружаете их
kubectl, helmКластер Kubernetes, который вы укажете, при миграции с него или установке оператора Kubernetes Control Plane
terraform, pulumiAPI Control Plane через провайдер Control Plane
gcloud и другие облачные CLIВаша собственная облачная учетная запись при подключении частной сети или создании виртуальной машины агента
curlВаш собственный домен для проверки после настройки

Сам плагин ничего не хранит. Созданные помощником ресурсы, файлы приложений и приглашения хранятся в вашей организации Control Plane, пока вы их не удалите; журнал аудита организации фиксирует каждое изменение.

Дополнительно