Обзор MCP

Готово

Для agent builders, platform engineers и supervisors, которые встраивают TaskTracker в MCP-совместимый runtime.

Откройте workflow TaskTracker как agent-ready MCP surface

TaskTracker MCP работает поверх stdio и идёт в external TaskTracker API с тем же project scope и той же семантикой отказов.

Bridge намеренно сохраняет backend error envelope, а не прячет его за generic tool failure.

Write tools здесь workflow-safe: им нужны актуальные revision, context token, idempotency key и claim token, когда packet уже находится в lease.

Раздел

Transport и аутентификация

Transport: stdio.
Auth: существующий TaskTracker external API key.
Модель доступа: тот же project scope, который уже enforced в /api/external/v1.

Переменные окружения

TASKTRACKER_BASE_URL=https://treker-zadachek.ru
TASKTRACKER_API_KEY=<external_api_key>
TASKTRACKER_TIMEOUT_MS=15000

Раздел

Что уже реализовано

Tools покрывают project/task creation, discovery, ready queue, context validation, lifecycle claim, progress, artifact, handoff, recovery и convergence.
Resources отдают summary проекта, task context packet, ready queue, proposals, packet context, dependencies, convergence, run и wave.
Prompts помогают supervised operator собрать следующий execution brief, review readiness, progress update, handoff packet и convergence summary.

Раздел

Правила workflow safety

Bridge не должен auto-retry stale context failure; сначала refetch context, потом осознанный retry.
Отказы сохраняют PACKET_AUTHORIZATION_DENIED и denialCode, чтобы вызывающая сторона видела настоящую бизнес-причину.
Крупные поля context обрезаются на transport-уровне только с явной пометкой truncation metadata, а не молча.

Диаграмма

MCP bridge flow

TaskTracker MCP не живёт отдельно от основного продукта: он переносит существующий scoped API и backend-сервисы в agent runtime.

Agent runtime

↓

MCP stdio bridge

↓

TaskTracker client

↓

External API

↓

Backend services

↓

PostgreSQL

Политика supervised execution

TaskTracker MCP оптимизирован под supervised agents. Он должен объяснять, почему мутация заблокирована, а не прятать причину за generic retry loop.

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

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

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

Готово

Подключите TaskTracker MCP server, прогоните stdio smoke test и выполните первый вызов к ready queue.

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

Готово

Справочник по TaskTracker MCP tools: discovery, lifecycle work packet, progress, artifact, handoff, recovery и 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 и генерации клиентов.

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

Документация TaskTracker

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