Tu segundo cerebro con Claude + Obsidian

Al terminar esta enseñanza vas a tener un asistente que conoce tu negocio porque lo lee de tus notas. En vez de empezar cada conversación con Claude explicándole quién es el cliente, qué hablasteis la última vez o en qué punto está el proyecto, basta con apuntarle al fichero o a la carpeta correspondiente y él reconstruye el contexto solo. Para freelancers, consultores y dueños de negocios pequeños sin equipo administrativo, esto es la diferencia entre tener un asistente teórico y tener uno que realmente quita carga.

El sistema cubre cuatro roles que en una empresa con plantilla harían tres o cuatro personas distintas. Como asistente personal lleva tu agenda y los seguimientos pendientes a partir de las notas de reuniones. Como gestor de proyectos te mantiene la foto de en qué estado están los plazos. Como redactor escribe presupuestos, correos y propuestas usando el tono y los datos que ya están guardados. Como analista cruza información entre clientes, detecta patrones y te avisa de qué necesita atención. Todo a partir del mismo material: tus notas en texto plano.

El montaje completo lleva entre una y dos horas la primera vez, casi todo dedicado a decidir la estructura de carpetas y a elegir el servidor MCP que mejor encaja con tu cliente. La parte técnica en sí (instalar Obsidian, configurar el MCP, apuntar la ruta) son veinte minutos. La parte conceptual (decidir cómo organizas tu negocio en notas) es donde merece la pena pensar despacio porque esa estructura te va a acompañar mucho tiempo.

Antes de empezar

Los requisitos están en el frontmatter: Obsidian instalado (gratis, completamente local, sin suscripción ni cuenta obligatoria), un cliente con MCP funcionando (Claude Desktop o Claude Code) y Node.js para arrancar el servidor. Si todavía no tienes la conexión MCP montada en tu cliente, conviene pasar antes por la enseñanza de conectar Claude con MCP que se enlaza al final: el paso de filesystem es esencialmente el mismo patrón que vamos a aplicar aquí con la bóveda.

Una recomendación previa que ahorra dolores de cabeza: decide desde el principio si quieres dar a Claude solo lectura o también escritura sobre tus notas. Algunos servidores MCP de Obsidian permiten ambas, y cada decisión tiene implicaciones. Lectura es seguro y útil para empezar; escritura es potente pero exige más confianza y, sobre todo, una bóveda bajo control de versiones (idealmente sincronizada con git) para que un error no te borre algo valioso.

El recorrido completo

El primer paso, instalar Obsidian y crear tu bóveda, no tiene misterio técnico pero sí una decisión de fondo. Una bóveda es simplemente una carpeta del disco donde Obsidian guarda tus notas en archivos Markdown planos. No hay servidor remoto, no hay base de datos opaca, no hay formato propietario: si mañana abandonas Obsidian, tus notas siguen ahí en .md legibles con cualquier editor. Esta portabilidad es lo que hace al sistema robusto a largo plazo, mucho más que cualquier app propietaria de notas.

El segundo paso, montar la estructura, es donde se gana o se pierde la pelea. La trampa habitual es crear veinte carpetas el primer día para “estar preparado” y acabar con un sistema que nadie mantiene. La sugerencia del frontmatter (Clientes, Proyectos, Reuniones, Ideas) cubre los casos típicos de un negocio pequeño y se queda corta antes de quedar grande. Una nota por cliente con su historial, una por proyecto con su estado y plazos, una por reunión fechada y una carpeta-cubo para ideas sueltas que ya organizarás después. Si tu trabajo tiene otros ejes (productos, regiones, áreas), adapta los nombres pero mantén la lógica de “una nota por entidad estable, capturas por fecha en el cubo”.

El tercer paso, instalar un servidor MCP de Obsidian, abre dos caminos. El más extendido pasa por el plugin de la comunidad “Local REST API” dentro de Obsidian, que expone una API local en tu propio equipo y entrega una API key. El servidor MCP se conecta a esa API y, a través de él, Claude lee y eventualmente escribe en la bóveda. La alternativa es un servidor MCP que lee directamente los archivos del disco sin pasar por la API; es más simple pero pierde algunas funciones avanzadas de Obsidian (búsqueda interna, propiedades, enlaces). Cualquiera de los enlaces del frontmatter te lleva a un servidor mantenido; sigue el README de la versión que esté vigente porque las instrucciones cambian entre releases.

El cuarto paso, apuntar Claude a la bóveda, es donde se materializa la conexión. En el archivo de configuración MCP del cliente que uses (claude_desktop_config.json en Claude Desktop, configuración equivalente en Claude Code), añades el bloque del servidor de Obsidian indicando la ruta absoluta de la carpeta de tu bóveda y, si el servidor lo pide, la API key del plugin Local REST API. La ruta tiene que ser absoluta y exacta, respetando mayúsculas y separadores del sistema operativo. Tras guardar el cambio, cierra el cliente del todo y vuelve a abrirlo para que cargue el nuevo servidor.

El quinto paso, probar con una orden real, es lo que convierte el montaje en herramienta. Pídele algo que ejercite el flujo completo: leer una carpeta, sintetizar lo que encuentra, devolverlo priorizado. Por ejemplo, un resumen de proyectos activos con sus próximos plazos. Observa cómo Claude pide permiso antes de leer, cómo lista los archivos que va a consultar y cómo devuelve una síntesis. La primera vez que esto funciona es uno de esos momentos en que te das cuenta de que el agente ya no es un chat: es un asistente con memoria viva sobre tu trabajo.

Por debajo, lo que está pasando es lo mismo que con cualquier servidor MCP: Claude formula una llamada a una herramienta del servidor (leer este archivo, listar esta carpeta, buscar este término), el servidor accede a la bóveda con los permisos que le diste y devuelve el resultado, que Claude incorpora a su contexto. Tus notas en sí no se suben a Anthropic en bruto; viajan los fragmentos que el servidor entrega como respuesta a las consultas concretas.

Una pieza opcional pero muy útil es una nota llamada “instrucciones” o “ai-system” en la raíz de la bóveda, donde escribes tu criterio (tono, datos sensibles que no debe revelar, formato de presupuestos, política de seguimientos). Si en tus prompts le pides a Claude que lea esa nota primero, tendrás una capa de personalización persistente sin tener que repetirla cada vez.

Cómo saber que cada parte funciona

La conexión está sana cuando Claude lista la bóveda al pedírselo y devuelve nombres de archivos reales que tú reconoces. Si te dice que no encuentra archivos o devuelve nombres genéricos, la ruta de configuración no apunta al sitio correcto o el servidor no arrancó bien. La lectura está fina cuando le pides un resumen de una carpeta y la síntesis menciona detalles específicos que solo pueden venir de tus notas (nombres propios, fechas, importes). Si la respuesta es plana, el servidor está leyendo poco o muy filtrado.

Si tu servidor permite escritura, prueba primero sobre una carpeta de prueba con notas duplicadas, no sobre tu material real. Pídele que cree una nota nueva, que modifique una existente y que añada al final de otra. Hasta que veas que respeta lo que le pides exactamente, no le des paso libre sobre la bóveda principal.

Errores frecuentes y cómo salir de ellos

• Claude no ve la bóveda. La ruta en el archivo de configuración no es absoluta o tiene un error de escritura. Vuelve a copiarla desde el navegador de archivos del sistema y reinicia el cliente.
• El servidor MCP no arranca. Comprueba que Node.js responde y revisa los logs del cliente para ver el mensaje de error concreto. La mayoría de fallos al arrancar son versiones de Node incompatibles o dependencias del servidor que no se instalaron.
• Pide API key y no sabes dónde está. En Obsidian, ve a Configuración → Plugins de la comunidad, activa “Local REST API” y dentro de sus opciones encontrarás la key generada. Cópiala al bloque de configuración del servidor MCP.
• Claude escribió donde no querías. Sé más específico con la carpeta y el nombre exacto en el prompt; trabaja sobre una copia de la bóveda mientras te acostumbras al comportamiento del servidor.
• Las búsquedas devuelven resultados parciales. Si tu servidor pasa por la API local, asegúrate de que el plugin está activo y respondiendo; si lee directo del disco, verifica que no estés ignorando algún directorio por la configuración del servidor.
• Tras un cambio de versión todo deja de funcionar. Lee el changelog del servidor MCP: a veces cambian parámetros del archivo de configuración entre versiones. Revertir a la versión anterior es legítimo si necesitas seguir trabajando.

Variaciones útiles

Si trabajas con clientes en sectores con datos especialmente sensibles (legal, sanitario, financiero), considera dos bóvedas separadas: una con material trabajable por Claude y otra con datos confidenciales que el agente no toca. La configuración MCP apunta solo a la primera. Si eres un equipo pequeño que comparte clientes, una bóveda en un repositorio git compartido (no en Dropbox ni iCloud, que pelean con el formato Markdown) os permite que cada miembro conecte su propio Claude a la misma fuente sin pisarse.

Otra variación interesante para profesionales con mucho histórico es alimentar la bóveda desde fuentes externas: transcripciones de reuniones (con notebookLM o herramientas similares), notas de voz pasadas a texto, capturas de correos importantes. Cuanto más material relevante esté en notas Markdown bien estructuradas, más útil se vuelve el agente. La clave sigue siendo la estructura: archivos pequeños, con títulos descriptivos, en carpetas claras.

Siguiente paso

El paso natural es profundizar en la pieza que sostiene esta enseñanza: obsidian en la ficha del servidor MCP y que-es-mcp para el concepto general. Si todavía no tienes la conexión MCP a punto, pasa por conectar-claude-con-mcp. Y para escalar a más automatización sobre el mismo flujo, equipar-claude-code-skills-mcps.