docs: документация переведена на канон av-dev-pm

- беклог и план переехали в docs/tasks (38 задач, 11 целей), слаги переименованы с транслита на английские, 85 ссылок поправлены - conventions.md разобран в docs/conventions/, local-research.md — в docs/research/, review-journal.md — в docs/review.md с разделом настройки конвейера; заведены security.md, adr/ и .pm.json - шаг docs.py check добавлен в task gate; поведение в architecture.md помечено девятью маркерами долга, database.md получил настройки с числовым значением
2026-08-03 17:14:53 +03:00
parent de7b15d48c
commit d79189be18
94 changed files with 1234 additions and 566 deletions
@@ -0,0 +1,22 @@
+# MCP-сервер поверх Read API
+
+**Секция:** ядро · **Хук:** Агент-медик — первый заказчик проекта, а подключить его сейчас нечем · **Теги:** goal:mcp
+
+Агент-медик — первый заказчик проекта. Ему нужна актуальная сводка, а не срез
+на дату последнего ручного экспорта.
+
+Транспорт — **Streamable HTTP**, не stdio: сервис живёт на VPS, агент ходит по
+сети. Отсюда: MCP — эндпоинт того же процесса и того же порта, аутентификация —
+тот же токен чтения, что у Read API. Отдельного контура доступа не заводим:
+MCP не даёт ничего, чего не даёт HTTP, и права обязаны совпадать.
+
+Инструментов три: каталог разрезов, значения за период, значения с разбивкой.
+Собственной логики в адаптере нет.
+
+Правило размера ответа здесь не украшение, а необходимость: у сетевого агента
+нет способа «посмотреть поближе» иначе, чем повторным вызовом.
+
+Готово, когда агент подключается по URL и отвечает на «как я спал на прошлой
+неделе» без промежуточного кода.
+
+Связано: `docs/architecture.md` → «MCP», план → шаг «MCP».