---
name: notion_agent_mcp_overview
description: Свой MCP-сервер (файлы+shell) для Notion AI как custom connector — Notion сам вызывает инструменты в своём UI; развёрнут на mini+VPS через reverse-SSH; отдельно от notion-web2api
metadata: 
  node_type: memory
  type: project
  originSessionId: 32127bdb-31c7-4402-a5e6-81684cfeaeff
  modified: 2026-07-21T07:36:44.551Z
---

**notion-agent-mcp** (2026-07-19): дал Notion AI (Enterprise-подписка) реальные агентные инструменты (run_command/read/write/edit/glob/grep/http_get) через MCP-протокол, подключённый в Notion UI как custom connector (Settings → Connections). Это ОТДЕЛЬНЫЙ механизм от [[notion_web2api_overview]] — там мы дёргаем Notion как OpenAI-совместимый API (без tool_calls), здесь Notion сам вызывает инструменты в своём интерфейсе.

Источник — сторонний архив `notion-mcp-main.zip`, найденный пользователем; внутри был чужой развёрнутый инстанс с реальным токеном (`asati`) — не тронут, см. [[harvested_free_key_repos_refuse]]. Взят только код `server_safe.py`, передеплоен с нуля.

**Архитектура:** Notion → `https://notion-mcp.cebersvpn.eu.cc/mcp` (Cloudflare named tunnel, зона `eu.cc` пользователя) → cloudflared systemd на VPS `192.255.201.98` (root, американский, уже хостит Amnezia) → autossh reverse tunnel (`-R 8000:localhost:8000`, launchd `com.cebers.notion-mcp-revtunnel` на mini) → `server_safe.py` (launchd `com.cebers.notion-mcp` на mini, venv `~/.venvs/notion-agent-mcp` py3.12) → песочница `~/notion-agent-sandbox/workdir`.

**Почему через VPS, не напрямую с mini:** прямой cloudflared tunnel на mini стабильно рвал именно потоковые/SSE-соединения (`context canceled`) при живых коротких запросах — реальная WAN-нестабильность mini для long-lived connections, не баг. Вынесли конец туннеля на VPS, до mini — привычный SSH. Полностью стабильно после переноса (проверено: auth 401/200, tools/call write_file×3 + list_dir через полную цепочку).

**Известные ограничения:** `run_command` — произвольный shell с `cwd=workdir`, НЕ полноценный jail (команда может выйти за пределы через `cd`); защита только Bearer-токен. Не давать доступ к секретам/боевым сервисам из этой песочницы. Полные доки: `~/Documents/Obsidian Vault/Projects/notion-agent-mcp/` (5 файлов).

**TODO:** пользователь должен сам добавить URL+токен в Notion UI (моя часть — деплой и проверка транспорта — готова и подтверждена живым прогоном).

**Грабля-развилка (2026-07-21, [[investpilot-overview]]):** владелец подключил URL+токен и спросил, можно ли этим ускорить анализ investpilot'а («закидывать пачки побольше»). Ответ: НЕТ — это не API, который бэкенд-код может вызвать программно, а инструменты ДЛЯ Notion (Notion — MCP client, наш сервер — provider инструментов). Автоматизировать этим scan/дистилляцию нельзя; работает только когда человек сам пишет в чат Notion. Реальный ускоритель для investpilot нашёлся в самом коде — распараллелена дистилляция KB (`KbService.distill_once`, была последовательной), см. [[investpilot-cebersresearch-voter]].
