MCP-инструменты

Инструменты Work Graph, доступные AI-агентам.

Зачем MCP в Work Graph

MCP — основной способ, которым IDE-агенты читают бэклог, контракты и доказательства. HTML-сайт для людей; инструменты MCP — для программного доступа к тем же данным в git.

Перед созданием задач используйте /api/docs/bvc-authoring-context. Полная схема инструментов: /api/docs/mcp-tools-context.

Инструменты P0

Инструмент	Вход	Выход	Когда вызывать
`create_work_item`	`workId`, `title`, `basis`, `vector`, `goal`	`workId`, `path`	Новая задача с BVC-контрактом
`get_work_contract`	`workId`	`workId`, `contract`	Перед правками и для scope
`assert_task_ready_for_done`	`workId`	`ok`, `missing[]`	Перед переводом в done

Типовой сценарий агента

Прочитать контракт — get_work_contract(workId) → Базис, Вектор, Цель, target_files, checks.
Захватить задачу — claim_work_item (если политика проекта требует явного claim).
Исполнить — правки только в allowlist; команды только из разрешённого списка.
Прикрепить evidence — вывод тестов, трассы, structured records (submit_evidence и связанные пути по версии MCP).
Проверить готовность — assert_task_ready_for_done; при ok: false закрывать задачу нельзя.

Ошибки инструментов

Код	Смысл	Действие
`duplicate_work_id`	`work.id` уже есть	Новый id или обновление существующего атома
`invalid_bvc_section`	Нет Базиса, Вектора или Цели	Дополнить контракт
`missing_evidence`	Нет proof для Tier A	Запустить checks, приложить логи

Подробнее: статья [Ошибки и восстановление](/docs/errors).

Подключение

В проекте после npx @work-graph/cli init . появляется .cursor/mcp.json (или аналог) с npx -y @work-graph/mcp и WORKGRAPH_ROOT. Перезагрузите MCP в IDE после npm install.

Discovery для клиентов: /.well-known/mcp.json.