Подключитесь, прогоните smoke test и проверьте ready queue

Скопируйте окружение, установите зависимости в mcp-server и запустите встроенный stdio smoke test.

Затем вызовите list_ready_packets или get_task_work_packet_context с валидной парой project и packet.

Если ready queue пустая, сначала проверьте capability routing, project scope и readiness задачи, а не считайте интеграцию сломанной.

Раздел

Установка и запуск

Локальная установка и запуск

cd mcp-server
npm install
npm run dev

Раздел

Первый полезный вызов

Вход для list_ready_packets

{
  "projectId": "project_1",
  "limit": 10,
  "runtimeKey": "copilot-runtime-1",
  "capabilityTags": ["backend-node-express"]
}

Раздел

Быстрая debug-проверка

401 обычно означает проблему с API key, 403 - отказ по scope или policy, а stale context - что ваш snapshot устарел.
Если ready discovery ничего не вернул, проверьте, есть ли в проекте ready packet и не отфильтровал ли их capability routing.
Если claim вернул queued вместо claimed, позже refetch context с новым idempotency key, а не придумывайте claim token вручную.

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

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

Обзор TaskTracker MCP

Готово

Поймите, как устроены TaskTracker MCP bridge, stdio transport, модель аутентификации, workflow-safe записи и ожидания execution contract.

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

Готово

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

Ошибки и troubleshooting

Готово

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

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

Готово

Модель безопасности TaskTracker MCP и External API: project scope, работа с API key, token redaction и безопасное поведение оператора.

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

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

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 и генерации клиентов.

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

Обзор TaskTracker MCP

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