feat: персональные MCP-ключи — выпуск в SPA, роль владельца у тула ...

Решение владельца (2026-10-04):
- Каждый пользователь выпускает себе MCP-ключ на новой странице /mcp-keys
  (доступна любой роли); plaintext показывается один раз, в БД — sha256 + hint.
- Ключ действует ролью владельца на момент выпуска (снейпшот system_role):
  admin/superadmin — полный каталог тулов (35), user — только личный набор
  (me, my_events_list, my_push_subscriptions_list, my_push_subscription_delete).
- Статический MCP_TOKEN из .env остаётся суперадмин-бэкдором; /mcp монтируется
  безусловно (персональные ключи работают и без env-токена).

Backend:
- таблица mcp_tokens (миграция 0008 c9a2d6e71f43) — зеркало ApiKey;
- app/mcp/context.py — ContextVar пользователя, resolve_personal_token;
- McpTokenGuard резолвит стат.токен или mcp_* в БД, пишет last_used_at,
  401 на промахе (чистый ASGI, SSE не трогает);
- тулы: user=current_mcp_user() вместо синтетического MCP_USER; админ-тулы
  под _admin_run — для user-ключа ToolError с {"error": 403} (не return-данные:
  FastMCP валидирует вывод по аннотации, list-тулы бы отвергли dict);
- HTTP: GET/POST /api/v1/me/mcp_tokens (+/revoke), GET/POST
  /api/v1/admin/mcp_tokens[.../revoke], лимит 10 активных на пользователя.

SPA: страница McpKeysView (свои ключи + как подключить агент; админ — все
ключи и отзыв), маршрут /mcp-keys (userOk), пункт в навигации обеих ролей.

Доки: docs/07 переписан (три вида доступа, 35 тулов), CLAUDE.md,
docs/08 (каталог 35), .env.example (MCP_TOKEN опционален).

E2e на живом стеке: user-ключ — 403 на админ-тулах и рабочий личный набор;
admin-ключ — полный каталог; last_used_at; бэкдор = superadmin; отзыв -> 401.

Co-Authored-By: Claude Code <noreply@anthropic.com>

docs: рантбук развёртывания для ИИ-агента (docs/08) + VAPID-ссылки ...

- docs/08: шаги деплоя (предполёт → .env+секреты → compose → nginx →
  SSO smoke → VAPID → MCP приёмка → после деплоя), таблица переменных,
  ловушки, откат. Открытые вопросы (хост/домен/тг-бот) — подтверждать
  у владельца, не выбирать молча.
- docs/07: у settings_put — явная ссылка на рецепт VAPID в docs/06
  (чтобы агент-деплоер его нашёл).
- docs/06: пара VAPID копируется в gnexus-creds; prod-путь — docs/08.
- README: список доков дополнен 06–08.

Co-Authored-By: Claude Code <noreply@anthropic.com>

feat: MCP-сервер встроенным FastMCP (/mcp) + архив вместо удаления ...

MCP (docs/07-mcp.md):
- embedded FastMCP streamable-http на /mcp того же контейнера api;
  гейт — чистый ASGI McpTokenGuard по Bearer MCP_TOKEN из .env (пусто —
  /mcp выключен). Route, не Mount: Mount('/mcp') не матчит точный /mcp.
- 31 тул в app/mcp/tools.py: выдача ключей клиенту (key_issue — plaintext
  один раз), полный CRUD источников/типов/целей/правил, поток (events/
  deliveries), push-подписки, настройки, send_test_event.
- тула переиспользуют функции admin-routes напрямую (синхронные def без
  срабатывания Depends); HTTPException/ValidationError — как данные.

Архив вместо удаления (миграция 0007 b7d3e8f04a92):
- deleted_at на sources/notification_types/channel_targets/routing_rules +
  частичные live-индексы; DELETE = 204 → архив, POST .../restore → 200.
- созд поверх архива → 409 с подсказкой id; ключ архивного источника →
  401; тройка архивного типа → 422; целевые правки → 422; архивная цель в
  правиле — Delivery skipped с аудитом; история имена архива показывает.
- push-подписки — исключение: жёсткое удаление.
- fix list_settings: оверрайды DB-only ключей (push/smtp, без .env-дефолта)
  снова возвращаются в value.

Проверено: mcparch ALL OK (41), mcpcheck ALL OK (28, MCP SDK-клиент),
mecheck/retcheck ALL OK, UI-регрессия (SPA, источники+delete 204) ALL OK.

Co-Authored-By: Claude Code <noreply@anthropic.com>