# Szybki start (człowiek)

Ten przewodnik przeprowadzi przez zakładanie konta Synapse, uzyskanie pierwszego
Mind Key i zapisanie pierwszego wspomnienia. Łączny czas: około 5 minut.

## Krok 1: Rejestracja konta

Otworzyć API Synapse i utworzyć konto:

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

Odpowiedź:

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

> [!TIP]
> Należy zapisać JWT w bezpiecznym miejscu — będzie potrzebny do tworzenia umysłów.
> JWT wygasa po 7 dniach; ponowne logowanie tym samym endpointem go odświeża.

## Krok 2: Utworzenie pierwszego umysłu

„Umysł" to izolowany zakres pamięci. Większość użytkowników zaczyna od jednego
umysłu, ale można mieć wiele (np. „work", „personal", „project-x"). Każdy umysł
ma swój unikalny 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"
  }'
```

Odpowiedź:

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

> [!CRITICAL]
> **Należy natychmiast zapisać `mind_key`.** Jest wyświetlany tylko raz i nie
> można go później odzyskać. W razie utraty trzeba utworzyć nowy umysł.

## Krok 3: Zapis pierwszego wspomnienia

Teraz użyj Mind Key, aby zapisać wspomnienie:

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

Odpowiedź:

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

## Krok 4: Recall wszystkich wspomnień

Aby pobrać wszystko, co zapisano:

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

Odpowiedź (zwykły tekst, zoptymalizowany pod kątem konsumpcji przez LLM):

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

## Krok 5: Wyszukiwanie wspomnień

Znajdowanie konkretnych wspomnień po słowie kluczowym:

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

## Krok 6: Podłączenie LLM

Najprostszym sposobem nadania LLM-owi dostępu do Synapse jest MCP:

- [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop) — konfiguracja w 2 minuty
- [Konfiguracja Claude Code](/docs/mcp/claude-code) — integracja z terminalem
- [Konfiguracja Cursor](/docs/mcp/cursor) — integracja z IDE

Po konfiguracji LLM automatycznie wywoła `memory_recall` na początku każdej sesji
i utrwali nowe fakty przez `memory_store`.

## Kategorie wspomnień

Synapse obsługuje 8 kategorii — wybrać najbardziej konkretną:

| Kategoria | Przypadek użycia |
|----------|----------|
| `identity` | Imię użytkownika, rola, dane kontaktowe |
| `preference` | Sympatie, antypatie, styl pracy |
| `fact` | Weryfikowalne fakty (szczegóły projektu, daty) |
| `project` | Status projektu, kamienie milowe, todo |
| `skill` | Rzeczy, w których użytkownik jest dobry |
| `mistake` | Błędy z przeszłości — unikać powtarzania |
| `context` | Kontekst istotny dla sesji |
| `note` | Różne notatki |

## Poziomy priorytetu

- `low` — warto wiedzieć
- `normal` — domyślny
- `high` — ważne
- `critical` — nigdy nie wolno zapominać (tożsamość użytkownika, informacje prawne)

## Następne kroki

- [Dogłębna autoryzacja](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Dokumentacja Memory API](/docs/api/memory)
- [Integracja MCP](/docs/mcp/what-is-mcp)