Conectar Obsidian con Orkestra (vía MCP)

Si usas [Obsidian](https://obsidian.md) como tu segundo cerebro personal, puedes conectar ese vault al mismo agente que opera Orkestra. Sin plugin propio, sin sync bidireccional: el agente lee tus notas locales y ejecuta en Orkestra con preview/confirm — todo en la misma conversación.

Para qué sirve

Obsidian es un app local de notas en Markdown. Orkestra es la plataforma donde tu equipo ejecuta. El punto de unión natural es el agente de IA: lee tu planificación personal en Obsidian y la materializa como tareas, proyectos o documentos en Orkestra.

  • Daily note → tareas — “Convierte los checkboxes de la daily de hoy en tareas del proyecto X asignadas a mí”.
  • Research → documentos de equipo — “Toma esta nota de research y súbela como documento en el área de Producto”.
  • Planificación → ciclo — “Del plan que escribí en planning/Q2.md, crea los épicos y tareas correspondientes en Orkestra”.
  • Status update — “Resume mis últimas 7 daily notes y postéalo como status update del proyecto Y”.

El patrón

No hace falta un plugin. Cualquier cliente MCP (Claude Desktop, Cursor, Windsurf, OpenClaw) puede conectar dos servidores MCP al mismo tiempo: uno apuntando al vault local, otro a Orkestra. El agente mezcla ambos contextos en la misma sesión.

  • Vault local — servidor MCP de filesystem apuntando a la carpeta de tu vault (lectura recomendada, escritura opcional).
  • Orkestra — servidor MCP de Orkestra con tu token de API (configuración estándar descrita en MCP y agentes de IA y Agentes IA).

Configuración con Claude Desktop

Sigue primero la guía de Claude Desktop para agregar Orkestra como servidor MCP (generar token + editar claude_desktop_config.json). Luego, en el mismo archivo, suma el servidor filesystem oficial de MCP apuntando a tu vault. Ambos entries conviven bajo mcpServers.

Claves a usar:

  • Servidor filesystem: npx -y @modelcontextprotocol/server-filesystem /ruta/a/tu/vault. Es el servidor oficial de referencia.
  • Permisos: el servidor filesystem respeta la ruta que le pases. No le des acceso a tu home completo — apunta solo al vault.
  • Reiniciar Claude Desktop después de editar el config.

Si tu vault tiene subcarpetas con material privado (cuentas, contratos, diarios personales), crea un vault separado o apunta el servidor filesystem a una subcarpeta acotada como vault/orkestra-scratch. El agente solo verá lo que le das.

Otros clientes MCP

  • Cursor / Windsurf — soportan MCP nativamente. Mismo patrón: dos entries, uno filesystem y otro Orkestra remoto (Streamable HTTP, https://mcp.orkestra.team/mcp).
  • OpenClaw / HermesAgent — si ya los tienes configurados con Orkestra (ver Agentes IA), suma el servidor filesystem al archivo de config siguiendo la misma sintaxis que ya usan para Orkestra.
  • Plugins dentro de Obsidian — existen plugins community (obsidian-mcp-tools, obsidian-mcp-plugin) que llevan tools MCP dentro de la UI de Obsidian. Si prefieres operar sin salir de la app, son una alternativa al cliente externo. Orkestra no los mantiene ni los certifica; úsalos bajo tu propio riesgo.

Ejemplos de prompts

  • “Abre projects/lanzamiento-v2.md de mi vault y crea las tareas con sus fechas en el proyecto ‘Lanzamiento V2’ de Orkestra. Asígname las que digan @me.”
  • “Resume mi daily de hoy (daily/2026-04-17.md) y comentalo en la tarea ORK-1234.”
  • “Busca en mi vault notas con el tag #research-competencia y crea un documento con el compilado en el área de Producto.”

Qué no hace esta integración

Para fijar expectativas: no hay sync bidireccional automático entre el vault y Orkestra. El agente actúa como puente manual, leyendo de un lado y escribiendo del otro cuando se lo pides. Si quieres espejar contenido sin intervención (ej. que toda edición en vault/wiki/ se refleje en Orkestra), hay que construir un plugin dedicado — hoy no existe. Si te interesa, avísanos.

Consideraciones de seguridad

  • El token MCP de Orkestra tiene los mismos permisos que tu usuario. Usa uno por dispositivo y revoca los que no uses.
  • Las operaciones de escritura pasan por preview/confirm — el agente no ejecuta sin tu OK explícito.
  • El servidor filesystem MCP lee archivos locales sin filtrar. Si dejaste credenciales en una nota del vault, el agente las verá cuando le pidas que busque.
  • Si trabajas con vault sincronizado (Obsidian Sync, iCloud, Dropbox), ten en cuenta que otros dispositivos pueden estar modificando archivos mientras el agente los lee.

Recursos