Firmament Open Brain

Un «context brain» compartido para el equipo de Firmament, inspirado en OB1 pero reconstruido en versión ligera para Railway. Es un servidor MCP (Model Context Protocol) respaldado por Postgres: cada persona tiene un almacén de memoria privado que lo acompaña a través de las herramientas de IA (Claude Desktop, Claude Code, claude.ai, Cursor, etc.). Las memorias están aisladas por usuario: tu token solo ve tus propias memorias.

Cómo funciona

• Un servicio de Railway (esta aplicación de Node) + un Postgres de Railway.

• Cada usuario recibe un token personal. Su URL de MCP es https://<host>/mcp/<token>.

• Todas las lecturas/escrituras de memoria están limitadas al usuario al que resuelve ese token. Los tokens se almacenan con hash (SHA-256).

• La búsqueda usa texto completo de Postgres con un respaldo por subcadena: no se necesitan claves de API de embeddings.

Related MCP server: LedgerMem MCP Server

Herramientas MCP expuestas

Cómo conectar un cliente

Claude Code:

claude mcp add --transport http openbrain https://<host>/mcp/<your-token>

Claude Desktop / claude.ai: Configuración → Conectores → Añadir conector personalizado → pega https://<host>/mcp/<your-token>.

Cursor: Configuración → MCP → Añadir servidor, escribe http, misma URL.

Después solo habla: «recuerda que ...» / «¿qué sabes sobre ...?». Un buen hábito es empezar las sesiones con «revisa mi open brain para contexto sobre ».

Admin (creación de usuarios)

Requiere la variable de entorno ADMIN_TOKEN; pásala como token Bearer.

# create a user (returns their token + MCP URL — shown only once)
curl -X POST https://<host>/admin/users \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Jack Wright"}'

# list users
curl https://<host>/admin/users -H "Authorization: Bearer $ADMIN_TOKEN"

# delete a user (and all their memories)
curl -X DELETE https://<host>/admin/users/<id> -H "Authorization: Bearer $ADMIN_TOKEN"

Despliegue (Railway)

Variables de entorno en el servicio de la aplicación:

• DATABASE_URL — referencia al Postgres de Railway

• ADMIN_TOKEN — cadena aleatoria larga (autenticación de la API de administración)

• DATABASE_SSL — defínela como false si te conectas a través de la red privada de Railway

Despliega con railway up desde este directorio. El esquema se crea automáticamente al arrancar.

Notas de seguridad

• El token reside en la URL. Eso es lo que hace que la conexión sea tan fácil como pegar una sola vez, y es aceptable para un equipo pequeño de confianza, pero trata la URL como una contraseña: no la compartas, no la pegues en chats de grupo.

• Token perdido → elimina al usuario y genera uno nuevo (las memorias están vinculadas a la fila del usuario, por lo que eliminar al usuario elimina sus memorias — exporta primero si es necesario).