Dcision в Claude Code
Подключите Claude Code к Dcision через MCP-сервер и навык Dcision — просматривайте, проверяйте и запускайте решения, пишите и валидируйте схемы решений, используйте CLI и SDK из агента.
Claude Code может работать с Dcision двумя взаимодополняющими способами:
- MCP-сервер даёт Claude инструменты: просматривать список ваших решений, читать их контракт, проверять state, запускать решение, читать выполнения, просматривать шаблоны и валидировать схему.
- Навык Dcision даёт Claude понимание: как работают решения, как написать корректную схему решения, какие вызовы тарифицируются и каких ошибок избегать. Он также учит Claude использовать API через
curl, когда MCP-сервер не подключён.
Установите оба. Каждый ставится одной командой.
Перед началом
Создайте API-ключ на app.dcision.io/api-keys и экспортируйте его в оболочке, из которой запускаете Claude Code:
export DCISION_API_KEY="dcs_test_…"Начните с тестового ключа
Пока экспериментируете, используйте ключ dcs_test_…. Запуски с тестовым ключом настоящие и учитываются в использовании, но назначения доставляют их с livemode: false, поэтому ваша CRM и workflow могут их отличить. Переходите на ключ dcs_live_…, когда агент запускает решения для продакшена.
Подключение MCP-сервера
MCP-сервер Dcision работает по адресу https://api.dcision.io/mcp (Streamable HTTP) и аутентифицирует каждый запрос вашим API-ключом как Bearer-токеном.
claude mcp add --transport http dcision https://api.dcision.io/mcp \
--header "Authorization: Bearer $DCISION_API_KEY" \
--scope userОболочка подставляет $DCISION_API_KEY при запуске команды, а Claude Code сохраняет заголовок в вашей пользовательской конфигурации (~/.claude.json) — вне репозитория.
Чтобы поделиться сервером с командой, вместо этого закоммитьте .mcp.json в корень репозитория. Claude Code подставляет ${DCISION_API_KEY} из окружения каждого человека, поэтому в файле нет секрета:
{
"mcpServers": {
"dcision": {
"type": "http",
"url": "https://api.dcision.io/mcp",
"headers": { "Authorization": "Bearer ${DCISION_API_KEY}" }
}
}
}Не используйте claude mcp add --scope project с заголовком выше: эта команда записывает подставленный ключ в .mcp.json. Напишите файл вручную с плейсхолдером ${DCISION_API_KEY}.
Проверьте подключение командой claude mcp list или /mcp внутри сессии: dcision должен быть connected с четырнадцатью инструментами. 401 означает, что ключ отсутствует, некорректен или отозван.
Установка навыка
Навык — это один файл SKILL.md, опубликованный вместе с этой документацией:
mkdir -p ~/.claude/skills/dcision
curl -fsSL https://docs.dcision.io/skills/dcision/SKILL.md -o ~/.claude/skills/dcision/SKILL.mdClaude Code загружает его сам, когда в запросе упоминаются Dcision, slug решения, схема решения или маршрутизация и классификация с помощью Dcision. Чтобы обновить навык, выполните ту же команду ещё раз. Навык следует открытому формату Agent Skills, поэтому его могут использовать и другие агенты, которые читают файлы SKILL.md.
Попробуйте
Спрашивайте обычным языком — Claude сам выберет инструменты:
- «Какие решения Dcision у меня есть и какие из них опубликованы?»
- «Покажи, что ожидает
lead-qualification, и пример state». - «Запусти
support-routingна этом тикете и скажи мне маршрут и действие». - «Проверь, являются ли эти пять payload корректными state для
lead-qualification, — не запускай их». - «Напиши схему решения, которая классифицирует входящие письма на billing, technical и sales, эскалирует срочные, и провалидируй её».
- «Начни с шаблона
ticket-triageи адаптируй его под наши категории». - «Сколько решений мы использовали в этом месяце и сколько неудачных запусков было у
spam-detectionсегодня?»
Создание, редактирование и публикация решений остаются в приложении: Claude пишет и валидирует схему, вы вставляете её в редактор решения, тестируете в Playground и публикуете.
Инструменты
| Инструмент | Тарифицируется | Что делает |
|---|---|---|
get_account | Нет | Рабочее пространство ключа, сам ключ, тариф и использование за этот период — как GET /v1/me. |
list_decisions | Нет | Решения рабочего пространства: slug, название, статус и активная версия — как GET /v1/decisions. |
get_decision | Нет | Контракт одного решения: схема state, вопросы и варианты, действия и пример state. |
check_state | Нет | Проверяет state по схеме state решения, не запуская его. |
run_decision | Да | Выполняет активную версию на state — как POST /v1/decisions/{slug}. |
list_executions | Нет | Недавние запуски с ответами, действием и метриками — без входных данных. |
list_templates | Нет | Встроенные шаблоны. |
get_template | Нет | Полная схема решения одного шаблона. |
validate_schema | Нет | Валидирует схему решения офлайн по правилам редактора. |
create_decision | Нет | Создаёт черновик решения из схемы. |
update_decision | Нет | Редактирует схему черновика, название или описание. |
deploy_decision | Нет | Публикует черновик: следующие запуски используют его. |
list_workspaces | Нет | Режим партнёра: подпространства ваших клиентов. |
upsert_workspace | Нет | Режим партнёра: создаёт или переименовывает подпространство клиента. |
run_decision — единственный инструмент, который стоит денег. Он и три инструмента записи не помечены как read-only, а deploy_decision помечен как destructive. Claude Code спрашивает разрешение перед вызовом MCP-инструмента, пока вы его не разрешите: свободно разрешайте инструменты только для чтения, а run_decision и deploy_decision оставляйте за подтверждением. Входы, выходы и ошибки каждого инструмента описаны в справочнике MCP.
CLI и SDK из Claude Code
Claude Code также может управлять CLI в терминале — удобно для схем, которые хранятся в вашем репозитории:
dcision validate decision.json
dcision check-state decision.json --state-file samples/lead-1.json
dcision decide lead-qualification --state-file samples/lead-1.json --jsonCLI и SDK пока не опубликованы в npm и PyPI: собирайте их из checkout репозитория Dcision (pnpm --filter "@dcision/cli..." build). Навык велит Claude не устанавливать пакеты с этими именами из реестра.
Когда Claude пишет код приложения, который вызывает Dcision, направляйте его к TypeScript SDK или Python SDK — dcision.decide("lead-qualification", state) с безопасными повторами — или к обычному HTTPS, как в разделе Запуск решения.
Без MCP-сервера
Навык работает и без MCP-сервера: с DCISION_API_KEY в окружении Claude вызывает REST API через curl, а для инструментов, которых нет в REST, — validate_schema, check_state и шаблонов — тот же MCP-сервер по обычному HTTP. См. Вызов сервера через curl.
Безопасность
- Ключи остаются вне репозитория. Используйте плейсхолдер
${DCISION_API_KEY}в.mcp.json, никогда не сам ключ, и не вставляйте ключи в чат. - Ключ может делать то же, что и API, для своего рабочего пространства: читать его решения и выполнения и запускать решения. Он не может создавать, редактировать или публиковать решения, управлять участниками или оплатой — для этого нужен пользователь, вошедший в приложение.
- Запуски тарифицируются.
run_decisionучитывается как любой вызов API: одно решение за запуск, сколько бы ни было вопросов. Попросите Claude сначала запустить выборку, прежде чем он запустит весь набор данных, и следите за использованием черезget_account. - Выполнения никогда не возвращают входные данные.
list_executions, как иGET /v1/executions, не возвращает отправленные вами state. - Отзовите ключ в разделе API-ключи, если он утёк; API и MCP-сервер отклоняют отозванный ключ.
Другие клиенты
Cursor, VS Code, Claude Desktop, Codex и Gemini CLI подключаются к тому же серверу — см. MCP-сервер.
Встраивание редактора
Позвольте клиентам создавать, редактировать, тестировать и публиковать свои решения внутри вашего приложения — сессии встраивания с вашего бэкенда, скрипт @dcision/embed, права и события.
MCP-сервер
MCP-сервер Dcision по адресу https://api.dcision.io/mcp — аутентификация, четырнадцать инструментов с их входами и выходами, ошибки и настройка для Claude Code, Cursor, VS Code, Claude Desktop, Codex, Gemini CLI и curl.