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} из окружения каждого человека, поэтому в файле нет секрета:

.mcp.json
{
  "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.md

Claude 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 --json

CLI и 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-сервер.

На этой странице