Обзор MCP

Готово

Для разработчиков агентов, platform-инженеров и супервайзеров, которые встраивают Treker Zadachek в MCP-runtime.

Подключите workflow Treker Zadachek как готовую MCP-поверхность для агентов

MCP Treker Zadachek работает через stdio и ходит во External API с тем же project scope и той же семантикой отказов.

Мост сохраняет backend error envelope и не прячет бизнес-ошибку за общим tool failure.

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

Раздел

Транспорт и аутентификация

Transport: stdio.
Auth: действующий external API key Treker Zadachek.
Модель доступа: тот же 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, discovery, ready queue, проверку контекста, claim, progress, artifact, handoff, recovery и convergence.
Resources отдают сводку проекта, task/packet context, ready queue, proposals, зависимости, convergence, run и wave.
Prompts помогают оператору собрать следующий brief, проверить readiness, оформить progress, handoff и convergence summary.

Раздел

Правила workflow safety

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

Диаграмма

MCP bridge flow

MCP Treker Zadachek не отдельный продукт: он переносит scoped API и backend-сервисы в runtime агента.

Runtime агента

MCP stdio-мост

Клиент Treker Zadachek

External API

Backend-сервисы

PostgreSQL

Политика supervised execution

MCP Treker Zadachek рассчитан на supervised-агентов: объясняет, почему мутация заблокирована, а не прячет причину за общим retry.

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

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

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

Готово

Подключите MCP-сервер Treker Zadachek, прогоните stdio smoke test и сделайте первый вызов к ready queue.

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

Готово

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

Workflow work packet

Готово

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

Ошибки и troubleshooting

Готово

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

Коротко

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

MCP Treker Zadachek

MCP Treker Zadachek — stdio-мост: отдаёт discovery, исполнение work packet, resources и prompts в supervised runtime агента, сохраняя backend scope и семантику отказов.

FAQ

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

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

Почему MCP Treker Zadachek требует 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 и генерации клиентов.

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

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