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:

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

Risposta:

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

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.

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:

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

Passo 3: Memorizzi la sua prima memoria

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

Risposta:

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

Passo 4: Richiami tutte le memorie

Per recuperare tutto ciò che ha memorizzato:

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:

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 — config in 2 minuti
• Configurazione Claude Code — integrazione terminale
• Configurazione 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:

Livelli di priorità

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

Prossimi passi

• Approfondimento autenticazione
• Mind Key vs JWT
• Riferimento Memory API
• Integrazione MCP