chore(docs): пользовательская документация MCP вместо 417 КБ инженерных записей

Прежний docs/mcp.md перенесён без изменений текста в
mcp-implementation-history.md с пометкой «исторический». Новый mcp.md
(19 КБ) написан по коду: настройка сервера, подключение клиента, путь
изменения, возможности, Route AI, webhook отзыва, восстановление базы,
ограничения и проверки. Инструкция по включению дополнена правом
mm:settings:admin и путём «Система» → «MCP»; входящие ссылки обновлены.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
DenozordecandClaude Opus 5.5 committed 2026-11-21 21:25:01 +07:00
1 parent 2568b59afa
commit c1abfffe26
8 files changed
+1206 -975

No files matched your search

+2 -1
View File
@@ -119,7 +119,7 @@
- [x] Манифест: критерий плана → доказательство → статус, без перекраски `failed` и `unknown` — 2026-11-21, [mcp-final-manifest.md](mcp-final-manifest.md): исходные критерии реестра по направлениям POLL, DB, ROUTING, NATIVE, PATHS, EXTERNAL-UI, FINAL с доказательствами и статусами; отдельно история отказов (13 строк) и критерии вне плана завершения со статусом «не проверено». Решения по открытым строкам — за владельцем
- [x] Инструкция по включению: наблюдение → подтверждения → ограниченная автономность — 2026-11-21, [mcp-enable-guide.md](mcp-enable-guide.md): права портала, `MCP_PUBLIC_URL` и `MCP_STATE_DIR`, три шага с переходами и возвратом, срок прав владельца (до 24 часов), часовой бюджет в объектах, срок плана 5 и 15 минут, защиты, временный допуск, Route AI без автоматического восстановления, пауза, отзыв и аварийная остановка, частые отказы. Надписи сверены с `components/mcp/*.tsx`, числа и коды — с backend и контрактами. В документах стенда есть доказательства только для режима «С подтверждением»; «Наблюдатель» и «Автономный» покрыты `policy.test.ts`. По интерфейсу инструкцию целиком не проходили
- [x] Проверить, что MCP и контроллер выключены по умолчанию — 2026-11-21: `mcp_settings.enabled` и `mcp_routing_profiles.enabled` по умолчанию `false` (`0015_mcp.sql`), `autoRecovery` по умолчанию `false` (контракт), выключенный MCP отказывает токену `MCP_DISABLED`/503 (`store.ts`), воркер не вызывает контроллер при выключенном MCP (`workers.ts`). Проверки на свежей базе добавлены в `integration.test.ts` (первичный шард `test-mcp-postgres-sharded.mjs`)
- [ ] Сократить `docs/mcp.md` (417 КБ) до пользовательской документации
- [x] Сократить `docs/mcp.md` (417 КБ) до пользовательской документации — 2026-11-21: прежний файл перенесён без изменений текста в [mcp-implementation-history.md](mcp-implementation-history.md) с пометкой «исторический»; новый [mcp.md](mcp.md) (19 КБ): настройка сервера, подключение клиента (HTTP, stdio, OAuth), путь изменения, возможности по областям, Route AI, webhook отзыва порталом, восстановление базы, ограничения, проверки. Каждое утверждение написано по коду или манифесту, старый текст служил только списком тем: в нём были устаревшие места (автовосстановление «включается человеком», восстановление ревизий WireGuard и IPsec «pending», отправка отзыва из портала «не принята»). Режимы, лимиты и коды отказов не повторяются — ссылка на `mcp-enable-guide.md`. Входящие ссылки обновлены (README, план реализации, аудит трафика), хеши `documentHashes` в JSON-доказательствах оставлены как исторические
- [ ] PR в `main`
Продуктовые задачи из анализа таймингов (2026-11-17), не блокируют слияние в `main`; детали и числа в `mcp-stand-run-a-plan.md`, раздел «Вопросы к продукту»:
@@ -151,6 +151,7 @@
| 2026-11-20 | B2 (capacity336, nonce `5945935965481c83`) — `failed` на 169 операциях и 163 архивах после 2 ч 41 мин. Разбор очереди архивов держался до конца. Node завершился через `abort()`, текст ошибки не сохранился. Гипотеза — рост кучи с каждой операцией (время операции растёт с 5 до 22 с за 70 операций). Пакет снят, VPS свободен, повтора нет; пункт B2 открыт |
| 2026-11-20 | Причина установлена: продукт создавал `AsyncLocalStorage` на каждый опрос (Node держит их вечно), исправлено в `29998815`. `mmapp-test` переразвёрнут (Gitea `2745`), B1 повторён (12,1 с), **B2 принят**: 337/336/1348, 0 ошибок воркера, 5 ч 40 мин, очистка подтверждена. Оба пункта прогона B закрыты |
| 2026-11-19 | Оптимизация продукта (keep-alive REST, права раз на этап, параллельные чтения, сервисы WireGuard/scoped/IPsec) и шардированные тесты; A2 пройден на слое v28 (продукт `1e96ddac`) |
| 2026-11-21 | `docs/mcp.md` переписан как пользовательская документация (19 КБ); прежний текст — `mcp-implementation-history.md` |
| 2026-11-21 | Инструкция по включению MCP: `mcp-enable-guide.md` |
| 2026-11-21 | `server_remove` убирает свои profile и proposal (`d02a019b`, версия операции 3); `mmapp-test` на `mcp-d02a019b`, 5 из 5 прогонов IPsec подряд без остатка |
| 2026-11-21 | Этап 3 закрыт: A6 и A7 приняты (5 повторов подряд), IPsec через MCP принят по D11 (5 из 5 на `a7d85fd0`) после трёх исправлений продукта: счётчики `/interface` (`28738785`), совместимость с RouterOS 7.24 (`e7eb108c`), ожидание глобальной блокировки (`a7d85fd0`). В этапе 3 открытых пунктов нет |