Быстро найдите нужный MCP tool, обязательные поля и рабочую форму запроса.
Типизированные tools для поиска задач и безопасного исполнения workflow
Раздел
Tools для discovery и context
- list_projects, get_project, get_projects_summary, list_project_users, list_project_teams, list_project_boards, list_project_stages.
- list_tasks, get_task, list_comments, get_comment, search_project_context.
- create_project и create_task создают реальные project/task сущности для IDE-driven intake flow.
- list_ready_packets, get_task_work_packet_context, get_task_context, get_task_dependencies, get_related_docs.
- connect_project_repo, get_repo_connection, disconnect_project_repo — подключение SSH-репозитория проекта; без подключения git-diff delivery proof невозможен (см. public pack: guides/repo-connection.md).
- Перед рискованной мутацией вызывайте validate_task_readiness и validate_boundary_safety.
Раздел
Tools для мутаций
- move_task_to_final_stage физически переносит карточку в board stage, помеченный как final; это не то же самое, что update_task_status.
- claim_work_packet, renew_claim, update_packet_status, release_work_packet.
- update_packet_contract — точечный патч контракта пакета до approve (contextBinding, boundaries, verificationCommands, expectedArtifacts).
- append_progress_comment, attach_artifact (git-diff-summary — предпочтительный delivery proof), submit_bughunt_iteration / get_finding, append_handoff_packet, open_recovery_wave, run_convergence_gate.
- propose_work_packets создаёт reviewable proposals вместо тихого коммита нового ready work.
{
"projectId": "project_1",
"packetId": "pkt_123",
"expectedPacketRevision": 7,
"expectedTaskRevision": 19,
"expectedContractVersion": 2,
"contextToken": "ctx_abc",
"idempotencyKey": "claim-20260509-1",
"leaseDurationSeconds": 900,
"runId": "run_14",
"waveId": "wave_14"
}Раздел
Багхант: submit_bughunt_iteration и get_finding
- Два леджера: 7 циклов scope=packet + packetId после git-diff-summary и до release completed; 7 циклов scope=card после всех пакетов и до Done. Пакетные охоты не открывают Done.
- 0 находок валидно, не выдумывать. Коммент REVIEW VERDICT: APPROVE охоту не заменяет. Early-stop до 7 запрещён.
- findings[]: только id, severity (blocker|major|minor), title, status (open|fixed). Нет file/line в payload. Локация — inspections[i].path, индекс совпадает с findings[i].
- remainingOpen = число findings со status=open в этом payload (может быть >0). 400 BUGHUNT_SCHEMA_INVALID, если число не совпало. Release/Done требуют remainingOpen=0 на последней охоте текущего head.
- После remainingOpen>0: фикс, новый коммит, следующий цикл с новым headCommit. Тот же head → 409 BUGHUNT_STALE_HEAD.
- Ответ submit содержит findings цикла + previousFindings: [{id,title,status}] без inspections. Полное тело — get_finding: плоский объект с единственным inspection (не {finding, inspections[]}).
- Дубликат title + inspections[i].path в одном леджере → 409 DUPLICATE_FINDING. Тот же title в другом path — не дубликат. Не переотправляйте тот же title+path со status=fixed.
- Code-пакет: уникальный focus из семи + inspections[] (path из filesChanged, quote ≥20, note ≥80). Два вызова быстрее 60с → 409 BUGHUNT_BURST: подождите и повторите, это не блокер Done.
remainingOpen не всегда 0
На каждом submit remainingOpen должен равняться числу open в этом findings[]. Всегда слать 0 при открытых багах — 400. Ноль нужен только на последней охоте текущего head перед release/Done.
{
"projectId": "project_1",
"taskId": "task_42",
"packetId": "pkt_123",
"scope": "packet",
"iteration": 1,
"headCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"focus": "correctness",
"findings": [
{
"id": "BH-1",
"severity": "major",
"title": "null check missing in parse",
"status": "open"
}
],
"remainingOpen": 1,
"inspections": [
{
"path": "src/parse.js",
"quote": "const value = input.data.value;",
"note": "parse() crashes on empty payload: input.data is undefined and becomes a user-facing 500. Add a guard and a regression test for the empty body."
}
],
"idempotencyKey": "bughunt:task_42:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa:1"
}Раздел
Обязательные CAS-поля
- expectedPacketRevision
- expectedTaskRevision
- expectedContractVersion
- contextToken
- idempotencyKey
- claimToken, если packet уже находится в claim
Следующие материалы
Связанные страницы
Справочник MCP resources
URI-шаблоны и resource-поверхности MCP Treker Zadachek: task context, ready queue, proposals, packets, runs и waves.
Справочник MCP prompts
Prompt-поверхности MCP Treker Zadachek для task brief, readiness, progress, декомпозиции, handoff и convergence.
Workflow work packet
Поймите жизненный цикл work packet в Treker Zadachek: от proposal и ready gate до claim, progress, artifact, handoff, recovery и convergence.
Ошибки и troubleshooting
Типовые ошибки Treker Zadachek MCP и API: auth, stale context, packet denial и каталог BUGHUNT_* / DUPLICATE_FINDING с recovery.
Коротко
О чём эта страница
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 и генерации клиентов.
Читать дальше