Инструменты MCP
Готово

Быстро найдите нужный MCP tool, обязательные поля и рабочую форму запроса.

Типизированные tools для поиска задач и безопасного исполнения workflow

Discovery-tools помогают получить projects, tasks, boards, teams, comments, analytics и markdown-документы.
Execution-tools закрывают ready discovery, проверку контекста, claim, смену статуса, progress, artifacts, багхант, handoff, recovery и convergence.
Большинство мутаций пакета требуют свежий snapshot packet context перед вызовом.

Раздел

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.
Payload для claim_work_packet
{
  "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.

Payload для submit_bughunt_iteration (scope=packet, 1 open)
{
  "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 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 и генерации клиентов.

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