Самый короткий путь от нулевой конфигурации до первого успешного MCP tool call.
Подключитесь, прогоните smoke test и проверьте ready queue
Раздел
Установка и запуск
cd mcp-server
npm install
npm run devРаздел
Первый полезный вызов
{
"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-транспорт, аутентификация, безопасные записи и ожидания execution contract.
Справочник MCP tools
Справочник MCP tools Treker Zadachek: discovery, жизненный цикл work packet, progress, artifact, багхант, handoff, recovery и convergence.
Ошибки и troubleshooting
Типовые ошибки Treker Zadachek MCP и API: auth, stale context, packet denial и каталог BUGHUNT_* / DUPLICATE_FINDING с recovery.
Безопасность и модель доступа
Модель безопасности Treker Zadachek MCP и External API: project scope, работа с API key, token redaction и безопасное поведение оператора.
Коротко
О чём эта страница
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 и генерации клиентов.
Читать дальше