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:
1 parent
2568b59afa
commit
c1abfffe26
8 files changed
+1206
-975
No files matched your search
@@ -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 открытых пунктов нет |
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
|
||||
Это закреплено тестом на свежей базе (`integration.test.ts`). Подключений нет, пока администратор их не создаст.
|
||||
|
||||
Названия в кавычках «…» — надписи в интерфейсе, раздел **MCP** в Manager.
|
||||
Названия в кавычках «…» — надписи в интерфейсе, раздел «Система» → «MCP» в Manager. Общее описание MCP — [mcp.md](mcp.md).
|
||||
|
||||
## Перед началом
|
||||
|
||||
@@ -26,6 +26,7 @@
|
||||
| `mm:mcp:approve` | «Подтвердить план» и «Отклонить». Нужны ещё права самой операции: например, для изменения сети — `mm:network:write` |
|
||||
| `mm:mcp:pause` | «Остановить автоматические изменения» на вкладке «Обзор» |
|
||||
| `mm:mcp:admin` | всё остальное: настройки, подключения, защиты, Route AI, OAuth-клиенты, сверка и восстановление |
|
||||
| `mm:settings:admin` | включает все права `mm:mcp:*`; кроме того, восстановление базы приложения |
|
||||
|
||||
Подключению можно передать только те права, которые есть у его владельца. Иначе сохранение отклоняется: «Нельзя делегировать отсутствующие права». Менять политику подключения может только его владелец.
|
||||
|
||||
|
||||
@@ -91,7 +91,7 @@
|
||||
| --- | --- | --- |
|
||||
| Итоговый снимок исходников и регрессия | Этап 1 на прежнем HEAD; на коде `d02a019b`: шардированный `test-mcp-postgres-sharded.mjs` 6 из 6, `--module-completion`, набор A7 205/205 | принято частично: полный этап 1 (`lint`, `build`, `test:mcp:pg:all`, Playwright) на итоговом HEAD повторяется перед PR |
|
||||
| Контракты, безопасность, покрытие, судьба нерешённой истории | `coverage.test.ts` (этап 1); этот манифест | принято частично: манифест составлен, решение по открытым строкам — за владельцем |
|
||||
| Инструкции по эксплуатации и безопасное включение | Проверка «выключено по умолчанию» (выше); [mcp-enable-guide.md](mcp-enable-guide.md) — три шага включения, остановка и отзыв, частые отказы | принято частично: в документах стенда есть доказательства только для режима «С подтверждением»; «Наблюдатель» и «Автономный» — тестами политики; инструкция сверена с кодом, по интерфейсу целиком не пройдена. Сокращение `docs/mcp.md` до пользовательской документации — этап 5 |
|
||||
| Инструкции по эксплуатации и безопасное включение | Проверка «выключено по умолчанию» (выше); [mcp-enable-guide.md](mcp-enable-guide.md) — три шага включения, остановка и отзыв, частые отказы | принято частично: в документах стенда есть доказательства только для режима «С подтверждением»; «Наблюдатель» и «Автономный» — тестами политики; инструкция сверена с кодом, по интерфейсу целиком не пройдена. Пользовательская документация — [mcp.md](mcp.md) |
|
||||
|
||||
## История отказов (не перекрашивается)
|
||||
|
||||
@@ -116,4 +116,4 @@
|
||||
- `mmapp-test`: backend `mcp-d02a019b`, frontend `mcp-29998815`; MCP выключен, подключения отозваны, тестовая учётная запись `a3-agent` отключена.
|
||||
- Оба CHR: после IPsec `ipv4/ipv6-fast-path-active=false` при неизменной конфигурации; причина и способ возврата не установлены.
|
||||
- VPS: 16 резервных копий `/root/backups/*pre-*`, 9 тегов `mmapp-test/backend`, каталоги `/root/c2c4-29998815` и `/var/tmp/restore58-*` — чистка по решению владельца.
|
||||
- Этап 4: PATHS, RAM-1, autoRecovery, RT-3. Этап 5: сокращение `docs/mcp.md`, PR в `main`, три продуктовые задачи.
|
||||
- Этап 4: PATHS, RAM-1, autoRecovery, RT-3. Этап 5: PR в `main`, три продуктовые задачи.
|
||||
File diff suppressed because it is too large.
Load diff
@@ -1934,7 +1934,7 @@ SQL/HTTP использует временный PostgreSQL и локальны
|
||||
|
||||
План согласован 16 октября 2026 года; актуальный статус выполнения отмечен ниже.
|
||||
|
||||
Реализация ведётся в ветке `codex/mcp-foundation`. Актуальный статус и команды проверки — в [MCP: состояние реализации](mcp.md). Этот документ сохраняет полный согласованный объём; наличие инструмента в реестре не заменяет приёмку соответствующего сценария.
|
||||
Реализация ведётся в ветке `codex/mcp-foundation`. Пользовательская документация и команды проверки — в [mcp.md](mcp.md), статусы — в [mcp-final-manifest.md](mcp-final-manifest.md), прежние инженерные записи — в [mcp-implementation-history.md](mcp-implementation-history.md). Этот документ сохраняет полный согласованный объём; наличие инструмента в реестре не заменяет приёмку соответствующего сценария.
|
||||
|
||||
### Сверка покрытия на 5 ноября 2026
|
||||
|
||||
|
||||
@@ -54,4 +54,4 @@
|
||||
4. При аудите `mm_traffic_settings_get` создавал отсутствующую строку настроек. Во втором локальном пакете MCP и REST GET используют общую проекцию, которая возвращает значения по умолчанию без создания строки. SQL-сценарий проверяет отсутствующую и сохранённую конфигурации. [Регистрация](../backend/src/modules/mcp/application-actions.ts#L173), [обработчик настроек](../backend/src/services/traffic-collector.ts)
|
||||
5. Live-агрегат интерфейсов суммирует RX/TX для активных имён, отбрасывая loopback по имени. Такая сумма отражает интерфейсные наблюдения и может учитывать один пакет на нескольких уровнях. `mm_netflow_live_observe` отдельно отражает состояние локального приёмника и накопленные записи. [Live sampler](../backend/src/services/traffic-live.ts#L30), [смысл live Flow](../backend/src/modules/mcp/flow-live-actions.ts#L54)
|
||||
|
||||
Сохранённые свидетельства [traffic history](mcp-traffic-history-acceptance.json), [user history](mcp-user-traffic-history-acceptance.json), [analytics](mcp-flow-analytics-acceptance.json), [map](mcp-flow-map-acceptance.json), [rebuild](mcp-flow-rebuild-adapter-acceptance-v1.json), [worker lifecycle](mcp-flow-worker-ipc-acceptance-20261029.json), [NetFlow settings](mcp-netflow-settings-acceptance-v2.json), [active services](mcp-flow-active-services-acceptance-20261029.json). Для overlay есть [сценарий SQL/HTTP](../backend/src/test/mcp-flow-overlay.ts); сохранённое описание общего [контракта MCP](mcp.md#L311) ограничивает его конфигурацией. Эти артефакты сами по себе не подтверждают текущую доступность устройства, фактический handshake или полное покрытие трафика.
|
||||
Сохранённые свидетельства [traffic history](mcp-traffic-history-acceptance.json), [user history](mcp-user-traffic-history-acceptance.json), [analytics](mcp-flow-analytics-acceptance.json), [map](mcp-flow-map-acceptance.json), [rebuild](mcp-flow-rebuild-adapter-acceptance-v1.json), [worker lifecycle](mcp-flow-worker-ipc-acceptance-20261029.json), [NetFlow settings](mcp-netflow-settings-acceptance-v2.json), [active services](mcp-flow-active-services-acceptance-20261029.json). Для overlay есть [сценарий SQL/HTTP](../backend/src/test/mcp-flow-overlay.ts); сохранённое описание общего [контракта MCP](mcp-implementation-history.md#L313) ограничивает его конфигурацией. Эти артефакты сами по себе не подтверждают текущую доступность устройства, фактический handshake или полное покрытие трафика.
|
||||
+147
-968
File diff suppressed because it is too large.
Load diff
Reference in new issue
Block a user