Быстрый старт MCP
Готово

Самый короткий путь от нулевой конфигурации до первого успешного MCP tool call.

Подключитесь, прогоните smoke test и проверьте ready queue

Скопируйте окружение, установите зависимости в mcp-server и запустите встроенный stdio smoke test.
Затем вызовите list_ready_packets или get_task_work_packet_context с валидной парой project и packet.
Если ready queue пустая, сначала проверьте capability routing, project scope и readiness задачи, а не считайте интеграцию сломанной.

Раздел

Установка и запуск

Локальная установка и запуск
cd mcp-server
npm install
npm run dev

Раздел

Первый полезный вызов

Вход для list_ready_packets
{
  "projectId": "project_1",
  "limit": 10,
  "runtimeKey": "copilot-runtime-1",
  "capabilityTags": ["backend-node-express"]
}

Раздел

Быстрая отладка

  • 401 обычно означает проблему с API key, 403 - отказ по scope или policy, а stale context - что ваш snapshot устарел.
  • Если ready discovery ничего не вернул, проверьте, есть ли в проекте ready packet и не отфильтровал ли их capability routing.
  • Если claim вернул queued вместо claimed, позже refetch context с новым idempotency key, а не придумывайте claim token вручную.
  • После git-diff-summary не закрывайте пакет: сначала 7 циклов `submit_bughunt_iteration` (`scope=packet` + `packetId`). Карточка Done — ещё 7 циклов `scope=card`. Каталог кодов: /docs/errors.
  • Если в runtime нет packet-tools (`submit_bughunt_iteration` отсутствует) — это degraded-mode, не суррогат леджера. Не выдумывайте циклы и не жмите Done.

Следующие материалы

Связанные страницы

Коротко

О чём эта страница

MCP Treker Zadachek

MCP Treker Zadachek — stdio-мост: отдаёт discovery, исполнение work packet, resources и prompts в supervised runtime агента, сохраняя backend scope и семантику отказов.

FAQ

Когда выбирать MCP вместо REST API?

Выбирайте MCP, когда вызывающая сторона - агент или supervised runtime, которому нужны tools, resources, prompts и workflow-safe мутации packet. REST нужен, когда достаточно прямого HTTP-контракта.

Почему MCP Treker Zadachek требует revision и context token?

Эти CAS-поля предотвращают stale write, делают retry явным и держат исполнение packet согласованным с последним состоянием backend.

Где copy-paste для багханта?

submit_bughunt_iteration и get_finding — на странице /docs/mcp/tools, ошибки — /docs/errors, пошагово — /docs/public-mcp?file=skills/execution.md §5b. remainingOpen = числу open, не всегда 0.

Источники

README MCP server

mcp-server/README.md

Главное публичное описание MCP-контракта и ожиданий к оператору.

Контракт OpenAPI

docs/openapi/external-statistics-v1.yaml

Machine-readable reference для tooling и генерации клиентов.

Читать дальше