Конкретные сценарии: discovery, claim, progress, artifact, handoff

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

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

Самые полезные примеры повторяют живую стратегию MCP→API тестов из этого репозитория.

Раздел

Примеры 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

Готово

Справочник MCP tools Treker Zadachek: discovery, жизненный цикл work packet, progress, artifact, handoff, recovery и convergence.

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

Готово

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

Ошибки и troubleshooting

Готово

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

Коротко

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

Примеры

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

FAQ

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

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

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

Treker Zadachek не сводит работу агента к свободным комментариям. Исполнение моделируется через 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