🧠 Sybil MCP — Servidor de Inteligencia de Riesgos para Notion

Sybil es un servidor MCP (Model Context Protocol) que monitorea tus bases de datos de Notion en tiempo real y detecta riesgos financieros: cuando una tarea de Ingeniería se retrasa y se solapa con el lanzamiento de una campaña de Marketing, Sybil crea automáticamente una alerta en tu Centro de Alertas de Notion.

⚡ Inicio rápido

No necesitas ejecutar nada manualmente. Claude Desktop gestiona el servidor automáticamente.

1. Asegúrate de que tu claude_desktop_config.json esté configurado (consulta la sección de Configuración)

2. Abre Claude Desktop: el servidor se inicia solo en segundo plano

3. Pregúntale a Claude: "¿Qué riesgos detecta Sybil?"

⚠️ Nunca ejecutes node index.js manualmente mientras Claude Desktop esté abierto. Crearía dos instancias del servidor ejecutándose en paralelo y duplicaría las alertas en Notion.

🏗️ Arquitectura

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

Componentes

🔄 Cómo funciona internamente

1. Inicio automático

Cuando abres Claude Desktop, este lee claude_desktop_config.json e inicia node index.js automáticamente. El servidor:

• Carga el historial de alertas desde .sybil-alerts.json (si existe)

• Se conecta a Claude mediante MCP (stdin/stdout)

• Inicia el monitoreo en segundo plano inmediatamente

2. Monitoreo en segundo plano cada 10 segundos (sin uso de tokens)

El servidor ejecuta un ciclo de vigilancia cada 10 segundos, totalmente independiente de 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

🔑 Este ciclo NO consume tokens de Claude. Realiza llamadas HTTP directas a la API de Notion.

3. Llamada a herramientas desde Claude (aquí SÍ se usan tokens)

Cuando le preguntas a Claude sobre riesgos, Claude llama a la herramienta check_sybil_risk. Esto:

• Ejecuta el mismo ciclo de análisis inmediatamente bajo demanda

• Devuelve un resumen de texto a Claude

• Claude utiliza ese texto para responderte

Solo este paso utiliza tokens (el procesamiento de la respuesta de Claude en tu conversación).

4. Protección contra duplicados (3 capas)

Para evitar que se creen alertas duplicadas en Notion:

⚙️ Configuración

El archivo de configuración de Claude Desktop se encuentra en:

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

Las variables de entorno también se pueden definir en un archivo .env en la carpeta del proyecto.

🔧 Cómo actualizar el código

Después de realizar cambios en index.js:

1. Guarda el archivo

2. Cierra completamente Claude Desktop

   • Haz clic derecho en el icono de la bandeja del sistema → Salir

   • (No cierres solo la ventana)

3. Vuelve a abrir Claude Desktop

4. Claude iniciará automáticamente el servidor con el nuevo código

✅ Para confirmar que el nuevo código está activo, pregúntale a Claude: "Comprueba los riesgos con Sybil". Verás que no aparecen duplicados nuevos en el Centro de Alertas de Notion.

📁 Archivos del proyecto

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

Archivos generados automáticamente

🩺 Solución de problemas

¿Siguen apareciendo alertas duplicadas en Notion?

• Asegúrate de que solo haya UNA instancia de Claude Desktop abierta

• Reinicia completamente Claude Desktop (Salir, no cierres solo la ventana)

• Borra .sybil-alerts.json si contiene datos obsoletos de sesiones anteriores con errores

¿No aparecen alertas en Notion?

• Verifica que tu NOTION_TOKEN tenga acceso a las 3 bases de datos

• Confirma que las tareas de Ingeniería tengan exactamente el estado "Delayed" (Retrasado)

• Confirma que las campañas de Marketing tengan una "Launch Date" (Fecha de lanzamiento) establecida

¿Claude dice que no puede encontrar la herramienta check_sybil_risk?

• Reinicia Claude Desktop para recargar el servidor MCP

• Verifica que la ruta en claude_desktop_config.json sea correcta

💡 ¿El monitoreo en segundo plano consume tokens?

No. El setInterval que se ejecuta cada 10 segundos realiza llamadas HTTP directas a la API de Notion. Claude no interviene en ese proceso.

Los tokens solo se consumen cuando:

• Envías un mensaje a Claude en el chat

• Claude decide llamar a la herramienta check_sybil_risk para responderte

El monitoreo en segundo plano es totalmente gratuito en términos de tokens de Claude.