Synapse

El sistema nervioso entre tu IA y tus notas.

Servidor MCP que conecta cualquier IA a tu bóveda de Obsidian. Funciona con Claude, ChatGPT, Cursor, Windsurf y cualquier cliente compatible con MCP. Guarda artículos desde tu teléfono, haz preguntas sobre tus notas, construye una base de conocimientos compuesta.

Configuración en 30 segundos

Claude Desktop

1. Abre la configuración: Mac ~/Library/Application Support/Claude/claude_desktop_config.json | Windows %APPDATA%\Claude\claude_desktop_config.json

2. Añade Synapse al objeto mcpServers:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/obsidian-vault"]
    }
  }
}

3. Reinicia Claude Desktop. Las herramientas de Synapse aparecerán automáticamente.

Claude Code

Añade esto a .claude/.mcp.json en tu directorio personal:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/vault"]
    }
  }
}

Claude.ai / ChatGPT / Cualquier IA remota

Ejecuta Synapse localmente y exponlo con un túnel gratuito:

# Terminal 1: Start Synapse
npx synapse-obsidian /path/to/vault --http --port 3777

# Terminal 2: Expose it (free, no account needed)
npx cloudflared tunnel --url http://localhost:3777

Copia la URL del túnel. Añade https://your-tunnel-url.trycloudflare.com/mcp como una integración MCP personalizada en tu cliente de IA.

Primeros pasos

Una vez conectado, di:

"Ayúdame a empezar con Synapse"

Synapse escanea tu bóveda y te ofrece tres opciones:

• Usar mi bóveda existente — Detecta tu estructura de carpetas, wikilinks y convenciones de nomenclatura. Nada se mueve ni se sobrescribe. Synapse se adapta a ti.

• Configurar una base de conocimientos — Crea carpetas organizadas: sources/ para contenido sin procesar, notes/ para conocimiento compilado, outputs/ para resultados de consultas. Ideal para un tema de investigación específico.

• Personalizado — Tú le dices a Synapse cómo quieres que se organice todo.

También te preguntará para qué usarás la bóveda (investigación, negocios, académico, sistema de vida) para poder adaptar la experiencia.

Qué puedes hacer

Guarda cualquier cosa, desde cualquier lugar

"Guarda este artículo: https://example.com/interesting-post"

Obtiene la página, la convierte a markdown y la guarda en tu bóveda. Funciona desde tu teléfono.

Haz preguntas sobre tus notas

"¿Qué dicen mis notas sobre la estrategia de precios?"

Busca en tu bóveda, lee los archivos relevantes y sintetiza una respuesta citada.

Construye una wiki compuesta

"Procesa todos los artículos nuevos en mi bóveda"

Convierte fuentes sin procesar en resúmenes, páginas de conceptos y páginas de entidades, todo interconectado con wikilinks. Cada respuesta se retroalimenta en la base de conocimientos.

Comprueba el estado de tus notas

"Ejecuta una comprobación de estado en mi bóveda"

Encuentra enlaces rotos, páginas huérfanas, metadatos faltantes y contenido obsoleto. Corrige lo que puede.

Todas las herramientas

Cómo funciona

Synapse es un servidor MCP, un protocolo abierto para conectar IA a herramientas y datos. Le da a tu IA acceso de lectura/escritura a tu bóveda (y nada más, está aislado en el directorio de la bóveda).

• Stdio (predeterminado) — Para aplicaciones de IA de escritorio (Claude Desktop, etc.)

• HTTP (--http) — Para IA basada en navegador (Claude.ai, ChatGPT, etc.) mediante túnel

• Cloud (--cloud) — Modo alojado con OAuth de Google Drive (próximamente)

Tu bóveda es solo una carpeta de archivos markdown. Synapse no necesita que Obsidian esté ejecutándose; funciona con cualquier carpeta.

Requisitos

• Node.js 18+ (verifica con node -v)

• Una bóveda de Obsidian o cualquier carpeta de archivos markdown

• Cualquier cliente de IA compatible con MCP

Licencia

MIT — MainLoop Systems