MCP-сервер

MCP-сервер Dcision по адресу https://api.dcision.io/mcp — аутентификация, четырнадцать инструментов с их входами и выходами, ошибки и настройка для Claude Code, Cursor, VS Code, Claude Desktop, Codex, Gemini CLI и curl.

Endpoint    https://api.dcision.io/mcp
Transport   Streamable HTTP (stateless, JSON responses)
Auth        Authorization: Bearer dcs_live_… | dcs_test_…

Сервер Model Context Protocol позволяет ИИ-агентам и ассистентам для программирования пользоваться Dcision: просматривать список ваших решений, читать их контракт, проверять и запускать state, читать выполнения, просматривать шаблоны и валидировать схемы решений. Он — часть API Dcision: те же ключи, те же лимиты, та же тарификация, что и у REST API.

Пошаговую настройку в Claude Code вместе с навыком Dcision см. в разделе Dcision в Claude Code.

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

Отправляйте API-ключ рабочего пространства как Bearer-токен в каждом запросе. Сервер не хранит ни сессий, ни учётных данных: каждый запрос аутентифицируется отдельно, а инструменты действуют в рабочем пространстве ключа.

  • Нет ключа, ключ некорректен или отозван → HTTP 401 с заголовком WWW-Authenticate: Bearer и сообщением, где создать ключ.
  • Принимаются только API-ключи — никогда сессия из приложения.
  • Пока экспериментируете, предпочитайте ключ dcs_test_…: запуски настоящие и учитываются в использовании, но назначения доставляют их с livemode: false.

Лимиты и тарификация

Каждый запросУчитывается в окне лимита запросов на чтение, общем с GET /v1/me, GET /v1/decisions и GET /v1/executions. Чтения не тарифицируются.
run_decisionУчитывается также в окне решений, общем с POST /v1/decisions/{slug}. Тарифицируется как вызов API, с той же квотой.
ЗапросыТолько POST /mcp. GET /mcp и DELETE /mcp отвечают 405: нет ни сессий, ни потока server-sent events.
Размер телаДо 1 MB, поэтому validate_schema, create_decision и update_decision принимают большие схемы (промпты агентов — до 32 000 символов). state в check_state и run_decision по-прежнему ограничен 128 KB (INVALID_STATE). Более крупные тела получают ответ 413 PAYLOAD_TOO_LARGE.

Инструменты

Каждый инструмент возвращает результат в виде JSON — текстом в content результата и как structuredContent. Инструменты чтения помечены readOnlyHint: true. run_decision, create_decision, update_decision и deploy_decision помечены как не read-only и не идемпотентные, а deploy_decision — ещё и как destructive (он меняет то, что выполняется в продакшене), поэтому клиенты могут спрашивать разрешение перед их вызовом.

ИнструментТолько чтениеАргументыВозвращает
get_accountДа—Рабочее пространство ключа, сам ключ, тариф и использование за этот период — тело GET /v1/me.
list_decisionsДа—Решения рабочего пространства со slug, названием, статусом и активной версией — тело GET /v1/decisions.
get_decisionДаslugКонтракт одного решения — схема state, вопросы с вариантами, действия, fallback-действие и пример state — тело GET /v1/decisions/{slug}.
check_stateДаslug, state{ "valid": true } или { "valid": false, "message" } с причиной, по которой запуск завершился бы ошибкой 422 INVALID_STATE. Проверяет схему state активной версии и собственный лимит токенов state; ничего не выполняется. Запуск всё равно может ответить 422, когда state плюс самый длинный вопрос превышают бюджет токенов движка.
run_decisionНет — тарифицируетсяslug, state, необязательный include_probabilities (boolean)Ответ решения в том виде, в каком его возвращает POST /v1/decisions/{slug}.
list_executionsДанеобязательные decision (slug), status (success или error), limit (1–100, по умолчанию 20), cursorНедавние выполнения, без входных данных — тело GET /v1/executions.
list_templatesДа—{ "data": [...] } с id, name, description, category и patterns каждого шаблона.
get_templateДаidСводка шаблона плюс его полная схема решения в schema и sample_state.
validate_schemaДаschema (object){ "valid": true, "schema" } с нормализованной схемой — other добавлен, значения по умолчанию заполнены — или { "valid": false, "issues": [{ "path", "message" }] }. Те же правила, что в редакторе и API.
create_decisionНетname (1–80), schema (object), необязательные slug, description (≤ 500)Создаёт черновик решения. Возвращает решение с его slug и status: "draft". Учитывается в лимите решений тарифа (PLAN_LIMIT_REACHED).
update_decisionНетslug, необязательные schema, name, descriptionЗаменяет схему черновика и/или переименовывает решение. То, что выполняется, не меняется до deploy_decision.
deploy_decisionНет — destructiveslugПубликует черновик как новую версию: следующие запуски используют её.
list_workspacesДанеобязательные external_id, limit (1–100), cursorРежим партнёра: ваши подпространства с лимитами и использованием — тело GET /v1/workspaces.
upsert_workspaceНетexternal_id, name, необязательные seed_decisions (slug), deploy (boolean)Режим партнёра: создаёт подпространство клиента (или переименовывает его), по желанию копируя в него опубликованные решения.

Каждый инструмент публикует свою точную схему входных данных в tools/list: читайте её там, когда создаёте собственного клиента.

Действия в подпространстве

Партнёры отправляют заголовок Dcision-Workspace: ext:<external_id> (или id подпространства) со своим API-ключом: тогда каждый инструмент читает, запускает, создаёт и публикует в подпространстве этого клиента, а лимит запросов остаётся лимитом вашего рабочего пространства. Подпространство другого рабочего пространства отвечает 404 (ошибка JSON-RPC -32004).

claude mcp add --transport http dcision-acme https://api.dcision.io/mcp \
  --header "Authorization: Bearer $DCISION_API_KEY" --header "Dcision-Workspace: ext:acme"

Запуск решений

Обычный порядок действий, которому навык Dcision учит агентов:

  1. list_decisions — выбрать решение со status deployed.
  2. get_decision — прочитать state_schema и начать с example_state.
  3. check_state — исправлять state, пока он не пройдёт проверку; это ничего не стоит.
  4. run_decision — запустить один раз, затем действовать по action.

run_decision отправляет state так же, как API: объект, строку или массив, в зависимости от вида state решения. У него нет ключа идемпотентности: каждый вызов, дошедший до движка, выполняется и тарифицируется. Если вызов не прошёл из-за сети, поищите запуск через list_executions, прежде чем пробовать снова. Для повторов, безопасных по построению, вызывайте REST API с Idempotency-Key.

Создание решений

Агент может собрать решение от начала до конца:

  1. get_template — начать с шаблона, если подходит.
  2. validate_schema — исправлять схему, пока в ней не останется проблем.
  3. create_decision — создать её как черновик.
  4. update_decision — дорабатывать черновик; в продакшене ничего не меняется.
  5. deploy_decision — опубликовать. Спросите пользователя перед этим шагом.

Записи выполняются от имени человека, создавшего API-ключ; ключ без автора отклоняется (FORBIDDEN). Удаление или отключение решения, команда, секреты назначений и оплата остаются в приложении.

Ошибки

ГдеЧто вы получаете
HTTP + ошибка JSON-RPC401 без корректного API-ключа (с WWW-Authenticate: Bearer), 429, когда окно чтения исчерпано, 405 для любого метода, кроме POST, 406 без Accept: application/json, text/event-stream, 400 для пакета JSON-RPC (отправляйте одно сообщение на запрос). Тело — error JSON-RPC, чей message говорит, что делать. Тело, которое вообще не является JSON, получает собственный объект ошибки API 400 INVALID_REQUEST.
Результат инструментаisError: true и { "error": { "code", "message", "details" } } текстом — для всего, на что API ответил бы ошибкой: DECISION_NOT_FOUND, DECISION_NOT_DEPLOYED, INVALID_STATE, CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDED, RATE_LIMITED на run_decision, ошибки движка, — а также для неизвестного инструмента (NOT_FOUND) или некорректных аргументов (INVALID_REQUEST, с каждой проблемой в details). См. Ошибки.

Агент должен прочитать message ошибки — там сказано, что исправить, — и не повторять 4xx без изменений.

Claude Code

claude mcp add --transport http dcision https://api.dcision.io/mcp \
  --header "Authorization: Bearer $DCISION_API_KEY" \
  --scope user

Уберите --scope user, чтобы добавить сервер только в текущий проект, или закоммитьте .mcp.json, который читает ключ из окружения каждого человека:

.mcp.json
{
  "mcpServers": {
    "dcision": {
      "type": "http",
      "url": "https://api.dcision.io/mcp",
      "headers": { "Authorization": "Bearer ${DCISION_API_KEY}" }
    }
  }
}

Подробнее — в разделе Dcision в Claude Code.

Другие клиенты

Подключиться может любой MCP-клиент, поддерживающий удалённые серверы по Streamable HTTP с пользовательским заголовком.

{
  "mcpServers": {
    "dcision": {
      "url": "https://api.dcision.io/mcp",
      "headers": { "Authorization": "Bearer ${env:DCISION_API_KEY}" }
    }
  }
}
  • Cursor — ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в репозитории.
  • VS Code — .vscode/mcp.json; VS Code один раз спрашивает ключ и надёжно его хранит.
  • Claude Desktop — Settings → Developer → Edit Config (claude_desktop_config.json). Claude Desktop подключается к удалённым серверам через mcp-remote — мост от сообщества, которому нужен Node.js; заголовок передаётся через переменную окружения, чтобы пробел после Bearer сохранялся на любой платформе. После редактирования перезапустите Claude Desktop.
  • Codex — ~/.codex/config.toml, с DCISION_API_KEY, экспортированным там, где запускается Codex.
  • Gemini CLI — ~/.gemini/settings.json или .gemini/settings.json в проекте.

ChatGPT и claude.ai

Коннекторы в ChatGPT и на claude.ai входят через OAuth, которого MCP-сервер Dcision пока не предлагает: он принимает только API-ключ в заголовке. Используйте один из клиентов выше или REST API.

Вызов сервера через curl

Сервер работает по обычному JSON-RPC 2.0 поверх HTTP и не хранит состояния — рукопожатие initialize не нужно. Отправляйте Content-Type: application/json и Accept: application/json, text/event-stream:

curl -s https://api.dcision.io/mcp \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Вызывайте инструмент через tools/call, указав его name и arguments:

curl -s https://api.dcision.io/mcp \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": { "name": "get_decision", "arguments": { "slug": "lead-qualification" } }
  }' | jq '.result.structuredContent'

Ответ — это ответ JSON-RPC: result.content[0].text содержит JSON инструмента в виде текста, а result.structuredContent — то же значение в виде объекта (сокращённо):

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "{\"slug\": \"lead-qualification\", \"status\": \"deployed\", \"version\": 3}" }],
    "structuredContent": { "slug": "lead-qualification", "status": "deployed", "version": 3 }
  }
}

Так же навык Dcision обращается к validate_schema, check_state и шаблонам, когда MCP-клиент не настроен.

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

  • Сервер действует только в рабочем пространстве ключа; ключ не может добраться до решений другого рабочего пространства.
  • Инструменты никогда не возвращают входные данные прошлых выполнений, секреты, конфигурацию назначений (URL, заголовки) или полную схему решения — только контракт его активной версии. Результаты run_decision и list_executions включают записи destinations каждого запуска, которые могут нести значения, сопоставленные из state (параметры функций, ответы LLM или агентов): обращайтесь с ними как с любым выводом решения.
  • Обращайтесь с ключом, которым пользуется агент, как с любым продакшен-секретом: храните его в окружении, во время экспериментов ограничивайтесь тестовым ключом и отзовите его в разделе API-ключи, если он утёк.

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