{"title":"Szybki start (człowiek)","slug":"quick-start","category":"getting-started","summary":"Zarejestruj konto, utwórz pierwszy umysł, zapisz wspomnienie — wszystko w 5 minut.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":348,"read_minutes":2,"lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Szybki start (człowiek)\n\nTen przewodnik przeprowadzi przez zakładanie konta Synapse, uzyskanie pierwszego\nMind Key i zapisanie pierwszego wspomnienia. Łączny czas: około 5 minut.\n\n## Krok 1: Rejestracja konta\n\nOtworzyć API Synapse i utworzyć konto:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nOdpowiedź:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> Należy zapisać JWT w bezpiecznym miejscu — będzie potrzebny do tworzenia umysłów.\n> JWT wygasa po 7 dniach; ponowne logowanie tym samym endpointem go odświeża.\n\n## Krok 2: Utworzenie pierwszego umysłu\n\n„Umysł\" to izolowany zakres pamięci. Większość użytkowników zaczyna od jednego\numysłu, ale można mieć wiele (np. „work\", „personal\", „project-x\"). Każdy umysł\nma swój unikalny Mind Key.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nOdpowiedź:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **Należy natychmiast zapisać `mind_key`.** Jest wyświetlany tylko raz i nie\n> można go później odzyskać. W razie utraty trzeba utworzyć nowy umysł.\n\n## Krok 3: Zapis pierwszego wspomnienia\n\nTeraz użyj Mind Key, aby zapisać wspomnienie:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nOdpowiedź:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Krok 4: Recall wszystkich wspomnień\n\nAby pobrać wszystko, co zapisano:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nOdpowiedź (zwykły tekst, zoptymalizowany pod kątem konsumpcji przez LLM):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## Krok 5: Wyszukiwanie wspomnień\n\nZnajdowanie konkretnych wspomnień po słowie kluczowym:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Krok 6: Podłączenie LLM\n\nNajprostszym sposobem nadania LLM-owi dostępu do Synapse jest MCP:\n\n- [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop) — konfiguracja w 2 minuty\n- [Konfiguracja Claude Code](/docs/mcp/claude-code) — integracja z terminalem\n- [Konfiguracja Cursor](/docs/mcp/cursor) — integracja z IDE\n\nPo konfiguracji LLM automatycznie wywoła `memory_recall` na początku każdej sesji\ni utrwali nowe fakty przez `memory_store`.\n\n## Kategorie wspomnień\n\nSynapse obsługuje 8 kategorii — wybrać najbardziej konkretną:\n\n| Kategoria | Przypadek użycia |\n|----------|----------|\n| `identity` | Imię użytkownika, rola, dane kontaktowe |\n| `preference` | Sympatie, antypatie, styl pracy |\n| `fact` | Weryfikowalne fakty (szczegóły projektu, daty) |\n| `project` | Status projektu, kamienie milowe, todo |\n| `skill` | Rzeczy, w których użytkownik jest dobry |\n| `mistake` | Błędy z przeszłości — unikać powtarzania |\n| `context` | Kontekst istotny dla sesji |\n| `note` | Różne notatki |\n\n## Poziomy priorytetu\n\n- `low` — warto wiedzieć\n- `normal` — domyślny\n- `high` — ważne\n- `critical` — nigdy nie wolno zapominać (tożsamość użytkownika, informacje prawne)\n\n## Następne kroki\n\n- [Dogłębna autoryzacja](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Dokumentacja Memory API](/docs/api/memory)\n- [Integracja MCP](/docs/mcp/what-is-mcp)\n","content_html":"

Szybki start (człowiek)

\n

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

\n

Krok 1: Rejestracja konta

\n

Otworzyć API Synapse i utworzyć konto:

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

Odpowiedź:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
Należy zapisać JWT w bezpiecznym miejscu — będzie potrzebny do tworzenia umysłów.\nJWT wygasa po 7 dniach; ponowne logowanie tym samym endpointem go odświeża.

Krok 2: Utworzenie pierwszego umysłu

\n

„Umysł" to izolowany zakres pamięci. Większość użytkowników zaczyna od jednego\numysłu, ale można mieć wiele (np. „work", „personal", „project-x"). Każdy umysł\nma swój unikalny Mind Key.

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "My First Mind",\n    "description": "Personal assistant memory"\n  }'

Odpowiedź:

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**Należy natychmiast zapisać `mind_key`.** Jest wyświetlany tylko raz i nie\nmożna go później odzyskać. W razie utraty trzeba utworzyć nowy umysł.

Krok 3: Zapis pierwszego wspomnienia

\n

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

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "identity",\n    "key": "user_name",\n    "content": "My name is Michael",\n    "tags": ["personal", "identity"],\n    "priority": "critical"\n  }'

Odpowiedź:

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

Krok 4: Recall wszystkich wspomnień

\n

Aby pobrać wszystko, co zapisano:

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

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

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

Krok 5: Wyszukiwanie wspomnień

\n

Znajdowanie konkretnych wspomnień po słowie kluczowym:

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

Krok 6: Podłączenie LLM

\n

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

\n\n

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

\n

Kategorie wspomnień

\n

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

\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\n
KategoriaPrzypadek użycia
identityImię użytkownika, rola, dane kontaktowe
preferenceSympatie, antypatie, styl pracy
factWeryfikowalne fakty (szczegóły projektu, daty)
projectStatus projektu, kamienie milowe, todo
skillRzeczy, w których użytkownik jest dobry
mistakeBłędy z przeszłości — unikać powtarzania
contextKontekst istotny dla sesji
noteRóżne notatki
\n

Poziomy priorytetu

\n\n

Następne kroki

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