MCP-сервер DeckOps

DeckOps отдаёт свои возможности ИИ-агентам по протоколу MCP: Claude Code, Cursor и другие клиенты могут создавать проекты из стартовых наборов, продвигать релизы, смотреть статус, логи и метрики, стандарт качества и AI-готовность — с теми же правами, что у пользователя в UI.

Адрес сервера: https://api.deckops.dev/mcp. Транспорт — streamable HTTP без состояния, ответы в JSON (без SSE).

Аутентификация

Сервер принимает два вида учётных данных в заголовке Authorization.

Личный токен (Bearer)

Для работы от своего имени.

В DeckOps откройте меню аккаунта → Личные токены и MCP.
Создайте токен и выберите области:
- read (Чтение) — только чтение;
- write (Изменения) — создание проектов, запуск действий, удаление проекта и сброс контура;
- deploy (Деплой и откаты) — продвижение, одобрение и откат релизов.
Области не включают друг друга: агенту, который создаёт и выкатывает проекты, нужны write и deploy.
Скопируйте значение dop_… — оно показывается один раз. Срок жизни — от 1 до 365 дней, по умолчанию 90.

Токен действует от вашего имени в текущей организации. MCP-сервер обменивает его на токен API на 15 минут и кэширует; отозванный токен перестаёт работать сразу.

Authorization: Bearer dop_<…>

Учётные данные приложения (Basic)

Для сервисных агентов без привязки к человеку: создайте приложение в Админка → Учётные данные → Приложения и передайте clientId:clientSecret в Basic-аутентификации.

Authorization: Basic base64(<clientId>:<clientSecret>)

AUTH=$(printf '%s:%s' "$CLIENT_ID" "$CLIENT_SECRET" | base64)
claude mcp add --transport http deckops https://api.deckops.dev/mcp --header "Authorization: Basic $AUTH"

примечание

Действия в проектах проверяют членство в команде проекта. Для работы с проектами надёжнее личный токен пользователя-участника команды; учётку приложения используйте для каталога, self-service действий и чтения.

Подключение

Claude Code:

claude mcp add --transport http deckops https://api.deckops.dev/mcp --header "Authorization: Bearer <token>"

Cursor: в настройках MCP добавьте сервер с тем же URL и заголовком Authorization.

Для агентов есть скилл deckops-mcp (репозиторий dev-portal/skills): положите каталог скилла в ~/.claude/skills/ или .claude/skills/ проекта.

Инструменты

Группа	Инструмент	Что делает
Кто я	`whoami`	Пользователь, организация и роли
Каталог	`list_blueprints`	Blueprints каталога
	`search_entities`	Сущности blueprint'а
	`get_entity`	Одна сущность
	`get_scorecards`	Scorecards blueprint'а
Self-service	`list_actions`	Действия self-service
	`run_action`	Запуск действия
	`get_run`	Статус запуска
	`approve_run`	Одобрить или отклонить запуск
Проекты	`list_teams`	Команды (id нужен для `create_project`)
	`list_starter_kits`	Стартовые наборы
	`list_cicd_flows`	Опубликованные CI/CD flow
	`list_environments`	Контуры в порядке продвижения
	`list_clusters`	Кластеры и их режим
	`create_project`	Создать проект: идентификатор, команда, набор, flow, контуры, ресурсы
	`get_project`, `list_projects`	Проект, список проектов
	`get_project_status`	Реплики, поды, рестарты и предупреждения по контурам
	`get_order`	Заказ и его шаги
	`list_orders_queue`	Последние 50 заказов
Релизы	`list_deployments`	Релизы по контурам
	`get_pipeline`	Цепочка контуров, текущие релизы, гейты
	`promote`	Продвинуть релиз в следующий контур
	`approve_deployment`	Одобрить ожидающий релиз
	`rollback`	Откатить контур
Наблюдаемость	`get_project_logs`	Логи приложения
	`get_project_metrics`	Последние значения метрик и бронь
Качество и AI	`get_quality`	Результат по стандарту качества
	`run_ai_audit`	Запустить аудит AI-готовности
	`get_ai_readiness`	Балл, уровень и история
Разрушительные	`delete_project`, `rollback`, `reset_environment`	Удаление проекта, откат, сброс контура

Разрушительные инструменты помечены destructiveHint и выполняются только с confirmed_by_user=true: агент обязан сначала спросить вас. Права те же, что в UI: например, promote в prod без роли лида создаст релиз, ожидающий одобрения.

Пример: новый сервис

list_teams, list_starter_kits, list_cicd_flows, list_environments — выбрать команду, набор, flow и контуры.
create_project с идентификатором [a-z0-9-] и контурами — проект создаётся заказом.
get_project — дождаться статуса active; первый деплой делает CI репозитория.
get_pipeline и get_project_status — убедиться, что релиз в первом контуре работает.

Действия через MCP попадают в заказы с источником mcp+pat (личный токен) или mcp-app (учётка приложения), так что в истории видно, откуда они пришли.

Аутентификация​

Личный токен (Bearer)​

Учётные данные приложения (Basic)​

Подключение​

Инструменты​

Пример: новый сервис​