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 | Нет — destructive | slug | Публикует черновик как новую версию: следующие запуски используют её. |
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 учит агентов:
list_decisions— выбрать решение соstatusdeployed.get_decision— прочитатьstate_schemaи начать сexample_state.check_state— исправлять state, пока он не пройдёт проверку; это ничего не стоит.run_decision— запустить один раз, затем действовать поaction.
run_decision отправляет state так же, как API: объект, строку или массив, в зависимости от вида state решения. У него нет ключа идемпотентности: каждый вызов, дошедший до движка, выполняется и тарифицируется. Если вызов не прошёл из-за сети, поищите запуск через list_executions, прежде чем пробовать снова. Для повторов, безопасных по построению, вызывайте REST API с Idempotency-Key.
Создание решений
Агент может собрать решение от начала до конца:
get_template— начать с шаблона, если подходит.validate_schema— исправлять схему, пока в ней не останется проблем.create_decision— создать её как черновик.update_decision— дорабатывать черновик; в продакшене ничего не меняется.deploy_decision— опубликовать. Спросите пользователя перед этим шагом.
Записи выполняются от имени человека, создавшего API-ключ; ключ без автора отклоняется (FORBIDDEN). Удаление или отключение решения, команда, секреты назначений и оплата остаются в приложении.
Ошибки
| Где | Что вы получаете |
|---|---|
| HTTP + ошибка JSON-RPC | 401 без корректного 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, который читает ключ из окружения каждого человека:
{
"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-ключи, если он утёк.
Dcision в Claude Code
Подключите Claude Code к Dcision через MCP-сервер и навык Dcision — просматривайте, проверяйте и запускайте решения, пишите и валидируйте схемы решений, используйте CLI и SDK из агента.
Создание с агентом
Опишите решение простыми словами, и агент Dcision соберёт его в визуальном конструкторе — затем дорабатывайте его в чате, наблюдая за каждым изменением.