av
bd832337df
- конверт и точки разложены на форму провода, точки за период и условный запрос; свёртка — на сетку, порог неполного ведра и предел размера ответа; тренировки и записи разъехались на два независимых маршрута - openapi-swagger разложена на спеку, гейт против расхождения и Swagger UI — все три вне набора, вместе с mcp-server - набор спринта 2026-08-04 — весь HTTP-слой чтения, восемь задач
46 lines
3.5 KiB
Markdown
46 lines
3.5 KiB
Markdown
# MCP-сервер поверх Read API
|
|
|
|
- **Секция:** ядро — набор ограничен HTTP-слоем чтения после дробления; адаптер берётся следующим спринтом по той же цели
|
|
- **Зачем:** Агент-медик — первый заказчик проекта, а подключить его сейчас нечем
|
|
- **Теги:** goal:read-api
|
|
|
|
Агент-медик — первый заказчик проекта. Ему нужна актуальная сводка, а не срез
|
|
на дату последнего ручного экспорта.
|
|
|
|
Транспорт — **Streamable HTTP**, не stdio: сервис живёт на VPS, агент ходит по
|
|
сети. Отсюда: MCP — эндпоинт того же процесса и того же порта, аутентификация —
|
|
тот же токен чтения, что у Read API. Отдельного контура доступа не заводим:
|
|
MCP не даёт ничего, чего не даёт HTTP, и права обязаны совпадать.
|
|
|
|
Инструментов три: каталог разрезов, значения за период, значения с разбивкой.
|
|
Собственной логики в адаптере нет.
|
|
|
|
Правило размера ответа здесь не украшение, а необходимость: у сетевого агента
|
|
нет способа «посмотреть поближе» иначе, чем повторным вызовом.
|
|
|
|
Готово, когда агент подключается по URL и отвечает на «как я спал на прошлой
|
|
неделе» без промежуточного кода.
|
|
|
|
## Критерии приёмки
|
|
|
|
- живой агент подключается по URL и отвечает на «как я спал на прошлой неделе»
|
|
без промежуточного кода — оракул: подключение реального MCP-клиента к
|
|
поднятому сервису
|
|
- вызов инструмента и соответствующий HTTP-запрос дают одни и те же данные —
|
|
оракул: тест, сравнивающий выход инструмента с ответом маршрута на тех же
|
|
параметрах
|
|
- запрос без токена чтения отклоняется обоими транспортами одинаково — оракул:
|
|
тест на паре «MCP без токена / HTTP без токена»
|
|
- правило размера ответа действует и в MCP: слишком широкий запрос получает
|
|
названную сетку или ошибку со списком, а не обрезанный ответ — оракул: тест на
|
|
запросе за пределом
|
|
|
|
## Рамки
|
|
|
|
Схема не трогается, данные только читаются, сервис перезапускается. Собственной
|
|
логики адаптер не несёт — новое поведение здесь признак того, что оно должно
|
|
было появиться в маршруте чтения. Берётся последней в цели: переводить нечего,
|
|
пока обработчиков нет.
|
|
|
|
Связано: `docs/architecture.md` → «MCP».
|