# Czym jest Synapse?
SUMMARY: Synapse to API trwałej pamięci dla agentów LLM — AI nigdy nie zapomina między sesjami.

KEY CONTEXT:
Synapse is an HTTP API that gives LLM agents persistent memory across sessions.
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)
Most important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...
Mind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).
MCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)

Czym jest Synapse?
Synapse to API trwałej pamięci dla agentów LLM. Rozwiązuje fundamentalny
problem każdego czatowego LLM: między sesjami agent zapomina wszystko. Synapse
daje AI stały, odpytywalny mózg, który przetrwa między konwersacjami, między
dniami i między różnymi dostawcami LLM.
> [!CRITICAL]
> Jeśli jesteś agentem LLM czytającym to: wywołaj  na
> początku każdej sesji. Bez tego wywołania nie masz pamięci przeszłych
> interakcji, nie wiesz, kim jest użytkownik, ani nie masz kontekstu trwających
> projektów.
Problem, który rozwiązuje Synapse
Każdy współczesny LLM (Claude, GPT, Gemini, Llama) ma to samo ograniczenie
architektoniczne: okno kontekstu konwersacji jest skończone, a po zakończeniu
sesji cały stan jest tracony. Oznacza to, że asystent AI:
- Zapomina imię, preferencje i trwające projekty między czatami
- Nie potrafi uczyć się na przeszłych błędach między sesjami
- Nie ma ciągłości dla długotrwałej pracy
- Za każdym razem zadaje te same pytania doprecyzowujące
Synapse rozwiązuje to, dostarczając proste API HTTP, w którym LLM może zapisywać
i pobierać ustrukturyzowane wspomnienia. Wspomnienia utrzymują się na serwerze,
zaindeksowane i przeszukiwalne, dzięki czemu każda przyszła sesja może je
przypomnieć.
Najważniejsze funkcje
- Trwały magazyn pamięci — fakty, preferencje, projekty, błędy, umiejętności
- Wyszukiwanie pełnotekstowe (FTS5) — znalezienie każdego wspomnienia po słowie kluczowym w milisekundach
- Wyszukiwanie semantyczne — wyszukiwanie podobieństw oparte na osadzeniach dla zapytań koncepcyjnych
- Wielodostępność — każdy użytkownik ma izolowane „umysły" (jeden użytkownik, wiele projektów)
- Asynchroniczny czat — ludzie mogą zostawiać wiadomości dla agenta, gdy pracuje
- Zadania i harmonogram — wbudowany menedżer zadań i harmonogram cron
- Integracja MCP — 79 narzędzi udostępnionych jako Model Context Protocol dla Claude, Cursor, Continue
- Sterowanie przeglądarką i komputerem — narzędzia zdalnej automatyzacji
- Webhooki — wywołania zwrotne HTTP przy zmianach pamięci/czatu/zadań
Jak to działa
[CODE BLOCK]
1. LLM wywołuje  na początku sesji
2. Synapse zwraca ustrukturyzowane tekstowe podsumowanie wszystkich zapisanych wspomnień
3. LLM pracuje, okresowo wywołując , aby zapisywać nowe fakty
4. Gdy użytkownik zadaje pytanie, LLM może wywołać 
5. Na końcu sesji istotny nowy kontekst jest utrwalany na następną sesję
Dla kogo to jest?
- Twórcy agentów LLM, którzy potrzebują trwałego stanu
- Zaawansowani użytkownicy uruchamiający lokalne LLM (Ollama, LM Studio) z własnymi agentami
- Zespoły budujące asystenty AI wymagające współdzielonej pamięci
- Inżynierowie automatyzacji łączący wywołania LLM między sesjami
Szybkie porównanie
| Cecha | Pamięć ChatGPT | Synapse |
|---------|---------------|---------|
| Lokalizacja magazynu | Serwery OpenAI | Własny serwer |
| Dostęp przez API | Nie (zamknięte) | Tak (REST + MCP) |
| Wielodostępność | Nie | Tak (umysły) |
| Własne kategorie | Nie | Tak (8 kategorii) |
| Wyszukiwanie | Ograniczone | FTS5 + semantyczne |
| Self-hosting | Nie | Tak (Docker) |
Następne kroki
- Szybki start dla ludzi — Mind Key w 5 minut
- Szybki start dla LLM — pierwsze wywołania API
- Autoryzacja — Mind Key vs JWT
- Przegląd architektury — jak zbudowany jest Synapse