{"title":"Quick Start (umano)","slug":"quick-start","category":"getting-started","summary":"Registri un account, crei la sua prima mente, memorizzi una memoria — tutto in 5 minuti.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":394,"read_minutes":2,"lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# Quick Start (umano)\n\nQuesta guida la accompagna nell'ottenere un account Synapse, la sua prima Mind\nKey e nel memorizzare la sua prima memoria. Tempo totale: ~5 minuti.\n\n## Passo 1: Registri un account\n\nApra l'API di Synapse e crei un account:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nRisposta:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> Salvi il JWT in un posto sicuro — le servirà per creare le menti. Il JWT\n> scade dopo 7 giorni; rifaccia login con lo stesso endpoint per rinfrescarlo.\n\n## Passo 2: Crei la sua prima mente\n\nUna \"mente\" è uno scope di memoria isolato. La maggior parte degli utenti\ninizia con una mente, ma può averne multiple (es. \"work\", \"personal\",\n\"project-x\"). Ogni mente ha la sua Mind Key univoca.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nRisposta:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **Salvi la `mind_key` immediatamente.** Viene mostrata una sola volta e non\n> può essere recuperata in seguito. Se la perde, dovrà creare una nuova mente.\n\n## Passo 3: Memorizzi la sua prima memoria\n\nOra usi la Mind Key per memorizzare una memoria:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nRisposta:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Passo 4: Richiami tutte le memorie\n\nPer recuperare tutto ciò che ha memorizzato:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nRisposta (testo semplice, ottimizzato per consumo LLM):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## Passo 5: Cerchi nelle memorie\n\nTrovi memorie specifiche per parola chiave:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Passo 6: Connetta il suo LLM\n\nIl modo più semplice per dare al suo LLM accesso a Synapse è tramite MCP:\n\n- [Configurazione Claude Desktop](/docs/mcp/claude-desktop) — config in 2 minuti\n- [Configurazione Claude Code](/docs/mcp/claude-code) — integrazione terminale\n- [Configurazione Cursor](/docs/mcp/cursor) — integrazione IDE\n\nDopo la configurazione, il suo LLM chiamerà automaticamente `memory_recall`\nall'inizio di ogni sessione e persisterà nuovi fatti tramite `memory_store`.\n\n## Categorie di memoria\n\nSynapse supporta 8 categorie — scelga la più specifica:\n\n| Categoria | Caso d'uso |\n|----------|----------|\n| `identity` | Nome utente, ruolo, informazioni di contatto |\n| `preference` | Piaceri, dispiaceri, stile di lavoro |\n| `fact` | Fatti verificabili (dettagli di progetto, date) |\n| `project` | Stato del progetto, milestone, todo |\n| `skill` | Cose in cui l'utente è bravo |\n| `mistake` | Errori passati — da evitare di ripetere |\n| `context` | Contesto rilevante per la sessione |\n| `note` | Note varie |\n\n## Livelli di priorità\n\n- `low` — piace da sapere\n- `normal` — predefinita\n- `high` — importante\n- `critical` — da non dimenticare mai (identità utente, info legali)\n\n## Prossimi passi\n\n- [Approfondimento autenticazione](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Riferimento Memory API](/docs/api/memory)\n- [Integrazione MCP](/docs/mcp/what-is-mcp)\n","content_html":"

Quick Start (umano)

\n

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

\n

Passo 1: Registri un account

\n

Apra l'API di Synapse e crei un account:

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

Risposta:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
Salvi il JWT in un posto sicuro — le servirà per creare le menti. Il JWT\nscade dopo 7 giorni; rifaccia login con lo stesso endpoint per rinfrescarlo.

Passo 2: Crei la sua prima mente

\n

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

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

Risposta:

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**Salvi la `mind_key` immediatamente.** Viene mostrata una sola volta e non\npuò essere recuperata in seguito. Se la perde, dovrà creare una nuova mente.

Passo 3: Memorizzi la sua prima memoria

\n

Ora usi la Mind Key per memorizzare una memoria:

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

Risposta:

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

Passo 4: Richiami tutte le memorie

\n

Per recuperare tutto ciò che ha memorizzato:

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

Risposta (testo semplice, ottimizzato per consumo LLM):

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

Passo 5: Cerchi nelle memorie

\n

Trovi memorie specifiche per parola chiave:

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

Passo 6: Connetta il suo LLM

\n

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

\n\n

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

\n

Categorie di memoria

\n

Synapse supporta 8 categorie — scelga la più specifica:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategoriaCaso d'uso
identityNome utente, ruolo, informazioni di contatto
preferencePiaceri, dispiaceri, stile di lavoro
factFatti verificabili (dettagli di progetto, date)
projectStato del progetto, milestone, todo
skillCose in cui l'utente è bravo
mistakeErrori passati — da evitare di ripetere
contextContesto rilevante per la sessione
noteNote varie
\n

Livelli di priorità

\n\n

Prossimi passi

\n\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}