Conecta Codex 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. Codex, de OpenAI, 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, Codex 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 Codex 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 Codex 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 Codex 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 Codex 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? Codex
added to Codex (/Users/you/.codex/config.toml)
  previous file saved as /Users/you/.codex/config.toml.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). Encuentra Codex por su carpeta ~/.codex.
3. Codex recibe su entrada. La CLI añade Knowtarium a la configuración de usuario de Codex, ~/.codex/config.toml (en $CODEX_HOME si lo has definido), así que está disponible en todos los proyectos. Primero analiza el archivo y solo cambia la tabla propia de Knowtarium, sin tocar tus otros servidores, ajustes y comentarios, 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 Codex tiene abierto.
4. Reinicia Codex para que cargue el servidor nuevo: cierra cualquier sesión que ya estuviera abierta y vuelve a iniciar Codex.

En la configuración de Codex 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 una terminal:

$ codex plugin marketplace add Knowtarium/knowtarium-plugins$ codex plugin add knowtarium@knowtarium

O, una vez añadido el marketplace, escribe /plugins en Codex para abrir el explorador de plugins e instala Knowtarium desde el marketplace knowtarium. No está en el directorio público de plugins de OpenAI, así que añade primero el marketplace.

Después, conecta este equipo una vez. Pídele a Codex 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, así que esa opción deja intacta la configuración de Codex.

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

¿Plugin o comando connect?

En los dos casos, Codex recibe las mismas herramientas y, con ellas, las mismas convenciones. Elige uno: el comando deja Codex sin marcar cuando ya tiene el plugin, para que su propia entrada no sustituya al servidor del plugin.

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 Codex, vuelve a ejecutar npx knowtarium connect, elige el otro espacio de trabajo y reinicia Codex. 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 Codex, 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.

Codex toma sus instrucciones permanentes de archivos AGENTS.md: uno en ~/.codex para todos los proyectos, y los de las carpetas entre la raíz de git y el lugar donde lo inicias (documentación de Codex). Sirven para saber cómo trabajar en un repositorio. No son 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 tus reglas de programación en el AGENTS.md de Codex y deja que Codex consulte y anote lo que aprende en Knowtarium, donde todos los demás agentes que conectes ven las mismas notas, y tú puedes leerlas y editarlas en la app. Nuestra guía del segundo cerebro con Claude Code compara cómo leen Codex, Cursor y Claude Code sus archivos de instrucciones.

No necesitas comandos especiales: pide las cosas con palabras normales y Codex 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: Codex 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 Codex 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ó Codex, 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.

Codex no ve Knowtarium

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

Codex no aparece en la lista de agentes

La CLI encuentra Codex por su carpeta ~/.codex (o $CODEX_HOME). Si Codex guarda su configuración en otro sitio, define CODEX_HOME en esa terminal. Para añadir Knowtarium a Codex en cualquier caso, ejecuta npx knowtarium agents --agent codex desde tu carpeta personal (no si usas el plugin).

Codex se ha omitido

La CLI no escribe nada cuando config.toml no es TOML válido, o cuando sus servidores MCP están escritos de una forma que no puede editar con seguridad, y te dice cuál de los dos casos es. 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 apártalo) y vuelve a ejecutar npx knowtarium agents --agent codex.

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 Codex.

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

Con el plugin, actualiza el marketplace (eso solo refresca el listado), vuelve a añadir el plugin, lo que instala la nueva versión, y reinicia Codex:

$ codex plugin marketplace upgrade knowtarium$ codex plugin add knowtarium@knowtarium

Tienes a la vez el plugin y la entrada del comando

En ese caso, la entrada de config.toml se ejecuta en lugar del servidor del plugin. La CLI la mantiene actualizada y te lo indica. Para usar el servidor del plugin, quita la tabla [mcp_servers.knowtarium] de ~/.codex/config.toml (o de la que está en $CODEX_HOME) y reinicia Codex.

Los cambios esperan aprobación cuando esperabas que se guardaran

Codex 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 Codex.