Manual del archivo

Guía de uso

Cómo guardar, consultar e ingerir información en tu second brain. Todo lo de esta página está verificado contra el servidor real.

Conectar tu Claude

Se hace una sola vez. Después tu memoria está disponible en cualquier conversación, en web, escritorio y teléfono.

Abre claude.ai (o Claude Desktop) y ve a Ajustes → Conectores.
Elige Agregar conector personalizado.
Pega esta dirección:
```
https://mybrain.rlz.cl/mcp
```
Se abrirá una ventana para iniciar sesión: con tu correo y contraseña, o con Continuar con Google.
Verás una pantalla de autorización que indica qué permiso estás dando (leer y escribir toda tu memoria). Pulsa Autorizar. Solo se pregunta la primera vez para cada conector.
Listo. Compruébalo escribiéndole a Claude: «¿qué tienes guardado sobre mí?»

¿Usas Claude Code en la terminal?

Instala el plugin y te deja todo listo de una vez: el conector configurado y los comandos /absorber, /guardar y /consultar disponibles desde cualquier carpeta.

/plugin marketplace add jpreyestCL/secondbrain
/plugin install secondbrain

El plugin te deja hablar con tu memoria y guardar documentos sueltos. Para meter carpetas enteras hace falta además el comando brain, que es el que lee los archivos de tu disco (el servidor no puede: por eso nada se sube). Son dos líneas más, una sola vez:

curl -fsSL https://mybrain.rlz.cl/install.sh | sh
brain login https://mybrain.rlz.cl

El login abre el navegador una vez y deja este equipo vinculado a tu cuenta. No pide ninguna clave de API: la extracción ocurre aquí o en el servidor, nunca con claves tuyas en el medio.

Ya está. Ahora puedes pedirle a Claude: «absorbe los documentos de ~/mis-escrituras» y él prepara los archivos y va guardando los hechos de cada documento. Los detalles del comando están en Ingesta masiva.

Si algo falla

Lo que ves	Qué significa y qué hacer
`invalid_client`	El conector guarda un identificador que ya no existe en el servidor (por ejemplo, si se limpiaron los accesos). Elimina el conector en claude.ai y vuelve a agregarlo: se registra de nuevo solo.
`account_not_linked`	Intentaste entrar con Google usando un correo que ya tenía cuenta con contraseña, y ese correo aún no está verificado. Revisa tu bandeja y confirma el correo; si no te llegó, reenvíalo desde tu cuenta.
Te devuelve al login una y otra vez	La sesión caducó (duran 2 días). Vuelve a iniciar sesión; el conector sigue registrado.
`403` al usar una herramienta	Tu cuenta existe pero no tiene memoria asignada. Escríbele al administrador: hay que aprovisionar tu espacio.

Para revocar el acceso de un conector en cualquier momento, entra a tu cuenta y pulsa Revocar junto a la aplicación.

Conversar con el cerebro

Es el camino de todos los días y no necesita terminal: basta con tener el conector MCP agregado en Claude.

Guardar un dato

Díselo en lenguaje natural. Claude decide el ámbito y llama a la herramienta por ti.

Guarda que mi cuenta del Banco X es Y

Menciona las relaciones explícitamente: “la cuenta del Banco X es mía”, “el contrato es con tal empresa”. El grafo extrae lo que dices, no lo que se sobreentiende.
Menciona la fecha real del hecho, no la de hoy: “desde marzo de 2024”. Esa fecha viaja en reference_time y es la que define desde cuándo el hecho está vigente.

Ingerir un documento

Adjunta el archivo en el chat y pide que lo ingiera. Claude lo lee —incluso PDFs escaneados o imágenes, usando visión—, lo trocea y lo guarda por secciones.

Ingiere este contrato a mi second brain (adjunto)

Consultar

Por defecto te responde con el estado actual. Si quieres la historia, pídela: el hecho anterior no se borró, quedó cerrado con su periodo de vigencia.

¿Cuál es mi cuenta bancaria?

Dame el historial completo de mis cuentas bancarias

Nunca pegues contraseñas ni tokens en el chat. El servidor los redacta igual antes de escribir nada, pero lo mejor es que no salgan de tu gestor de claves.

Las 9 herramientas MCP

No necesitas llamarlas a mano: Claude las usa por ti. Están aquí para que sepas exactamente qué puede hacer el conector con tu memoria.

Herramienta	Qué hace	Parámetros
`add_memory`	Guarda un dato o un trozo de documento en tu memoria.	`name, episode_body, source, source_description, group_id, uuid, reference_time`
`search_memory_facts`	Busca datos: qué se relaciona con qué, y desde cuándo.	`query, group_ids, max_facts, center_node_uuid, only_current`
`search_nodes`	Busca personas, empresas, cuentas, lugares y documentos.	`query, max_nodes, entity_types`
`get_episodes`	Lista lo último guardado, con su texto original.	`max_episodes, group_ids`
`get_entity_edge`	Devuelve un dato concreto por su identificador, con su vigencia.	`uuid`
`delete_entity_edge`	Borra un dato concreto (por ejemplo, uno mal entendido).	`uuid`
`delete_episode`	Borra un documento guardado y todo lo que se dedujo de él.	`uuid`
`clear_graph`	Borra TODA tu memoria. No hay deshacer.	`group_ids`
`get_status`	Comprueba que el servidor y la base de datos responden.	`—`

reference_time es ISO-8601 y es la fecha real del hecho. El servidor valida que caiga entre 1900 y como máximo un año en el futuro.
only_current viene en true por defecto: devuelve solo los datos vigentes. Ponlo en false para incluir los que ya cambiaron y ver la historia completa.
clear_graph es destructivo y no tiene deshacer. Exporta antes desde /export si tienes cualquier duda.

Aislamiento: el servidor fuerza el group_id de tu usuario en cada llamada y comprueba la pertenencia de cada UUID antes de tocarlo. No es posible leer ni modificar el grafo de otra persona, ni siquiera pasando un group_id ajeno a mano.

Ingesta masiva de una carpeta (CLI `brain`)

Para cuando tienes cientos de documentos en el disco y adjuntarlos de a uno en el chat no tiene sentido. Requiere terminal.

Instalar

Un comando. Instala lo que falte y deja brain disponible desde cualquier carpeta.

curl -fsSL https://mybrain.rlz.cl/install.sh | sh

Vincular con tu cuenta

Se abre el navegador una vez para autenticarte.

brain login https://mybrain.rlz.cl

No necesitas ninguna clave de API. La extracción de entidades la hace el servidor con sus modelos; en tu equipo solo corren la lectura de archivos, el OCR y el troceado, que no usan modelos de lenguaje.

El pipeline

Sustituye <slug> por el nombre de tu espacio. Inicia sesión y los ejemplos saldrán ya rellenados.

Los pasos van en orden y cada uno deja su resultado en el ledger, así que puedes cortar y retomar donde ibas.

brain add ~/Documentos/inbox

Comandos

Comando	Qué hace
`add <carpeta>`	Todo el proceso en un comando. Con --review se detiene antes de enviar.
`login <url>`	Vincula este equipo con tu cuenta del servidor. Se hace una vez.
`status`	Muestra en qué etapa va cada documento.
`scan <carpeta>`	Solo registra los archivos en el ledger.
`extract`	Solo saca el texto (OCR incluido si hace falta).
`classify --auto`	Solo asigna dominio, tipo y fecha real. Sin LLM.
`classify --apply <archivo>`	Aplica un manifiesto que revisaste a mano.
`chunk`	Solo trocea en secciones del tamaño que el grafo digiere.
`ingest-graph`	Solo envía al grafo (flags --doc-id y --force).
`expire`	Marca documentos como caducados (--all para todos).

Flag global: --tenant <slug> elige sobre qué espacio trabajar.

Ledger reanudable en ~/.brain/<tenant>/: si algo falla, vuelves a lanzar el comando y sigue desde donde quedó.
OCR de imágenes y de PDFs escaneados en el paso extract.
Redacción de credenciales: claves, tokens y números de tarjeta se reemplazan antes de escribir nada en el grafo.
Tus originales no se tocan: el pipeline solo lee de la carpeta.

Ingerir contra este servidor (sin SSH)

Es la forma recomendada y la única disponible si no administras el servidor. El último paso viaja por el mismo conector MCP que usa Claude: te autenticas con tu cuenta y el servidor hace la extracción con sus propios modelos.

brain --tenant <slug> ingest-graph --via mcp --url https://mybrain.rlz.cl/mcp

La primera vez se abre el navegador para autorizar; el token queda guardado en ~/.brain/<tenant>/. Los pasos anteriores son locales.

Sin terminal: adjunta los documentos en Claude y pídele que los guarde. No requiere instalar nada.

Exportar y cerrar accesos

Tu memoria es tuya y sale entera cuando quieras: un JSON con los episodios (texto original), las entidades y los hechos con su vigencia.

Descargar mi memoria (JSON)

En tu cuenta puedes revisar las sesiones abiertas, cerrarlas todas de golpe y revocar cualquier aplicación OAuth que hayas autorizado.