Cómo conectar Obsidian a YouMind con MCP
Tu bóveda de Obsidian probablemente ya contiene todo lo que necesitas para tu próximo proyecto: investigación, planes, notas de lectura y tareas sin terminar. Conectarla a YouMind te permite convertir esas notas en algo que puedas usar, con una simple solicitud en lenguaje natural.
En esta guía, conectarás una bóveda local de Obsidian a YouMind, le pedirás a YouMind que lea y organice un conjunto de notas, y guardarás el resultado de vuelta en Obsidian. El ejemplo utiliza cinco notas sobre alimentación antiinflamatoria para crear un plan de acción con enlaces a las fuentes originales.
Antes de empezar
Necesitarás:
- La versión de escritorio de Obsidian y una bóveda que puedas editar.
- Una cuenta de YouMind con acceso a conectores personalizados.
- Una cuenta de ngrok. Usaremos ngrok para darle a tu servidor MCP local una dirección HTTPS a la que YouMind pueda acceder.
- Algunas notas con las que trabajar. Puedes usar tu propia investigación, notas de proyecto o notas de planificación de comidas.
La conexión funciona así:
YouMind → dirección HTTPS de ngrok → Conector MCP → tu bóveda de Obsidian
MCP, abreviatura de Model Context Protocol (Protocolo de Contexto del Modelo), permite que una aplicación de IA utilice herramientas proporcionadas por otra aplicación. El plugin de Obsidian expone herramientas para trabajar con tu bóveda, y YouMind las usa para ejecutar tu solicitud.
Mantén tu computadora despierta y conectada a internet, con Obsidian, la bóveda conectada y ngrok ejecutándose cada vez que uses esta conexión. La dirección local 127.0.0.1 solo apunta a tu propia computadora, por lo que YouMind necesita la dirección de ngrok para alcanzarla.
El conector puede leer o modificar notas según los permisos que le otorgues. Mantén su token privado y usa los permisos de herramientas del plugin y la configuración de carpetas ocultas para controlar el acceso. El contenido utilizado en una tarea pasa a través de ngrok y YouMind; conectar una bóveda no sincroniza automáticamente toda la bóveda.
Las capturas de pantalla muestran el flujo de trabajo en macOS. Algunos detalles de la cuenta se han eliminado o reemplazado con valores de ejemplo.
1. Permitir plugins de la comunidad en Obsidian
Abre Configuración → Plugins de la comunidad en Obsidian.
Si tu bóveda está en modo Restringido, haz clic en Salir del modo restringido para permitir plugins de la comunidad.
Haz clic en Examinar para abrir el directorio de plugins de la comunidad.
2. Instalar y habilitar MCP Connector
Busca MCP Connector y selecciona el plugin de istefox. Verifica el nombre del autor, ya que el directorio incluye plugins con nombres similares.
Abre sus detalles y haz clic en Instalar.
Después de la instalación, haz clic en Habilitar.
Abre MCP Connector en la configuración de Obsidian para configurar su servidor local y token de acceso. Puedes encontrar más información en la página del directorio del plugin.
3. Establecer un puerto de servidor fijo
Busca Puerto fijo, ingresa 27200 y haz clic en Guardar.
La sección Puerto del servidor ahora debería mostrar:
http://127.0.0.1:27200/mcp
Un puerto fijo mantiene tu conexión de ngrok apuntando al mismo servicio local. Si el puerto 27200 ya está en uso, elige un puerto disponible y usa ese número en el comando de ngrok a continuación.
4. Crear un token para YouMind
En Control de acceso, haz clic en Agregar token.
Nombra el nuevo token YouMind para que puedas reconocerlo más tarde.
Haz clic en Copiar en la fila de ese token. Lo pegarás en YouMind en un paso posterior.
Cada token puede tener sus propios permisos de herramientas. Este ejemplo necesita permiso para leer notas y crear una nueva nota. Las capturas de pantalla usan la configuración Las 52 herramientas del plugin; el número de herramientas disponibles puede cambiar según la versión del plugin y tu configuración.
Trata el token como una contraseña por el acceso que otorga. No es necesario que lo pegues en un chat de IA.
5. Iniciar un túnel de ngrok
Si aún no has instalado ngrok, sigue las instrucciones oficiales de configuración. En macOS, si ya usas Homebrew, instálalo con:
brew install ngrok
Agrega el authtoken de tu panel de ngrok:
ngrok config add-authtoken TU_AUTHTOKEN_NGROK
El authtoken de ngrok conecta ngrok a tu cuenta. El token de Obsidian del paso anterior le da a YouMind acceso a tu bóveda. Mantén estas dos credenciales separadas.
En Terminal, ejecuta:
ngrok httphttp://127.0.0.1:27200
Mantén esta sesión de terminal ejecutándose. Una vez que Estado de la sesión indique en línea, copia la dirección HTTPS que se muestra en la línea Reenvío.
Agrega /mcp al final de esa dirección. Tu URL final del conector debe tener esta estructura:
https://TU_DOMINIO_NGROK/mcp
Usa el dominio real que se muestra en tu propia sesión de ngrok. El dominio en la captura de pantalla es un ejemplo. Si tu dirección de reenvío cambia más tarde, actualiza también la dirección guardada en YouMind.
6. Agregar el conector personalizado en YouMind
En YouMind, abre Configuración → Conectores y haz clic en Agregar conector personalizado.
Ingresa un nombre, como obsidian, y pega tu dirección de ngrok con /mcp al final. Expande Configuración avanzada. En Parámetros personalizados, haz clic en Agregar parámetro y configura lo siguiente:
Configuración | Valor |
|---|---|
Nombre |
|
URL del servidor | Tu dirección HTTPS de ngrok, seguida de |
ID de cliente OAuth | Déjalo en blanco |
Secreto de cliente OAuth | Déjalo en blanco |
Parámetro personalizado |
|
Valor del parámetro |
|
Secreto | Activado |
Reemplaza TU_TOKEN_OBSIDIAN con el token completo que copiaste de Obsidian. Incluye un espacio después de **Bearer**. Por ejemplo, si tu token fuera token-ejemplo, el valor sería:
Bearer token-ejemplo
Esto es solo un ejemplo de formato. Usa tu propio token en la configuración real. Esta conexión utiliza autenticación de Token Bearer, así que deja los dos campos de OAuth en blanco.
Haz clic en Agregar, luego busca obsidian en la lista de conectores y haz clic en Conectar.
Deberías ver Conectado junto a su nombre.
Ahora verifiquemos la conexión con una tarea que lea notas y escriba una nueva.
7. Preparar algunas notas relacionadas
YouMind necesita contenido real para trabajar. Para este ejemplo, la bóveda contiene cinco notas en inglés:
Nota | Lo que contiene |
|---|---|
Conceptos Básicos de Alimentación Antiinflamatoria | Principios generales de alimentación y objetivos para la primera semana |
Lista de Compras Antiinflamatoria | Una lista de compras y sustituciones de ingredientes |
Plan de Comidas Antiinflamatorio de 7 Días | Una semana de desayunos, almuerzos y cenas |
Preparación de Comidas Antiinflamatorias Simple | Pasos de preparación, recetas sencillas y notas de almacenamiento |
Revisión Semanal Antiinflamatoria | Una plantilla de revisión y tareas de seguimiento sin terminar |
Estas notas son material de muestra para demostrar el flujo de trabajo. No son un plan médico o nutricional personalizado.
Puedes usar un tema diferente. Por ejemplo, combina notas de lectura en una guía de estudio, convierte notas de proyecto en una lista de próximos pasos u organiza la investigación de viajes en un itinerario. Actualiza el tema en el prompt para que coincida con las notas de tu bóveda.
8. Pídele a YouMind que lea, organice y guarde
Inicia una nueva tarea en YouMind e ingresa:
Revisa mis notas de Obsidian sobre alimentación antiinflamatoria. Resume los principios clave, conecta la lista de compras con el plan de comidas e identifica tres tareas pendientes.
Guarda el resultado en inglés como una nueva nota de Obsidian titulada "Plan de Acción de Alimentación Antiinflamatoria", con enlaces internos a las notas de origen.
El prompt le indica a YouMind qué notas leer, cómo organizar la información, qué tareas identificar y dónde guardar el resultado. También nombra la nueva nota y solicita enlaces a las fuentes, lo que facilita la verificación del resultado.
Envía la tarea. YouMind usará el conector para encontrar y leer las notas relevantes, y luego armará el resultado. Puedes seguir su progreso en la conversación.
9. Abrir la nueva nota en Obsidian
En este ejemplo, YouMind devolvió:
- Un resumen de los principios de la nota introductoria.
- Conexiones entre la lista de compras y el plan de comidas, incluyendo qué ingredientes aparecen en múltiples comidas.
- Tres tareas pendientes: planificar el viaje de compras, elegir almuerzos y sesiones de preparación, y completar la revisión posterior.
- Una nueva nota titulada Plan de Acción de Alimentación Antiinflamatoria, con enlaces internos a las cinco notas originales.
Todas las tareas completadas se refiere a la tarea de lectura, organización y escritura de YouMind. Las compras y la preparación de comidas siguen siendo acciones de seguimiento para la persona que usa el plan.
Vuelve a Obsidian y abre Plan de Acción de Alimentación Antiinflamatoria.
La nueva nota aparece en la lista de archivos y su contenido está guardado en tu bóveda. En esta ejecución, también incluye etiquetas y enlaces en los que se puede hacer clic a las notas originales. La vista de gráfico muestra esas conexiones junto con las notas existentes.
Ahora puedes seguir editando en Obsidian o pedirle a YouMind que continúe con una solicitud más específica, como expandir una sección o actualizar el plan usando otra nota.
Solución de problemas
¿Por qué veo 401 No autorizado?
Verifica el parámetro Authorization. Su valor debe ser Bearer, seguido de un espacio y tu token completo de Obsidian. Asegúrate de haber copiado el token de MCP Connector. Si lo regeneraste o revocaste, actualiza el valor en YouMind.
¿Por qué veo "Error de descubrimiento de metadatos del servidor de autorización OAuth (404)"?
Una verificación de token fallida puede hacer que el cliente intente el descubrimiento OAuth. Esta conexión del plugin usa un Token Bearer, así que primero verifica el encabezado de Authorization y mantén los campos de ID de cliente OAuth y Secreto de cliente OAuth en blanco. Un prefijo Bearer faltante puede producir este error.
¿Por qué abrir la URL /mcp en un navegador devuelve 405?
El endpoint MCP del plugin acepta solicitudes MCP a través de POST. Abrir una URL en la barra de direcciones de un navegador normalmente envía GET, lo que puede devolver 405 Método no permitido. Verifica la conexión a través de YouMind y una tarea real.
¿Por qué una conexión que funcionaba dejó de responder?
Verifica que tu computadora esté despierta y en línea, que Obsidian tenga la bóveda correcta abierta, que el plugin esté habilitado y que ngrok aún muestre en línea. Luego compara el puerto local y la URL de ngrok con los valores guardados en YouMind.
¿Qué hago si no puedo encontrar la nueva nota?
Busca en la bóveda conectada el título que especificaste en el prompt. Verifica que el token permita crear notas. También puedes pedirle a YouMind la ruta exacta relativa a la bóveda del archivo que creó y luego abrir esa ruta en Obsidian.
¿Listo para probarlo con tus propias notas? Abre YouMind y pídele que convierta algunas notas relacionadas en una nueva página útil en tu bóveda.