Conecta OneMira a Cursor ejecutando el servidor MCP local de OneMira mediante stdio, registrando ese comando exacto en Cursor, revisando las herramientas expuestas y probando una consulta de solo lectura sobre una nota local conocida. No pegues un token remoto en la configuración de un servidor local, salvo que la herramienta documentada lo requiera realmente.

Nota sobre versiones. Las interfaces de Cursor y MCP cambian. Esta guía se contrastó con la documentación oficial MCP/CLI de Cursor y las recomendaciones de seguridad MCP disponibles el 16 de julio de 2026. Los comandos de OneMira deben corresponder a la versión de escritorio instalada.

¿Qué estás conectando?

MCP separa la aplicación anfitriona de IA de un servidor que expone herramientas o recursos. Cursor actúa como anfitrión/cliente. El servidor OneMira es un proceso local que lee un almacén de notas OneMira delimitado y devuelve resultados estructurados. El modelo no recibe automáticamente toda la carpeta, sino el resultado de una llamada a una herramienta aprobada y enviada por el anfitrión.

La arquitectura oficial MCP admite servidores locales mediante stdio. Las recomendaciones de seguridad aconsejan stdio para servidores locales cuando sea práctico, porque limita el acceso al cliente que los inicia. También advierten de que un servidor local se ejecuta con los privilegios del sistema operativo del cliente.

¿Qué debes comprobar antes de añadir Cursor?

  1. Instala la aplicación de escritorio OneMira compatible y completa la sincronización C1 documentada.
  2. Abre la carpeta local de notas y elige una nota de prueba sin información sensible.
  3. Ejecuta el comando de diagnóstico de OneMira o de listado MCP indicado por la versión instalada.
  4. Confirma la ruta del ejecutable con command -v o mediante una ruta absoluta.
  5. Revisa el comando: debe iniciar el servidor local conocido de OneMira, no un paquete npx sin revisar ni una cadena de comandos de shell.

La documentación actual de OneMira es la referencia para los nombres de comandos: consulta la configuración MCP y la referencia CLI. Un artículo del blog no debe fijar una ruta de instalación que varía entre versiones de macOS y Windows.

¿Cómo añades el servidor local en Cursor?

Cursor admite servidores MCP y su CLI ofrece comandos para listarlos e inspeccionar sus herramientas. En los ajustes MCP de Cursor, añade un servidor local stdio e introduce el ejecutable OneMira y los argumentos exactos de la documentación instalada. Una configuración conceptual tiene esta estructura: 

{
  "mcpServers": {
    "onemira": {
      "command": "/absolute/path/to/onemira",
      "args": ["mcp", "serve"],
      "env": {
        "ONEMIRA_NOTES_ROOT": "/absolute/path/to/OneMira"
      }
    }
  }
}

Es una estructura de ejemplo, no una garantía de que todas las versiones usen esos nombres de argumentos. Copia el comando de la documentación instalada o de la aplicación y limita al máximo la carpeta raíz de notas. No la establezcas en ~ ni en toda la unidad.

Primer plano desde un ángulo bajo del lateral metálico, el puerto USB-C y la cubierta transparente del C1 blanco plateado sobre una superficie oscura.
El lateral metálico y la cubierta transparente del C1 vistos a la altura de la mesa.

¿Cómo verificas la conexión de forma objetiva?

La referencia CLI oficial de Cursor incluye cursor-agent mcp list y cursor-agent mcp list-tools <identifier>. Úsalos si están disponibles en tu versión instalada: 

cursor-agent mcp list
cursor-agent mcp list-tools onemira

Después, realiza una prueba en cuatro partes:

  1. Detección: Cursor muestra el servidor OneMira como conectado.
  2. Revisión de herramientas: los nombres y parámetros coinciden con la documentación OneMira; no aparecen herramientas inesperadas de shell, red o acceso a todo el sistema de archivos.
  3. Lectura con respuesta conocida: busca una frase única de la nota de prueba y comprueba el fragmento devuelto y su ruta de origen.
  4. Prueba fuera del ámbito: solicita un archivo situado fuera de la carpeta raíz configurada y confirma que el servidor rechaza la petición o no puede acceder a él.

Anota la versión del servidor, la de Cursor, la ruta de configuración, la lista de herramientas y el resultado. Un indicador verde de «conectado» no demuestra por sí solo que los datos correctos sean accesibles ni que se respeten los límites.

¿Qué datos pueden cruzar este límite?

Hay dos pasos. La herramienta MCP local lee una nota y devuelve texto a Cursor. Después, Cursor puede enviar ese texto al modelo seleccionado según sus condiciones y las del proveedor del modelo. Un servidor MCP local limita cómo se recupera el contexto; no garantiza que el contexto recuperado permanezca en el ordenador.

Utiliza un acceso progresivo:

  • busca primero metadatos y fragmentos breves;
  • recupera una nota completa solo cuando sea pertinente;
  • excluye las carpetas sensibles por defecto;
  • prefiere herramientas de solo lectura, salvo que una escritura sea explícitamente necesaria;
  • revisa cualquier cambio de archivo generado por un agente mediante un diff.

¿Cómo diagnosticas los fallos?

Síntoma Qué comprobar Qué evitar
El servidor no se inicia Ruta absoluta del ejecutable, permisos, comillas, versión de la aplicación Sustituirlo por un paquete desconocido
Conectado, pero sin herramientas Registros del servidor, negociación del protocolo, versión de la función instalada Conceder permisos amplios al sistema de archivos
La herramienta no devuelve notas Carpeta raíz, estado de sincronización, frase de prueba conocida, mayúsculas y minúsculas de la ruta Usar toda la carpeta personal como raíz
Error de ruta en Windows Escape JSON y formato de la ruta absoluta Copiar literalmente una ruta de macOS
Llamada inesperada a una herramienta Cancelar y revisar la descripción y los argumentos Aprobar porque el servidor es «local»

¿Cómo retiras el acceso correctamente?

Desactiva o elimina la entrada del servidor OneMira en Cursor, reinicia el anfitrión y comprueba que ya no aparece en la lista MCP. Elimina las credenciales de entorno añadidas específicamente para ese servidor. Las notas siguen siendo archivos locales normales: retirar el acceso MCP no las elimina.

Para conocer el diseño general del contexto, lee De la conversación al contexto. Para los límites de seguridad de MCP, consulta las fuentes oficiales siguientes.

Fuentes y lecturas adicionales