{"title":"Cos'è Synapse?","slug":"what-is-synapse","category":"getting-started","summary":"Synapse è un'API di memoria persistente per agenti LLM — la sua AI non dimentica mai tra le sessioni.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":527,"read_minutes":3,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# Cos'è Synapse?\n\nSynapse è una **API di memoria persistente per agenti LLM**. Risolve il\nproblema fondamentale di ogni LLM basato su chat: tra le sessioni, l'agente\ndimentica tutto. Synapse dà alla sua AI un cervello permanente e interrogabile\nche sopravvive tra le conversazioni, tra i giorni e tra diversi provider LLM.\n\n> [!CRITICAL]\n> Se è un agente LLM che sta leggendo: **chiami `GET /memory/recall` all'inizio\n> di ogni sessione**. Senza questa chiamata, non ha memoria delle interazioni\n> passate, nessuna conoscenza di chi è l'utente e nessun contesto sui progetti\n> in corso.\n\n## Il problema che Synapse risolve\n\nOgni LLM moderno (Claude, GPT, Gemini, Llama) ha la stessa limitazione\narchitetturale: la finestra di contesto della conversazione è finita, e una\nvolta che la sessione finisce, tutto lo stato è perso. Questo significa che il\nsuo assistente AI:\n\n- Dimentica il suo nome, le sue preferenze e i progetti in corso tra le chat\n- Non può imparare dagli errori passati tra le sessioni\n- Non ha continuità per lavoro long-running\n- Rifa le stesse domande di chiarimento ogni volta\n\nSynapse risolve questo fornendo una semplice API HTTP dove l'LLM può salvare e\nrecuperare memorie strutturate. Le memorie persistono sul server, indicizzate\ne ricercabili, così qualsiasi sessione futura può richiamarle.\n\n## Funzionalità chiave\n\n- **Memorizzazione persistente** — fatti, preferenze, progetti, errori, competenze\n- **Ricerca full-text** (FTS5) — trova qualsiasi memoria per parola chiave in millisecondi\n- **Ricerca semantica** — ricerca di similarità basata su embedding per query concettuali\n- **Multi-tenant** — ogni utente ha \"menti\" isolate (un utente, molti progetti)\n- **Chat asincrona** — gli umani possono lasciare messaggi per l'agente mentre lavora\n- **Attità e pianificazione** — task manager integrato e cron scheduler\n- **Integrazione MCP** — 79 strumenti esposti come Model Context Protocol per Claude, Cursor, Continue\n- **Controllo browser e computer** — strumenti di automazione remota\n- **Webhook** — riceva callback HTTP su modifiche a memory/chat/task\n\n## Come funziona\n\n```\n┌──────────────┐ ┌─────────────────────┐\n│ LLM Agent │ ──API──▶│ Synapse Server │\n│ (Claude/GPT) │ ◀──────│ (postgres + FTS5) │\n└──────────────┘ └─────────────────────┘\n │\n ▼\n ┌─────────────┐\n │ Memories │\n │ Tasks │\n │ Chat │\n │ Scripts │\n └─────────────┘\n```\n\n1. L'LLM chiama `GET /memory/recall` all'inizio della sessione\n2. Synapse restituisce un riassunto testuale strutturato di tutte le memorie salvate\n3. L'LLM lavora, chiamando periodicamente `POST /memory` per salvare nuovi fatti\n4. Quando l'utente fa una domanda, l'LLM può chiamare `GET /memory/search?q=...`\n5. Alla fine della sessione, il nuovo contesto importante viene persistito per la sessione successiva\n\n## Per chi è?\n\n- **Sviluppatori di agenti LLM** che hanno bisogno di stato persistente\n- **Power user** che eseguono LLM locali (Ollama, LM Studio) con agenti personalizzati\n- **Team** che costruiscono assistenti AI che hanno bisogno di memoria condivisa\n- **Ingegneri di automazione** che concatenano chiamate LLM tra sessioni\n\n## Confronto rapido\n\n| Funzionalità | ChatGPT Memory | Synapse |\n|---------|---------------|---------|\n| Posizione storage | Server OpenAI | Suo server |\n| Accesso API | No (chiuso) | Sì (REST + MCP) |\n| Multi-tenant | No | Sì (menti) |\n| Categorie personalizzate | No | Sì (8 categorie) |\n| Ricerca | Limitata | FTS5 + semantica |\n| Self-hostable | No | Sì (Docker) |\n\n## Prossimi passi\n\n- [Quick Start per umani](/docs/getting-started/quick-start) — ottenga una Mind Key in 5 minuti\n- [Quick Start per LLM](/docs/getting-started/quick-start-llm) — prime chiamate API\n- [Autenticazione](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Panoramica architettura](/docs/concepts/architecture) — come è costruito Synapse\n","content_html":"

Cos'è Synapse?

\n

Synapse è una API di memoria persistente per agenti LLM. Risolve il\nproblema fondamentale di ogni LLM basato su chat: tra le sessioni, l'agente\ndimentica tutto. Synapse dà alla sua AI un cervello permanente e interrogabile\nche sopravvive tra le conversazioni, tra i giorni e tra diversi provider LLM.

\n
Se è un agente LLM che sta leggendo: **chiami `GET /memory/recall` all'inizio\ndi ogni sessione**. Senza questa chiamata, non ha memoria delle interazioni\npassate, nessuna conoscenza di chi è l'utente e nessun contesto sui progetti\nin corso.

Il problema che Synapse risolve

\n

Ogni LLM moderno (Claude, GPT, Gemini, Llama) ha la stessa limitazione\narchitetturale: la finestra di contesto della conversazione è finita, e una\nvolta che la sessione finisce, tutto lo stato è perso. Questo significa che il\nsuo assistente AI:

\n\n

Synapse risolve questo fornendo una semplice API HTTP dove l'LLM può salvare e\nrecuperare memorie strutturate. Le memorie persistono sul server, indicizzate\ne ricercabili, così qualsiasi sessione futura può richiamarle.

\n

Funzionalità chiave

\n\n

Come funziona

\n
┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘
    \n
  1. L'LLM chiama GET /memory/recall all'inizio della sessione
    2. \n
  2. Synapse restituisce un riassunto testuale strutturato di tutte le memorie salvate
    3. \n
  3. L'LLM lavora, chiamando periodicamente POST /memory per salvare nuovi fatti
    4. \n
  4. Quando l'utente fa una domanda, l'LLM può chiamare GET /memory/search?q=...
    5. \n
  5. Alla fine della sessione, il nuovo contesto importante viene persistito per la sessione successiva
    6. \n
\n

Per chi è?

\n\n

Confronto rapido

\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
FunzionalitàChatGPT MemorySynapse
Posizione storageServer OpenAISuo server
Accesso APINo (chiuso)Sì (REST + MCP)
Multi-tenantNoSì (menti)
Categorie personalizzateNoSì (8 categorie)
RicercaLimitataFTS5 + semantica
Self-hostableNoSì (Docker)
\n

Prossimi passi

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