Конкретные flow: discovery, claim, progress, artifact, handoff

Примеры намеренно выстроены в реальном порядке workflow.

Не добавляйте progress или artifact в packet, который так и не вошёл в разрешённое execution state.

Самые полезные примеры повторяют живую стратегию MCP-to-API tests, которая уже используется в этом репозитории.

Раздел

Примеры API

create_project -> create_task -> Done stage

curl -X POST -H "Authorization: Bearer <external_api_key>" -H "Content-Type: application/json" \
  -d "{"title":"MCP Intake","description":"Created from IDE flow"}" \
  "https://treker-zadachek.ru/api/external/v1/projects"

curl -X POST -H "Authorization: Bearer <external_api_key>" -H "Content-Type: application/json" \
  -d "{"title":"Implement first packet","description":"Short task brief"}" \
  "https://treker-zadachek.ru/api/external/v1/projects/project_1/tasks"

curl -X POST -H "Authorization: Bearer <external_api_key>" \
  "https://treker-zadachek.ru/api/external/v1/projects/project_1/tasks/task_1/complete"

Раздел

Примеры workflow MCP

append_progress_comment после in_progress

{
  "projectId": "project_1",
  "packetId": "pkt_123",
  "expectedPacketRevision": 11,
  "expectedTaskRevision": 19,
  "expectedContractVersion": 2,
  "contextToken": "ctx_def",
  "idempotencyKey": "progress-1",
  "claimToken": "claim_tok_1",
  "text": "Реализован read path и подтверждена API parity.",
  "progressPercent": 60,
  "headCommit": "abc1234"
}

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

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

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

Готово

Справочник по TaskTracker MCP tools: discovery, lifecycle work packet, progress, artifact, handoff, recovery и convergence.

Быстрый старт с External API

Готово

Сделайте первый запрос к TaskTracker External API, проверьте auth и поймите базовые формы ответа и ошибки.

Ошибки и troubleshooting

Готово

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

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

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

Примеры

Примеры запросов для TaskTracker MCP и External API: ready discovery, claim, progress, artifact и handoff.

FAQ

С чего начать?

Начните с главной страницы docs, если сравниваете поверхности, с MCP quickstart - если подключаете agent runtime, или с API quickstart - если нужен первый curl-запрос.

В чём ключевое отличие TaskTracker?

TaskTracker не считает agent execution набором свободных комментариев к задаче. Он моделирует исполнение через work packet, lease, artifact, handoff и convergence.

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

README MCP server

mcp-server/README.md

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

Reference External API

docs/api/external-statistics-api.md

Семейства HTTP endpoint-ов, filters, shape ответа и примеры.

Контракт OpenAPI

docs/openapi/external-statistics-v1.yaml

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

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

Безопасность и модель доступа

Ошибки и troubleshooting