Claudesidian MCP

Nexus MCP para Obsidian

Nexus brinda a los agentes de IA y al chat integrado acceso a tu bóveda de Obsidian para que puedas leer, escribir, buscar, organizar y automatizar notas en lenguaje natural, manteniendo el almacenamiento local en la bóveda.

Nexus se puede usar de dos maneras:

• Dentro de Obsidian con el chat nativo (¡conéctalo a tu proveedor o plataforma de agentes favorito!)
• Desde agentes externos como Claude Desktop, Claude Code, Codex CLI, Gemini CLI, Cursor, Cline y otros clientes MCP

Nexus es el sucesor de Claudesidian. Las instalaciones heredadas en .obsidian/plugins/claudesidian-mcp/ siguen funcionando.

Configuración

• Instala la última versión desde GitHub Releases: manifest.json, styles.css y main.js
• Colócalos en .obsidian/plugins/nexus/ y habilita Nexus en Obsidian
• Chat nativo en Obsidian: Configuración del proveedor y Guía de chat nativo para chat, voz en vivo, lectura en voz alta y generación integrada de audio/video
• Agente externo vía MCP: usa Configuración de Nexus -> Comenzar -> Agentes externos para crear connector.js y actualizar Claude Desktop; luego consulta la Guía de configuración de MCP y el Prompt de sistema recomendado
• Agente externo vía CLI (sin configuración MCP): instala el comando nexus desde Comenzar -> Agentes externos -> CLI local para que los agentes de shell (Claude Code, Cursor, Codex) puedan manejar tu bóveda directamente — consulta la Guía de Nexus CLI. La instalación la inicia el usuario, escribe solo fuera de la bóveda y, en Windows, agrega el directorio de Nexus al PATH del usuario actual sin derechos de administrador; la desinstalación elimina solo las entradas que Nexus registró como propias.
• Funciones opcionales de escritorio: Búsqueda semántica, Búsqueda adaptativa y Aplicaciones e integraciones

El chat nativo funciona en escritorio y móvil. Los clientes MCP, los proveedores locales de escritorio y la búsqueda semántica son solo de escritorio.

Soporte móvil (Experimental)

El chat nativo funciona en móvil (iOS y Android). Las funciones solo de escritorio se omiten correctamente en móvil: no aparecerán ni causarán errores.

Función	Móvil	Escritorio
Chat nativo	Sí	Sí
Memoria del espacio de trabajo y tareas	Sí	Sí
Habilidades (crear y cargar)	Sí	Sí
Clientes MCP (Claude Desktop, Cursor, etc.)	No	Sí
Puente CLI local (comando nexus)	No	Sí
Búsqueda semántica (incrustaciones locales)	No	Sí
Ingestión (PDF, audio, DOCX)	No	Sí
Captura web a Markdown (web capture-markdown)	Sí	Sí
Composer y el resto de Herramientas web	No	Sí
Análisis de datos (Python sobre CSV/Excel)	No	Sí

El soporte móvil es nuevo y puede tener errores. Por favor, informa problemas en GitHub.

Uso de red

Nexus no realiza llamadas externas por sí solo. No se envía nada cuando el plugin se carga, y no hay telemetría, análisis, informes de errores ni seguimiento de uso de ningún tipo. Tus notas permanecen en tu bóveda a menos que hagas algo que las envíe a algún lugar. Cada solicitud a continuación se enumera con la acción que la provoca.

APIs de proveedores de IA. Se contactan solo cuando ingresas la clave API de ese proveedor y luego la usas. Tu prompt — y cualquier contenido de la bóveda que el agente decida incluir — se envía al proveedor que elegiste, y tu clave solo se envía al proveedor al que pertenece.

Chat y modelos	openrouter.ai, api.openai.com, api.anthropic.com, generativelanguage.googleapis.com, api.mistral.ai, api.groq.com, api.deepseek.com, api.perplexity.ai, router.requesty.ai, api.githubcopilot.com
Voz y transcripción	api.elevenlabs.io, api.deepgram.com, api.assemblyai.com, streaming.assemblyai.com
Flujos de inicio de sesión	auth.openai.com y chatgpt.com (OpenAI Codex), api.github.com (GitHub Copilot)

Ollama y LM Studio se comunican con tu propia máquina y no salen de ella.

Descargas para funciones opcionales de escritorio. Algunas funciones descargan su motor la primera vez que las habilitas, en lugar de incluirse dentro de main.js — la descarga se almacena en caché y no se repite. Nunca habilitar la función significa nunca realizar la solicitud.

Función	Descarga desde
Búsqueda semántica	cdn.jsdelivr.net (transformers.js), huggingface.co (modelo de incrustación)
Caché de vectores	cdn.jsdelivr.net o unpkg.com (sqlite3.wasm)
Análisis de datos	cdn.jsdelivr.net (Pyodide), files.pythonhosted.org (openpyxl)
Ingestión de PDF	cdn.jsdelivr.net (worker de pdf.js)
Modelos locales en el navegador	cdn.jsdelivr.net, esm.run, huggingface.co, raw.githubusercontent.com (pesos del modelo)

Mantenimiento. Abrir la configuración de Nexus verifica si hay una versión más reciente (api.github.com, raw.githubusercontent.com). Pedirle a un agente que cargue el espacio de trabajo de guías integradas obtiene las guías actuales (raw.githubusercontent.com).

No son solicitudes. Dos cosas parecen hosts externos pero no lo son. Las llamadas a OpenRouter y Requesty llevan HTTP-Referer: https://synapticlabs.ai y X-Title: Nexus — los encabezados de atribución de aplicación que esos enrutadores muestran en sus paneles. Son valores de encabezado; no se obtiene nada de esa dirección. Y botones como Descargar Node.js u Obtener una clave API abren nodejs.org, ollama.com, lmstudio.ai, claude.ai, github.com o la consola del propio proveedor (platform.openai.com, console.anthropic.com, aistudio.google.com, etc.) en tu navegador — el plugin nunca los recupera.

Casos de uso

Si quieres...	Comienza aquí
Conectar Claude Desktop, Codex CLI, Gemini CLI, Cursor, Cline u otro cliente MCP	Configuración de MCP
Manejar tu bóveda desde la shell con Claude Code, Cursor o Codex — sin configuración MCP	Nexus CLI
Configurar proveedores de chat integrados dentro de Obsidian	Configuración del proveedor
Usar voz en vivo, leer notas en voz alta o guardar audio hablado en tus notas	Chat nativo
Generar archivos de audio de voz o texto a video directamente en tu bóveda	Chat nativo
Darle a tu agente mejores instrucciones para usar Nexus	Prompt de sistema recomendado
Gestionar trabajo de larga duración con contexto persistente del espacio de trabajo	Memoria del espacio de trabajo
Hacer seguimiento de proyectos, tareas, bloqueos y dependencias	Gestión de tareas
Buscar notas y conversaciones pasadas por significado	Búsqueda semántica
Hacer que la búsqueda aprenda de las notas que realmente abres, totalmente en el dispositivo	Búsqueda adaptativa
Editar texto seleccionado directamente en las notas	Edición en línea
Abrir páginas web en Obsidian y guardarlas como Markdown, PNG o PDF (experimental)	Aplicaciones
Convertir archivos PDF y de audio a notas Markdown — clic derecho en la bóveda o automático al agregar (experimental)	Aplicaciones
Fusionar PDF, concatenar markdown o mezclar pistas de audio en un solo archivo (experimental)	Aplicaciones
Crear y cargar Habilidades de agente reutilizables directamente desde tu bóveda	Aplicaciones
Ejecutar análisis de Python/pandas sobre los datos CSV y Excel de tu bóveda (experimental, escritorio)	Aplicaciones
Crear rutinas recurrentes y flujos de trabajo reutilizables	Ejemplos de flujos de trabajo
Entender el diseño de MCP y las herramientas disponibles	Arquitectura de dos herramientas
Extender Nexus con aplicaciones opcionales	Aplicaciones

Prompt para tu agente

Si quieres que otro agente te guíe en la configuración, pega esto:

Help me set up Nexus for Obsidian and guide me step by step.

Use these docs as the source of truth:
- README: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/README.md
- Provider setup: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/provider-setup.md
- MCP setup: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/mcp-setup.md
- Recommended system prompt: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/recommended-system-prompt.md
- Native chat guide: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/native-chat.md

Start by figuring out whether I want native chat inside Obsidian, an external MCP agent, or both. Ask for my OS and the agent I want to use if that matters. Then walk me through the exact setup path, one step at a time.

When a config file needs to be edited, show the exact snippet with my vault path inserted. Do not invent config formats or skip restart/reload steps. If multiple setup paths are possible, recommend the simplest one first.

Más guías

• Memoria del espacio de trabajo
• Gestión de tareas
• Búsqueda semántica
• Búsqueda adaptativa
• Chat nativo
• Edición en línea
• Aplicaciones
• Ejemplos de flujos de trabajo
• Arquitectura de dos herramientas
• Nexus CLI

Desarrollo

npm install
npm run dev
npm run build
npm run test
npm run lint

Licencia

MIT. Consulta LICENSE.