diff --git a/10-systems/services/gnexus-synapse.md b/10-systems/services/gnexus-synapse.md index 124b7e6..e886e21 100644 --- a/10-systems/services/gnexus-synapse.md +++ b/10-systems/services/gnexus-synapse.md @@ -1,7 +1,7 @@ --- owner: gmikcon status: active -last_reviewed: 2026-10-04 +last_reviewed: 2026-10-05 review_interval: 90d confidence: high source_of_truth: ssh-host-and-live-verified @@ -53,6 +53,14 @@ - Бэкап ДО обновления: `/home/ubuntu/backup-synapse-2026-10-04-1505-preupdate.sql` (26 KB, валидный дамп). - Проверено после обновления: api healthy, postgres/redis healthy, worker обрабатывает задачи (`synapse.retry_due succeeded`), healthz/readyz ok, SPA 200, `/mcp` без токена 401, публичный healthz ok, публичная SPA 200. +## Update 2026-10-05 03:50 (navi rei) — MCP подключён к Navi (rei) + +- Владелец выдал персональный MCP-ключ (роль владельца); Navi rei подключила Synapse как MCP-сервер: `/home/ubuntu/navi-1/mcp_servers.d/synapse.json` (локальная модификация, переживает git stash при обновлениях). Конфиг: url `http://192.168.1.172:8013/mcp`, headers `Authorization: Bearer mcp_…` + `Host: localhost:8013`. +- **Ловушка Host-заголовка**: FastMCP на бэкенде Synapse отклоняет запросы с Host `synapse.gnexus.space` → 421 «Invalid Host header» (DNS-rebinding защита). Прямой LAN-эндпоинт `http://192.168.1.172:8013/mcp` принимает только `Host: localhost:8013` или `127.0.0.1:8013`. +- **Следствие — публичный MCP-эндпоинт сломан для внешних клиентов**: nginx на .226 передаёт `proxy_set_header Host $host`, бэкенд отвечает 421 на `https://synapse.gnexus.space/mcp`. Варианты фикса (не применены, решение за владельцем): (а) на .226 выделить `location /mcp` с `proxy_set_header Host localhost:8013`; (б) серверно ослабить host-validation в Synapse (доверенный хост). Внутренние клиенты LAN работают через прямое подключение с подменой Host. +- Проверено: initialize на LAN-эндпоинте → 200, serverInfo `synapse v1.30.0`; после рестарта navi.service в реестре Navi 35 тулов `mcp__synapse__*` (system_status, stats_get, sources_*, keys_*, types_*, targets_*, rules_*, events_*, deliveries_list, push_*, settings_*, me, my_*, send_test_event) — в docs/07 было 31, список вырос. +- Нюанс рестарта navi.service: SIGTERM не завершал старый процесс, пока жива сессия агента (веб-клиент держит соединение); systemd добил по TimeoutStopSec (~90 c), новый процесс подхватил конфиг. Проверка подключения без journalctl: `GET http://127.0.0.1:8099/agents/mcp_servers` (без авторизации) → `connected: true`. + ## SSO (gnexus-auth) — настроено 2026-10-04 (рантбук §5) - Владелец зарегистрировал OAuth-клиент `synapse` в gnexus-auth и передал креды; они вписаны в `.env` на хосте (GAUTH_CLIENT_ID `gnx_N4NS…`, GAUTH_CLIENT_SECRET, GAUTH_WEBHOOK_SECRET — значения в gnexus-creds, не в доках). @@ -67,6 +75,7 @@ - nginx site: `/etc/nginx/sites-available/synapse.gnexus.space` на .226; TLS Let's Encrypt `synapse.gnexus.space` (certbot --nginx, до 2027-01-02, автопродление); HTTP→HTTPS 301 добавлен вручную (certbot не вписал). - DNS: wildcard `*.gnexus.space` → 51.83.131.93 (external-vps), отдельной записи не потребовалось. - `proxy_buffering off` + `proxy_read_timeout 300s` — для SSE/MCP. +- Внимание: для `/mcp` см. Update 2026-10-05 — бэкенд отклоняет Host `$host`, публичный MCP-эндпоинт требует фикса. ## Verified smoke (2026-10-04) @@ -80,10 +89,11 @@ 1. Telegram-канал — отложен до задачи #29 (не создавать цель telegram). 2. Push-канал (VAPID) — опционально, рантбук §7. +3. Фикс публичного `/mcp` (421 Invalid Host header для внешних клиентов) — варианты в Update 2026-10-05 03:50. ## Operations - Обновление: `cd /home/ubuntu/gnsynapse && git pull && sudo docker compose up -d --build` (перед этим `pg_dump` — откат миграций вниз не поддерживается всеми ревизиями). - Бэкап БД: `sudo docker compose exec -T postgres pg_dump -U synapse synapse > backup-$(date +%F).sql`. -- MCP-управление: `https://synapse.gnexus.space/mcp` с Bearer MCP_TOKEN (суперадмин-бэкдор) или персональным ключом `mcp_...` (31 тул, docs/07). +- MCP-управление: LAN `http://192.168.1.172:8013/mcp` с `Host: localhost:8013` (работает для внутренних клиентов) или персональным ключом `mcp_...`; публичный `https://synapse.gnexus.space/mcp` — см. Pending №3 (421 для внешних клиентов). - Smoke-объекты приёмки (source monitoring, key smoke-key, target smoke-log, rule id=1) — можно архивировать через админку/MCP после реальной настройки.