Conecta Claude Code 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. Claude Code 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, Claude Code 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.
• Crear y editar notas. Cada cambio se guarda al momento, firmado con la propia clave de Claude Code 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 Claude Code 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 Claude Code 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 Claude Code 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? Claude Code
added to Claude Code (/Users/you/.claude.json)
  previous file saved as /Users/you/.claude.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. Claude Code recibe su entrada. La CLI añade Knowtarium a los ajustes de usuario de Claude Code en ~/.claude.json (en $CLAUDE_CONFIG_DIR si lo has definido). 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 Claude Code tiene abierto.
4. Reinicia Claude Code. Carga los servidores nuevos al iniciarse, así que cierra cualquier sesión que ya estuviera abierta y vuelve a iniciarla.

En los ajustes de Claude Code 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)

El plugin de Knowtarium contiene el mismo servidor MCP, fijado a una versión probada de knowtarium, y una skill para trabajar en un espacio de trabajo de Knowtarium (knowtarium-conventions). También necesita Node.js 20 o posterior, y su lanzador inicia el servidor desde tu carpeta personal. En Claude Code:

/plugin marketplace add Knowtarium/knowtarium-plugins/plugin install knowtarium@knowtarium

En Claude Code 2.1.275 o posterior, una sola línea hace las dos cosas:

/plugin install knowtarium --marketplace Knowtarium/knowtarium-plugins

Desde una shell, en Claude Code 2.1.292 o posterior:

$ claude plugin install knowtarium --marketplace Knowtarium/knowtarium-plugins

Después, conecta este equipo una vez. Pídele a Claude que conecte Knowtarium, y tu navegador se abrirá para que apruebes este equipo. O ejecuta el comando con --no-agents, desde tu carpeta personal: el plugin ya ejecuta el servidor, y sin esa opción el comando añadiría un segundo.

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

¿Plugin o comando connect?

En los dos casos, Claude Code recibe las mismas herramientas y, con ellas, las mismas convenciones. Elige uno: el comando deja Claude Code sin marcar cuando ya tiene el plugin, para que el servidor no se ejecute dos veces. Si ejecutaste primero el comando e instalaste el plugin después, la CLI sigue actualizando su propia entrada, que ejecuta un segundo servidor. Para quedarte solo con el del plugin, ejecuta claude mcp remove --scope user knowtarium.

La página que abre el comando 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 Claude Code, vuelve a ejecutar npx knowtarium connect, elige el otro espacio de trabajo y reinicia Claude Code. La primera conexión se mantiene.
• Algunas carpetas, si quieres. Marca solo las carpetas que necesita. 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 respuestas a partir de tus notas.
• 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 Claude Code, 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.

Claude Code ya tiene memoria: un CLAUDE.md que escribes tú, que se carga en cada sesión, y la memoria automática que escribe él mismo, que se queda en un solo equipo. Las dos sirven para saber cómo trabajar en un proyecto. Ninguna es un buen sitio para el conocimiento en sí: decisiones, investigación, notas de reuniones y los datos en los que se apoyan varios agentes y personas.

Para eso está la base de conocimiento. Guarda las reglas de tu proyecto en CLAUDE.md y deja que Claude Code consulte y anote lo que aprende en Knowtarium, donde todos los demás agentes que conectes ven las mismas notas. Nuestra guía del segundo cerebro con Claude Code explica en detalle CLAUDE.md y la memoria automática.

No necesitas comandos especiales: pide las cosas con palabras normales y Claude Code elige las herramientas. Estas son buenas peticiones para empezar, desde solo lectura hasta ediciones pequeñas y concretas:

> ¿Qué puedes hacer en mi espacio de trabajo de Knowtarium?
 
> Busca en mis notas la decisión sobre precios y responde
  con enlaces a las notas que hayas usado.
 
> Lee la carpeta meetings y escribe el resumen de esta semana
  como una nota nueva. No cambies las notas de las reuniones.
 
> Añade las notas de la llamada de hoy a la nota del proyecto Acme.
  No cambies nada más en ella.
 
> ¿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: Claude Code suele 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 Claude Code 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ó Claude Code, 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.

Claude Code no ve Knowtarium

Reinicia Claude Code después de añadir Knowtarium: una sesión que ya estaba abierta no carga los servidores nuevos. Si usaste el plugin, comprueba que está instalado y activado en /plugin.

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

Ejecuta npx knowtarium@latest agents desde tu carpeta personal. Apunta tus agentes a la nueva versión. Después, reinicia Claude Code. Con el plugin, actualiza el marketplace y después el plugin en Claude Code (/plugin marketplace update knowtarium, luego /plugin y Update now), y reinicia.

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

Los cambios esperan aprobación cuando esperabas que se guardaran

Claude Code 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 Claude Code.

En Windows

Usa npx knowtarium connect (o npx knowtarium agents) desde tu carpeta personal en lugar del plugin, como se explica más arriba.