Quick Start (humano)

Esta guía le lleva por obtener una cuenta de Synapse, su primer Mind Key, y almacenar su primera memoria. Tiempo total: ~5 minutos.

Paso 1: Registrar una cuenta

Abra la API de Synapse y cree una cuenta:

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

Respuesta:

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}

Paso 2: Cree su primer mind

Un "mind" es un ámbito de memoria aislado. La mayoría de los usuarios empieza con un mind, pero puede tener múltiples (p. ej. "trabajo", "personal", "proyecto-x"). Cada mind tiene su propio Mind Key único.

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'

Respuesta:

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}

Paso 3: Almacene su primera memoria

Ahora use el Mind Key para almacenar una memoria:

curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'

Respuesta:

{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}

Paso 4: Recupere todas las memorias

Para recuperar todo lo que ha almacenado:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall

Respuesta (texto plano, optimizado para consumo por LLM):

Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27

Paso 5: Busque memorias

Encuentre memorias específicas por palabra clave:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/memory/search?q=michael"

Paso 6: Conecte su LLM

La forma más sencilla de dar a su LLM acceso a Synapse es vía MCP:

• Configuración de Claude Desktop — config en 2 minutos
• Configuración de Claude Code — integración con terminal
• Configuración de Cursor — integración con IDE

Tras la configuración, su LLM llamará automáticamente a memory_recall al inicio de cada sesión y persistirá nuevos hechos vía memory_store.

Categorías de memoria

Synapse admite 8 categorías — elija la más específica:

Niveles de prioridad

• low — bueno saberlo
• normal — predeterminado
• high — importante
• critical — nunca olvidar (identidad del usuario, información legal)

Próximos pasos

• Profundización en autenticación
• Mind Key vs JWT
• Referencia de la API de Memory
• Integración MCP