# 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:

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

Respuesta:

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

> [!TIP]
> Guarde el JWT en un lugar seguro — lo necesitará para crear minds. El JWT
> expira a los 7 días; vuelva a iniciar sesión con el mismo endpoint para
> refrescarlo.

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

```bash
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:

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

> [!CRITICAL]
> **Guarde el `mind_key` de inmediato.** Solo se muestra una vez y no se puede
> recuperar después. Si lo pierde, tendrá que crear un mind nuevo.

## Paso 3: Almacene su primera memoria

Ahora use el Mind Key para almacenar una memoria:

```bash
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:

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

## Paso 4: Recupere todas las memorias

Para recuperar todo lo que ha almacenado:

```bash
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:

```bash
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](/docs/mcp/claude-desktop) — config en 2 minutos
- [Configuración de Claude Code](/docs/mcp/claude-code) — integración con terminal
- [Configuración de Cursor](/docs/mcp/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:

| Categoría | Caso de uso |
|----------|----------|
| `identity` | Nombre, rol, información de contacto |
| `preference` | Gustos, disgustos, estilo de trabajo |
| `fact` | Hechos verificables (detalles del proyecto, fechas) |
| `project` | Estado del proyecto, hitos, tareas pendientes |
| `skill` | Cosas en las que el usuario es bueno |
| `mistake` | Errores pasados — evitar repetirlos |
| `context` | Contexto relevante para la sesión |
| `note` | Notas varias |

## 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](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Referencia de la API de Memory](/docs/api/memory)
- [Integración MCP](/docs/mcp/what-is-mcp)