# Quick Start (umano)

Questa guida la accompagna nell'ottenere un account Synapse, la sua prima Mind
Key e nel memorizzare la sua prima memoria. Tempo totale: ~5 minuti.

## Passo 1: Registri un account

Apra l'API di Synapse e crei un account:

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

Risposta:

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

> [!TIP]
> Salvi il JWT in un posto sicuro — le servirà per creare le menti. Il JWT
> scade dopo 7 giorni; rifaccia login con lo stesso endpoint per rinfrescarlo.

## Passo 2: Crei la sua prima mente

Una "mente" è uno scope di memoria isolato. La maggior parte degli utenti
inizia con una mente, ma può averne multiple (es. "work", "personal",
"project-x"). Ogni mente ha la sua Mind Key univoca.

```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"
  }'
```

Risposta:

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

> [!CRITICAL]
> **Salvi la `mind_key` immediatamente.** Viene mostrata una sola volta e non
> può essere recuperata in seguito. Se la perde, dovrà creare una nuova mente.

## Passo 3: Memorizzi la sua prima memoria

Ora usi la Mind Key per memorizzare 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"
  }'
```

Risposta:

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

## Passo 4: Richiami tutte le memorie

Per recuperare tutto ciò che ha memorizzato:

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

Risposta (testo semplice, ottimizzato per consumo 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
```

## Passo 5: Cerchi nelle memorie

Trovi memorie specifiche per parola chiave:

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

## Passo 6: Connetta il suo LLM

Il modo più semplice per dare al suo LLM accesso a Synapse è tramite MCP:

- [Configurazione Claude Desktop](/docs/mcp/claude-desktop) — config in 2 minuti
- [Configurazione Claude Code](/docs/mcp/claude-code) — integrazione terminale
- [Configurazione Cursor](/docs/mcp/cursor) — integrazione IDE

Dopo la configurazione, il suo LLM chiamerà automaticamente `memory_recall`
all'inizio di ogni sessione e persisterà nuovi fatti tramite `memory_store`.

## Categorie di memoria

Synapse supporta 8 categorie — scelga la più specifica:

| Categoria | Caso d'uso |
|----------|----------|
| `identity` | Nome utente, ruolo, informazioni di contatto |
| `preference` | Piaceri, dispiaceri, stile di lavoro |
| `fact` | Fatti verificabili (dettagli di progetto, date) |
| `project` | Stato del progetto, milestone, todo |
| `skill` | Cose in cui l'utente è bravo |
| `mistake` | Errori passati — da evitare di ripetere |
| `context` | Contesto rilevante per la sessione |
| `note` | Note varie |

## Livelli di priorità

- `low` — piace da sapere
- `normal` — predefinita
- `high` — importante
- `critical` — da non dimenticare mai (identità utente, info legali)

## Prossimi passi

- [Approfondimento autenticazione](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Riferimento Memory API](/docs/api/memory)
- [Integrazione MCP](/docs/mcp/what-is-mcp)