Conecta Cursor a una base de conocimiento cifrada a través de MCP

Knowtarium es una base de conocimiento con cifrado de extremo a extremo en la que trabajan las personas junto a sus propios agentes de IA. Cursor se conecta a ella por MCP, a través de un pequeño servidor que se ejecuta en tu equipo y descifra ahí las notas. Una vez conectado, el agente de Cursor puede:

• Buscar y leer tus notas, seguir los enlaces entre ellas y encontrar notas relacionadas, en el espacio de trabajo y las carpetas a las que le diste acceso. Las decisiones, las especificaciones y las notas de reuniones están a mano mientras trabaja en tu código.
• Crear y editar notas. Cada cambio se guarda al momento, firmado con la propia clave de Cursor y guardado en el historial, así que puedes ver lo que hizo y deshacerlo con un clic.
• Seguir las instrucciones de tus carpetas. Lo que escribes en la app para un espacio de trabajo o una carpeta (su AGENTS.md) le llega a Cursor siempre que lee y escribe ahí. Solo puede proponer cambios en esas instrucciones, nunca hacerlos.
• Esperarte donde tú quieras. Activa la revisión ("Ask me first") en un espacio de trabajo o una carpeta, y los cambios de Cursor en las notas de ahí esperan como diffs a que los apruebes o los rechaces. Los cambios de carpetas ahí, en cambio, se rechazan, y Cursor te dice qué cambiaría.
• Mover o eliminar notas y cambiar carpetas, solo si le diste esos permisos, y con la indicación de hacerlo solo cuando se lo pidas en la conversación.

No puede acceder a un espacio de trabajo ni a una carpeta que no le diste, firmar como tú, marcar una nota como comprobada por ti ni saltarse la revisión donde la activaste. La lista completa está en la página de agentes.

Necesitas Node.js 20 o posterior (se recomienda 22 o 24) y una cuenta gratuita de Knowtarium. Abre una terminal y ejecuta el comando desde tu carpeta personal. npx confía en la carpeta en la que se ejecuta, así que ejecutarlo dentro de un proyecto permitiría que los archivos de ese proyecto suplantaran a los de Knowtarium.

$ cd ~                          # tu carpeta personal, no un proyecto$ npx knowtarium connect
Opening the browser to connect this computer to Knowtarium.
Connected to workspace ws_8f2k (read and write).
Add Knowtarium to which agents? Cursor
added to Cursor (/Users/you/.cursor/mcp.json)
  previous file saved as /Users/you/.cursor/mcp.json.knowtarium-backup-<time>

1. Aprueba este equipo. Tu navegador abre Knowtarium. Ponle nombre al agente, elige a qué puede acceder (consulta más abajo) y haz clic en Allow, pero solo si ejecutaste el comando tú. Por SSH, donde el navegador no puede llegar a la terminal, confirmas en su lugar un código que coincide en los dos sitios.
2. Elige los agentes. La CLI enumera los agentes que encuentra en tu equipo, todos marcados. Pulsa Enter para añadir Knowtarium a todos, o desmarca algunos antes (las flechas te mueven, la barra espaciadora marca y desmarca, a marca o desmarca todos, Esc no añade ninguno).
3. Cursor recibe su entrada. La CLI añade Knowtarium a los ajustes de usuario de Cursor en ~/.cursor/mcp.json, así que está disponible en todos los proyectos. Deja tus otros servidores y ajustes como están y guarda una copia de seguridad del archivo anterior a su lado. La entrada inicia el servidor desde tu carpeta personal, nunca desde el proyecto que Cursor tiene abierto.
4. Reinicia Cursor. Ciérralo y vuelve a abrirlo para que cargue el servidor nuevo.

En los ajustes de Cursor no va ninguna contraseña, token ni clave. La conexión se guarda cifrada, con su clave en el llavero de tu sistema (o, si no hay, en un archivo que solo tú puedes leer). Para ver qué cambiaría la CLI antes de que escriba nada, ejecuta npx knowtarium agents --dry-run. La CLI es de código abierto: el código está en GitHub.

(se abre a tamaño completo en una pestaña nueva) (se abre a tamaño completo en una pestaña nueva)

Si ya has iniciado sesión en Knowtarium, la app puede añadir el servidor a Cursor por ti. Sigue necesitando Node.js 20 o posterior, porque Cursor inicia el mismo servidor desde npm.

1. Abre Connect an agent. En la aplicación web, ve a Settings, Agents, Connect an agent (app.knowtarium.com/settings/agents/new), en el equipo donde se ejecuta Cursor.
2. Haz clic en Add to Cursor. Cursor se abre y te ofrece instalar el servidor knowtarium. Confírmalo.
3. Conecta este equipo, si aún no lo has hecho. Pídele al agente de Cursor que conecte Knowtarium, o ejecuta una vez el comando desde tu carpeta personal con --no-agents, que deja intactos los ajustes de Cursor. En los dos casos, tu navegador se abre para que apruebes este equipo y elijas a qué accede Cursor.

$ cd ~$ npx knowtarium connect --no-agents

El servidor del enlace se inicia desde tu carpeta personal antes de ejecutar npx, porque Cursor inicia los servidores en la carpeta del proyecto que tienes abierto, y un proyecto ahí podría, si no, colar su propio código en lugar del de Knowtarium.

¿Enlace o comando connect?

En los dos casos, Cursor recibe el mismo servidor, las mismas herramientas y, con ellas, las mismas convenciones. Usa una sola vía, el enlace o el comando, para no complicarte.

La página que se abre en tu navegador decide qué puede hacer esta conexión. Todo se limita a ese agente, y el servidor lo hace cumplir:

• Un espacio de trabajo. Cada conexión llega exactamente a uno. Para darle otro a Cursor, vuelve a ejecutar npx knowtarium connect, elige el otro espacio de trabajo y reinicia Cursor. La primera conexión se mantiene.
• Algunas carpetas, si quieres. Marca solo las carpetas que necesita, como tus notas de ingeniería y tus decisiones. También lee las instrucciones de las carpetas que están por encima, pero no puede proponer cambios en ellas.
• Lectura o lectura y escritura. Empieza con solo lectura si solo quieres que Cursor consulte cosas mientras programa.
• Más que editar, solo si lo marcas. Mover notas, eliminar notas y crear, renombrar, mover o eliminar carpetas son seis permisos distintos, todos desactivados por defecto.

Puedes cambiarlo todo más adelante en la app, en Settings, Agents, y cada vez firmas el nuevo conjunto. Si revocas ahí a Cursor, queda fuera al instante, y el espacio de trabajo recibe una clave nueva, así que no puede leer nada de lo que se escriba después. Desde la terminal, npx knowtarium disconnect revoca el acceso de este equipo y elimina sus claves y su caché locales.

Cursor ya lee las reglas que escribes: reglas de proyecto en .cursor/rules, un AGENTS.md en el repositorio y reglas de usuario que defines en Cursor. Sirven para saber cómo trabajar en una base de código. No son un buen sitio para el conocimiento que la rodea: por qué se tomó una decisión, investigación, notas de reuniones y los datos en los que se apoyan varios agentes y personas, en todos los proyectos que abres.

Para eso está la base de conocimiento. Guarda las reglas de programación en el repositorio y deja que Cursor consulte y anote lo que aprende en Knowtarium, donde Claude Code, Codex y todos los demás agentes que conectes ven las mismas notas.

No necesitas comandos especiales: pídele las cosas al agente de Cursor con palabras normales y él elige las herramientas. Estas son buenas peticiones para empezar, desde solo lectura hasta una edición pequeña y concreta:

> ¿Qué puedes hacer en mi espacio de trabajo de Knowtarium?
 
> Busca en mis notas cómo decidimos el flujo de autenticación
  y responde con enlaces a las notas que hayas usado.
 
> Lee la carpeta decisions y después revisa este archivo
  según lo que decidimos. No cambies ninguna nota.
 
> Escribe lo que acabamos de cambiar en el servicio de facturación
  como una nota nueva en la carpeta engineering.
 
> ¿Qué hay en mi bandeja de entrada? Sugiere una acción para cada recorte.

La primera es una comprobación rápida de que la conexión funciona: Cursor debería nombrar el espacio de trabajo y decir si sus cambios se guardan al momento o esperan tu aprobación. La última lee los recortes que guardaste con el web clipper. Al principio, limita las ediciones y di qué no debe cambiar: es más fácil revisar cuatro notas cambiadas que cuarenta.

Cada cambio que hace Cursor va firmado con su propia clave, así que siempre sabes qué ediciones fueron suyas:

• Un punto en la barra lateral marca cada nota que editó hasta que la abres, y la página del espacio de trabajo las enumera en Edited by agents.
• Bajo el título de una nota, una línea indica que la editó Cursor, con See changes para ver el diff y Undo para recuperar la versión anterior.
• Las eliminaciones, los movimientos y los cambios de carpetas aparecen en la página del espacio de trabajo durante dos semanas, o durante tu periodo de historial si es más corto, en Deleted and reorganized by agents, con Undo y Undo this agent's last 24 hours. Una nota eliminada se puede recuperar mientras tu periodo de historial la conserve.
• El historial guarda cada versión durante el tiempo que elijas, de un día a un año. En cambio, en las carpetas con revisión activada, los cambios esperan en la cola de revisión.

(se abre a tamaño completo en una pestaña nueva) (se abre a tamaño completo en una pestaña nueva)

Nuestra guía para revisar las ediciones de los agentes tiene una rutina para comprobar lo que cambió un agente antes de fiarte de ello.

Cursor no ve Knowtarium

Reinicia Cursor después de añadir Knowtarium. Después comprueba que knowtarium aparece y está activado donde Cursor enumera sus servidores MCP (Customize, en las versiones recientes). Si npx knowtarium connect no enumeró Cursor, añádelo por su nombre: npx knowtarium agents --agent cursor, desde tu carpeta personal.

La CLI se saltó los ajustes de Cursor

Nunca sobrescribe un archivo que no puede editar con seguridad. Si ~/.cursor/mcp.json no es JSON válido o tiene comentarios, la CLI lo dice y no lo toca. También muestra una línea "add it by hand" con una entrada de servidor: ignórala, porque una entrada que escribes tú ejecuta npx en la carpeta del proyecto. Corrige el archivo (o quita los comentarios, o apártalo) y vuelve a ejecutar npx knowtarium agents.

Comprueba la conexión

npx knowtarium status muestra los espacios de trabajo conectados, su acceso y sus cambios, el token y la caché local, y dice dónde se guardan las claves.

knowtarium te pide que actualices

Si usaste el comando, ejecuta npx knowtarium@latest agents desde tu carpeta personal. Actualiza a la nueva versión la entrada de knowtarium en ~/.cursor/mcp.json (y las de tus otros agentes). Si usaste el enlace, vuelve a hacer clic en Add to Cursor en la app. Después, reinicia Cursor.

$ cd ~$ npx knowtarium@latest agents$ npx knowtarium status

Los cambios esperan aprobación cuando esperabas que se guardaran

Cursor te dice si cada cambio se guardó o se propuso, y por qué: la carpeta pide revisión, no se pudieron verificar los ajustes del espacio de trabajo, se alcanzó el límite diario de cambios directos o esta conexión solo puede proponer. En este último caso, vuelve a ejecutar npx knowtarium connect desde tu carpeta personal y después reinicia Cursor.