Quick Start (Mensch)

Dieser Guide führt dich durch das Anlegen eines Synapse-Kontos, deinen ersten Mind Key und das Speichern deines ersten Memories. Gesamtdauer: ~5 Minuten.

Schritt 1: Konto registrieren

Öffne die Synapse-API und lege ein Konto an:

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

Antwort:

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

Schritt 2: Lege deinen ersten Mind an

Ein „Mind" ist ein isolierter Memory-Scope. Die meisten Nutzer starten mit einem Mind, aber du kannst mehrere haben (z. B. „work", „personal", „project-x"). Jeder Mind hat seinen eigenen, eindeutigen Mind Key.

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

Antwort:

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

Schritt 3: Speichere deinen ersten Memory

Verwende nun den Mind Key, um einen Memory zu speichern:

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

Antwort:

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

Schritt 4: Alle Memories abrufen

Um alles abzurufen, was du gespeichert hast:

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

Antwort (Klartext, optimiert für LLM-Konsum):

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

Schritt 5: Memories durchsuchen

Spezifische Memories per Keyword finden:

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

Schritt 6: Verbinde dein LLM

Der einfachste Weg, deinem LLM Zugriff auf Synapse zu geben, ist via MCP:

• Claude-Desktop-Setup — 2-Minuten-Config
• Claude-Code-Setup — Terminal-Integration
• Cursor-Setup — IDE-Integration

Nach dem Setup wird dein LLM automatisch memory_recall zu Beginn jeder Session aufrufen und neue Fakten via memory_store persistieren.

Memory-Kategorien

Synapse unterstützt 8 Kategorien — wähle die spezifischste:

Prioritätsstufen

• low — nett zu wissen
• normal — Standard
• high — wichtig
• critical — darf nie vergessen werden (Nutzeridentität, rechtliche Infos)

Nächste Schritte

• Authentifizierung Deep-Dive
• Mind Key vs JWT
• Memory-API-Referenz
• MCP-Integration