Servidor MCP

Última actualización: 20 de octubre de 2026

Da a otras apps de IA, como Claude Code, acceso de lectura a tu bóveda a través del servidor MCP integrado en MindLake.

Qué hace

MCP (Model Context Protocol) es un estándar abierto que usan las apps de IA para conectar herramientas. MindLake tiene un servidor MCP integrado: apunta un cliente MCP hacia él y la IA del cliente podrá buscar en tu bóveda, leer notas, listar tareas, leer tus listas y lienzos y seguir enlaces entrantes.

El servidor es la propia app MindLake, iniciada con --mcp-serve. Funciona en tu Mac y lee directamente los archivos de tu bóveda, así que MindLake no tiene que estar abierta. Es de solo lectura: nada conectado de esta forma puede crear, cambiar ni borrar nada. No tiene ningún ajuste en MindLake; se añade en el cliente.

Antes de empezar

Una licencia o una prueba en este Mac. El servidor solo se inicia donde MindLake se abriría: con licencia o dentro de su prueba (consulta Prueba y licencia). Comprueba la última licencia que guardó MindLake, sin conectarse a internet. Si no, se detiene al instante con “MindLake is not licensed on this Mac” (código de salida 3); abrir MindLake lo resuelve.
La ruta completa de tu bóveda. Tiene que empezar por /Users/, porque una ruta que empieza por ~ no funciona. Para copiarla, mantén pulsada Opción mientras haces clic con el botón derecho en la carpeta de la bóveda en el Finder y elige Copiar como nombre de ruta. Tu bóveda explica dónde vive.

Conecta un cliente

Copia la ruta completa de tu bóveda.
Añade el servidor a tu cliente, con la ruta de tu propia bóveda en lugar de la del ejemplo (abajo).
Si quieres, añade --index para la búsqueda por relevancia (consulta Resultados por relevancia).
Reinicia el cliente, o empieza una sesión nueva, para que detecte el servidor.

En Claude Code, añádelo desde Terminal:

Terminal

claude mcp add --scope user mindlake -- \
  /Applications/Mindlake.app/Contents/MacOS/Mindlake --mcp-serve \
  --vault "/Users/you/Library/Mobile Documents/com~apple~CloudDocs/Mindlake/My Vault"

Las apps que se configuran con un archivo JSON llevan en su lugar una entrada como esta:

Configuración del cliente MCP

{
  "mcpServers": {
    "mindlake": {
      "type": "stdio",
      "command": "/Applications/Mindlake.app/Contents/MacOS/Mindlake",
      "args": [
        "--mcp-serve",
        "--vault", "/Users/you/Library/Mobile Documents/com~apple~CloudDocs/Mindlake/My Vault"
      ]
    }
  }
}

Si MindLake no está en tu carpeta Aplicaciones, cambia el principio del comando para que coincida.

Argumento	Qué hace
`--mcp-serve`	Ejecuta MindLake como servidor MCP en lugar de abrir su ventana.
`--vault`	Obligatorio. La ruta completa de la bóveda que se sirve. Sin él, el servidor se detiene con el código de salida 2.
`--index`	Opcional. La ruta completa del índice de búsqueda de MindLake, que añade find_notes.

Resultados por relevancia

Añade --index con la ruta completa del índice de búsqueda de MindLake y el cliente también obtiene find_notes, la búsqueda por relevancia que usa el propio asistente de MindLake. En un archivo JSON, añade ambos como dos entradas más en args.

Argumentos adicionales

--index "/Users/you/Library/Application Support/Mindlake/Search/index.sqlite"

El índice cubre la bóveda abierta en MindLake y se mantiene al día mientras MindLake está en marcha, así que pasa la ruta de esa bóveda. Si Find notes by meaning está activado (Settings ▸ AI ▸ Advanced, en Understanding), también busca por significado. Si falta el archivo, el servidor se inicia sin find_notes.

Qué ofrece

Herramienta	Qué hace
`find_notes`	Encuentra las notas sobre un tema, con las mejores primero, cada una con un extracto y el motivo de la coincidencia. Filtra por etiqueta, persona, carpeta y fecha. Devuelve 10 salvo que se pidan más, hasta 40. Solo se ofrece con --index.
`search_vault`	Búsqueda de texto simple en las notas, que devuelve cada línea coincidente y su nota (hasta 60 líneas).
`read_note`	Lee una nota por su ruta en la bóveda (hasta 120.000 caracteres).
`list_notes`	Lista las rutas de las notas, de toda la bóveda o de una carpeta (hasta 500).
`list_tasks`	Lista las tareas con casilla con sus fechas de vencimiento, prioridades, etiquetas y personas: abiertas, hechas o todas (hasta 200). Su filtro owner acepta me (tus tareas y las que no tienen responsable), others o all, y es all si no se pide otra cosa; se basa en tu nombre de Settings ▸ Brain y se ignora si no hay ninguno.
`list_tables`	Lista tus listas (tablas) con sus columnas y su número de filas.
`read_table`	Lee las columnas y filas de una lista como CSV (50 filas salvo que se pidan más, hasta 500).
`get_backlinks`	Encuentra las notas que enlazan a una nota con [[wikilinks]].
`list_canvases`	Lista tus lienzos y cuántos elementos contiene cada uno.
`read_canvas`	Lee un lienzo como texto de diagrama de flujo Mermaid.

Normas de seguridad

Solo lectura. El servidor no ofrece herramientas que escriban y rechaza cualquier petición de hacerlo.
Solo tu bóveda. Se rechazan las rutas fuera de la carpeta de bóveda que le indicaste.
Las notas bloqueadas siguen bloqueadas. No se pueden leer, y nunca se buscan ni se indexan.
Todo lo demás se puede leer. Cualquier archivo de texto de la bóveda se puede leer, incluidos tus chats guardados en la carpeta Chats.
Los resultados tienen límite. Cada llamada devuelve una cantidad limitada, como se indica arriba.
Se aplican las normas de tu cliente. Si pregunta antes de cada llamada a una herramienta depende del cliente, y lo que lee va al proveedor de IA de ese cliente según las condiciones del proveedor. MindLake nunca lo recibe.

Cuando un cliente se conecta, el servidor también le explica cómo están organizadas las notas de MindLake (consulta Formato de archivo), para que su IA las lea correctamente.

Escribir desde otras apps

El servidor integrado en MindLake no puede crear ni cambiar notas. Un servidor aparte, mindlake-mcp, añade cuatro herramientas que escriben: create_note, edit_note, append_to_note y write_canvas. Sus cambios pasan por la misma comprobación de contenido perdido que el chat, y --read-only desactiva sus herramientas de escritura. No está incluido en la descarga de MindLake ni tiene ajuste en la app: donde está instalado, se añade a un cliente a mano, igual que arriba.

Para que una IA edite tus notas con la app tal como se distribuye, usa el chat de MindLake, que comprueba cada cambio en busca de contenido perdido y guarda las versiones anteriores de la nota.