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 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_GVC | GVC по умолчанию. |
CPLN_PROFILE | Локальный профиль CLI cpln. |
Использование
Задавайте вопросы на естественном языке — помощник выберет подходящий навык или агент:
- «Выясни, почему моя рабочая нагрузка
payments-apiвproductionпостоянно перезапускается». - «Размести
app.example.comперед моей рабочей нагрузкойwebи включи автоматический TLS». - «Предоставь моей рабочей нагрузке
analyticsдоступ только для чтения к бакету S3prod-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 cpln | API Control Plane (api.cpln.io), реестр образов вашей организации (ORG.registry.cpln.io) и конечная точка метрик (metrics.cpln.io) с использованием вашего профиля CLI или CPLN_TOKEN |
docker | Реестры образов, в которые вы отправляете образы и из которых загружаете их |
kubectl, helm | Кластер Kubernetes, который вы укажете, при миграции с него или установке оператора Kubernetes Control Plane |
terraform, pulumi | API Control Plane через провайдер Control Plane |
gcloud и другие облачные CLI | Ваша собственная облачная учетная запись при подключении частной сети или создании виртуальной машины агента |
curl | Ваш собственный домен для проверки после настройки |
Сам плагин ничего не хранит. Созданные помощником ресурсы, файлы приложений и приглашения хранятся в вашей организации Control Plane, пока вы их не удалите; журнал аудита организации фиксирует каждое изменение.
Дополнительно
- Участие в разработке: CONTRIBUTING.md
- Документация: docs.controlplane.com · Поддержка:
support@controlplane.comили Slack - Лицензия: MIT — см. LICENSE