Typed tools для поиска задач и workflow-safe исполнения

Discovery tools help list projects, tasks, boards, teams, comments, analytics, and markdown documents.

Execution tools handle ready discovery, context validation, claim lifecycle, status changes, progress, artifacts, handoff, recovery, and convergence.

Most packet mutations require a fresh packet context snapshot before the call.

Раздел

Tools для discovery и context

list_projects, get_project, list_tasks, get_task, list_comments, get_comment.
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.
validate_task_readiness and validate_boundary_safety before making a risky mutation.

Раздел

Tools для мутаций

move_task_to_final_stage физически переносит карточку в board stage, помеченный как final; это не то же самое, что update_task_status.
claim_work_packet, renew_claim, update_packet_status, release_work_packet.
append_progress_comment, attach_artifact, 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"
}

Раздел

Обязательные CAS-поля

expectedPacketRevision
expectedTaskRevision
expectedContractVersion
contextToken
idempotencyKey
claimToken, если packet уже находится в claim

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

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

Справочник MCP resources

Готово

URI templates и resource surfaces в TaskTracker MCP: task context, ready queue, proposals, packets, runs и waves.

Справочник MCP prompts

Готово

Prompt surfaces, которые TaskTracker MCP публикует для task brief, readiness review, progress update, decomposition, handoff и convergence.

Workflow work packet

Готово

Поймите жизненный цикл work packet в TaskTracker: от proposal и ready gate до claim, progress, artifact, handoff, recovery и convergence.

Ошибки и troubleshooting

Готово

Типовые ошибки TaskTracker MCP и API: проблемы auth, отказы доступа, stale context и packet authorization denial.

Коротко по странице

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

TaskTracker MCP

TaskTracker MCP - это stdio bridge, который отдаёт discovery, исполнение work packet, resources и prompts в supervised agent runtime, сохраняя backend scope и семантику отказов.

FAQ

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

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

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

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

Где смотреть детали

README MCP server

mcp-server/README.md

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

Контракт OpenAPI

docs/openapi/external-statistics-v1.yaml

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

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

Быстрый старт с MCP

Справочник MCP resources