# 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:

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

Antwort:

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

> [!TIP]
> Speichere das JWT an einem sicheren Ort — du brauchst es, um Minds anzulegen.
> Das JWT läuft nach 7 Tagen ab; mit demselben Endpunkt erneut einloggen, um es
> zu erneuern.

## 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.

```bash
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:

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

> [!CRITICAL]
> **Speichere den `mind_key` sofort.** Er wird nur einmal angezeigt und kann
> später nicht wiederhergestellt werden. Wenn du ihn verlierst, musst du einen
> neuen Mind anlegen.

## Schritt 3: Speichere deinen ersten Memory

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

```bash
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:

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

## Schritt 4: Alle Memories abrufen

Um alles abzurufen, was du gespeichert hast:

```bash
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:

```bash
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](/docs/mcp/claude-desktop) — 2-Minuten-Config
- [Claude-Code-Setup](/docs/mcp/claude-code) — Terminal-Integration
- [Cursor-Setup](/docs/mcp/cursor) — 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:

| Kategorie | Anwendungsfall |
|-----------|----------------|
| `identity` | Nutzername, Rolle, Kontaktinfo |
| `preference` | Vorlieben, Abneigungen, Arbeitsstil |
| `fact` | Überprüfbare Fakten (Projekt-Details, Daten) |
| `project` | Projektstatus, Meilensteine, Todos |
| `skill` | Dinge, die der Nutzer gut kann |
| `mistake` | Frühere Fehler — nicht wiederholen |
| `context` | Session-relevanter Kontext |
| `note` | Sonstige Notizen |

## 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](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Memory-API-Referenz](/docs/api/memory)
- [MCP-Integration](/docs/mcp/what-is-mcp)