🧠 Sybil MCP — Notion Risk Intelligence Server

Sybil ist ein MCP-Server (Model Context Protocol), der Ihre Notion-Datenbanken in Echtzeit überwacht und finanzielle Risiken erkennt: Wenn eine Engineering-Aufgabe verzögert ist und sich mit dem Start einer Marketingkampagne überschneidet, erstellt Sybil automatisch eine Warnung in Ihrem Notion Alert Center.

⚡ Schnellstart

Sie müssen nichts manuell ausführen. Claude Desktop verwaltet den Server automatisch.

1. Stellen Sie sicher, dass Ihre claude_desktop_config.json konfiguriert ist (siehe Abschnitt Konfiguration)

2. Öffnen Sie Claude Desktop — der Server startet von selbst im Hintergrund

3. Fragen Sie Claude: "Welche Risiken erkennt Sybil?"

⚠️ Führen Sie niemals node index.js manuell aus, während Claude Desktop geöffnet ist. Dies würde zwei parallel laufende Serverinstanzen erzeugen und zu doppelten Warnungen in Notion führen.

🏗️ Architektur

┌─────────────────────────────────────────────────────────────┐
│                      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   │  │
                                    │  └──────────────┘  │
                                    └────────────────────┘

Komponenten

🔄 Funktionsweise

1. Automatischer Start

Wenn Sie Claude Desktop öffnen, liest es die claude_desktop_config.json und startet automatisch node index.js. Der Server:

• Lädt den Warnungsverlauf aus .sybil-alerts.json (falls vorhanden)

• Verbindet sich mit Claude über MCP (stdin/stdout)

• Startet sofort die Hintergrundüberwachung

2. Hintergrundüberwachung alle 10 Sekunden (kein Token-Verbrauch)

Der Server führt alle 10 Sekunden einen Überwachungszyklus aus, völlig unabhängig von 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

🔑 Dieser Zyklus verbraucht KEINE Claude-Token. Er führt direkte HTTP-Aufrufe an die Notion-API durch.

3. Tool-Aufruf durch Claude (hier WERDEN Token verbraucht)

Wenn Sie Claude nach Risiken fragen, ruft Claude das Tool check_sybil_risk auf. Dies:

• Führt denselben Analysezyklus sofort bei Bedarf aus

• Gibt eine Textzusammenfassung an Claude zurück

• Claude verwendet diesen Text, um Ihnen zu antworten

Nur dieser Schritt verbraucht Token (die Verarbeitung von Claudes Antwort in Ihrer Konversation).

4. Schutz vor Duplikaten (3 Ebenen)

Um zu verhindern, dass doppelte Warnungen in Notion erstellt werden:

⚙️ Konfiguration

Die Konfigurationsdatei für Claude Desktop befindet sich unter:

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"
      }
    }
  }
}

Umgebungsvariablen können auch in einer .env-Datei im Projektordner definiert werden.

🔧 Wie man den Code aktualisiert

Nachdem Sie Änderungen an index.js vorgenommen haben:

1. Speichern Sie die Datei

2. Beenden Sie Claude Desktop vollständig

   • Rechtsklick auf das Symbol in der Taskleiste → Beenden

   • (Schließen Sie nicht nur das Fenster)

3. Öffnen Sie Claude Desktop erneut

4. Claude startet den Server automatisch mit dem neuen Code

✅ Um zu bestätigen, dass der neue Code aktiv ist, fragen Sie Claude: "Risiken mit Sybil prüfen". Sie werden sehen, dass keine neuen Duplikate im Notion Alert Center erscheinen.

📁 Projektdateien

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

Automatisch generierte Dateien

🩺 Fehlerbehebung

Erscheinen immer noch doppelte Warnungen in Notion?

• Stellen Sie sicher, dass nur EINE Instanz von Claude Desktop geöffnet ist

• Starten Sie Claude Desktop vollständig neu (Beenden, nicht nur das Fenster schließen)

• Löschen Sie .sybil-alerts.json, falls sie veraltete Daten aus früheren fehlerhaften Sitzungen enthält

Erscheinen keine Warnungen in Notion?

• Überprüfen Sie, ob Ihr NOTION_TOKEN Zugriff auf alle 3 Datenbanken hat

• Bestätigen Sie, dass Engineering-Aufgaben genau den Status "Delayed" haben

• Bestätigen Sie, dass Marketingkampagnen ein Launch Date gesetzt haben

Claude sagt, es kann das Tool check_sybil_risk nicht finden?

• Starten Sie Claude Desktop neu, um den MCP-Server neu zu laden

• Überprüfen Sie, ob der Pfad in claude_desktop_config.json korrekt ist

💡 Verbraucht die Hintergrundüberwachung Token?

Nein. Das setInterval, das alle 10 Sekunden läuft, führt direkte HTTP-Aufrufe an die Notion-API durch. Claude ist an diesem Prozess nicht beteiligt.

Token werden nur verbraucht, wenn:

• Sie eine Nachricht an Claude im Chat senden

• Claude entscheidet, das Tool check_sybil_risk aufzurufen, um Ihnen zu antworten

Die Hintergrundüberwachung ist in Bezug auf Claude-Token völlig kostenlos.