Synapse

Taproot

Tus notas. La memoria de tu IA.

Servidor MCP que conecta cualquier cliente de IA — Claude, ChatGPT, Cursor, Windsurf — a tu bóveda de Obsidian. Guarda cualquier cosa desde cualquier lugar, haz preguntas a través de tus notas, mantén la base de conocimiento que tu IA consulta.

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 Taproot al objeto mcpServers:

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

3. Reinicia Claude Desktop. Las herramientas de Taproot aparecen automáticamente.

Claude Code

Añade a .claude/.mcp.json en tu directorio de inicio:

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

Claude.ai / ChatGPT / Cualquier IA remota

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

# Terminal 1: Start Taproot
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 integración MCP personalizada en tu cliente de IA.

Primeros pasos

Una vez conectado, di:

"Ayúdame a empezar con Taproot"

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

• Usar mi bóveda existente — Detecta tu estructura de carpetas, wikilinks, convenciones de nombres. Nada se mueve ni se sobrescribe. Taproot se adapta a ti.
• Configurar una base de conocimiento — Crea carpetas organizadas: sources/ para contenido bruto, notes/ para conocimiento compilado, outputs/ para resultados de consultas. Ideal para un tema de investigación enfocado.
• Personalizado — Tú le dices a Taproot cómo quieres que se organice todo.

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

Lo que 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, la guarda en tu bóveda. Funciona desde tu teléfono.

Haz preguntas a través de tus notas

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

Busca en tu bóveda, lee archivos relevantes, sintetiza una respuesta con citas.

Construye una wiki que se retroalimenta

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

Convierte fuentes brutas en resúmenes, páginas de conceptos, páginas de entidades — todo enlazado con wikilinks. Cada respuesta alimenta la base de conocimiento.

Revisa la salud de tus notas

"Ejecuta una revisión de salud en mi bóveda"

Encuentra enlaces rotos, páginas huérfanas, frontmatter faltante, contenido desactualizado. Corrige lo que puede.

Todas las herramientas

Herramienta	Qué hace
taproot_plant	Incorporación — escanea la bóveda, presenta opciones, configura Taproot
taproot_till	Guarda tus preferencias de bóveda
taproot_seed	Guarda contenido desde una URL o texto pegado
taproot_status	Vista general de la bóveda con acciones sugeridas
taproot_water	Procesa una fuente en páginas organizadas
taproot_cultivate	Encuentra y procesa todas las fuentes sin procesar
taproot_harvest	Investiga una pregunta en tu base de conocimiento
taproot_prune	Revisión de salud para enlaces rotos, huérfanos, vacíos
taproot_sow	Crea una nueva base de conocimiento desde cero
garden_read	Lee cualquier archivo
garden_plant	Crea o actualiza cualquier archivo
garden_survey	Lista archivos en la bóveda o subdirectorio
garden_forage	Búsqueda de texto completo
garden_measure	Conteo de archivos y estructura
garden_tag	Lee metadatos YAML de un archivo

Cómo funciona

Taproot es un servidor MCP — un protocolo abierto para conectar IA a herramientas y datos. Da a tu IA acceso de lectura/escritura a tu bóveda (y nada más — aislado al 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.) detrás de Tailscale u otro túnel

Tu bóveda es solo una carpeta de archivos markdown. Taproot 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 — Taproot