🧠 Sybil MCP — Сервер интеллектуального анализа рисков Notion

Sybil — это сервер MCP (Model Context Protocol), который отслеживает ваши базы данных Notion в режиме реального времени и обнаруживает финансовые риски: когда инженерная задача задерживается и пересекается с запуском маркетинговой кампании, Sybil автоматически создает оповещение в вашем Центре оповещений Notion.

⚡ Быстрый старт

Вам не нужно запускать что-либо вручную. Claude Desktop управляет сервером автоматически.

1. Убедитесь, что ваш claude_desktop_config.json настроен (см. раздел «Конфигурация»)

2. Откройте Claude Desktop — сервер запустится самостоятельно в фоновом режиме

3. Спросите у Claude: "Какие риски обнаруживает Sybil?"

⚠️ Никогда не запускайте node index.js вручную, пока открыт Claude Desktop. Это создаст два параллельно работающих экземпляра сервера и приведет к дублированию оповещений в Notion.

🏗️ Архитектура

┌─────────────────────────────────────────────────────────────┐
│                      Claude Desktop                         │
│                                                             │
│   ┌─────────────┐   MCP Protocol   ┌────────────────────┐  │
│   │  Claude AI  │ ◄──────────────► │  Sybil MCP Server  │  │
│   │  (chat)     │   (stdin/stdout)  │  (node index.js)   │  │
│   └─────────────┘                  └────────┬───────────┘  │
│                                             │               │
└─────────────────────────────────────────────┼───────────────┘
                                              │ HTTPS
                                    ┌─────────▼──────────┐
                                    │    Notion API       │
                                    │  ┌──────────────┐  │
                                    │  │ Engineering  │  │
                                    │  │   Database   │  │
                                    │  ├──────────────┤  │
                                    │  │  Marketing   │  │
                                    │  │   Database   │  │
                                    │  ├──────────────┤  │
                                    │  │ Alert Center │  │
                                    │  │   Database   │  │
                                    │  └──────────────┘  │
                                    └────────────────────┘

Компоненты

🔄 Как это работает изнутри

1. Автоматический запуск

Когда вы открываете Claude Desktop, он считывает claude_desktop_config.json и автоматически запускает node index.js. Сервер:

• Загружает историю оповещений из .sybil-alerts.json (если он существует)

• Подключается к Claude через MCP (stdin/stdout)

• Сразу начинает фоновый мониторинг

2. Фоновый мониторинг каждые 10 секунд (без использования токенов)

Сервер выполняет цикл проверки каждые 10 секунд, полностью независимо от Claude:

Every 10s:
  1. Read Engineering DB → look for tasks with status "Delayed"
  2. Read Marketing DB   → (in parallel with step 1)
  3. For each delayed task × campaign:
       - Is Launch Date <= Due Date? → risk detected
       - Already in .sybil-alerts.json? → skip (no duplicates)
       - Already exists in Notion (filter query)? → skip
       - If not found: create comment + row in Alert Center

🔑 Этот цикл НЕ расходует токены Claude. Он выполняет прямые HTTP-запросы к API Notion.

3. Вызов инструмента из Claude (здесь токены ИСПОЛЬЗУЮТСЯ)

Когда вы спрашиваете Claude о рисках, Claude вызывает инструмент check_sybil_risk. Это:

• Запускает тот же цикл анализа немедленно по запросу

• Возвращает текстовое резюме для Claude

• Claude использует этот текст, чтобы ответить вам

Только этот шаг использует токены (обработка ответа Claude в вашем диалоге).

4. Защита от дубликатов (3 уровня)

Чтобы предотвратить создание дубликатов оповещений в Notion:

⚙️ Конфигурация

Файл конфигурации Claude Desktop находится по адресу:

C:\Users\[YOUR_USER]\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sybil": {
      "command": "node",
      "args": ["C:/Users/USUARIO/Desktop/sybil-mcp/index.js"],
      "env": {
        "NOTION_TOKEN": "your_token_here",
        "ID_ENGINEERING": "your_engineering_database_id",
        "ID_MARKETING": "your_marketing_database_id",
        "ID_ALERTAS": "your_alert_center_database_id",
        "ID_SALES": "your_sales_database_id"
      }
    }
  }
}

Переменные окружения также можно определить в файле .env в папке проекта.

🔧 Как обновить код

После внесения изменений в index.js:

1. Сохраните файл

2. Полностью закройте Claude Desktop

   • Нажмите правой кнопкой мыши на значок в системном трее → Выход

   • (Не просто закрывайте окно)

3. Снова откройте Claude Desktop

4. Claude автоматически запустит сервер с новым кодом

✅ Чтобы убедиться, что новый код активен, спросите у Claude: "Проверь риски с помощью Sybil". Вы увидите, что в Центре оповещений Notion не появилось новых дубликатов.

📁 Файлы проекта

sybil-mcp/
├── index.js              ← Main MCP server
├── .env                  ← Environment variables (do not commit to git)
├── .sybil-alerts.json    ← Alert history (auto-generated)
├── .sybil-lock           ← Active process lock (auto-generated)
├── .gitignore
└── README.md

Автоматически создаваемые файлы

🩺 Устранение неполадок

В Notion все еще появляются дубликаты оповещений?

• Убедитесь, что открыт только ОДИН экземпляр Claude Desktop

• Полностью перезапустите Claude Desktop (Выход, не просто закрытие окна)

• Удалите .sybil-alerts.json, если он содержит устаревшие данные из предыдущих сессий с ошибками

В Notion не появляются оповещения?

• Убедитесь, что ваш NOTION_TOKEN имеет доступ ко всем 3 базам данных

• Убедитесь, что инженерные задачи имеют статус точно "Delayed"

• Убедитесь, что для маркетинговых кампаний установлена Launch Date

Claude говорит, что не может найти инструмент check_sybil_risk?

• Перезапустите Claude Desktop, чтобы перезагрузить MCP-сервер

• Убедитесь, что путь в claude_desktop_config.json указан верно

💡 Потребляет ли фоновый мониторинг токены?

Нет. setInterval, работающий каждые 10 секунд, выполняет прямые HTTP-запросы к API Notion. Claude не участвует в этом процессе.

Токены расходуются только тогда, когда:

• Вы отправляете сообщение Claude в чате

• Claude решает вызвать инструмент check_sybil_risk, чтобы ответить вам

Фоновый мониторинг полностью бесплатен с точки зрения токенов Claude.