# FAQ — rozwiązywanie problemów
SUMMARY: Rozwiązania częstych problemów Synapse — autoryzacja, sieć, dane, wdrożenie.

FAQ — rozwiązywanie problemów
Rozwiązania częstych problemów Synapse.
Nie mogę się zalogować
Symptomy
-  zwraca 401
- „Invalid email or password"
Rozwiązania
1. Zweryfikować poprawność e-maila — wielkość liter ma znaczenie
2. Sprawdzić hasło — minimum 6 znaków
3. Najpierw zarejestrować, jeśli nie ma konta: 
4. Zresetować hasło (jeśli skonfigurowano SMTP) przez interfejs WWW
Zgubiłem Mind Key
Symptomy
- Brak dostępu do wspomnień
- Mind Key został usunięty/zgubiony
Rozwiązania
Mind Key nie można odzyskać. Należy:
1. Zalogować się, aby uzyskać JWT: 
2. Wylistować umysły:  (z JWT)
3. Utworzyć nowy umysł: 
4. Zapisać nowy Mind Key
5. (Opcjonalnie) Usunąć stary umysł: 
Dane w starym umyśle są utracone, chyba że Mind Key zostanie odnaleziony.
Wywołania API zwracają 401
Symptomy
- Wszystkie wywołania API zwracają 401 Unauthorized
- „Mind Key fehlt oder ungültig"
Rozwiązania
1. Zweryfikować format nagłówka: 
2. Sprawdzić, czy Mind Key zaczyna się od  (nie , które to JWT)
3. Przetestować bezpośrednio:
   [CODE BLOCK]
4. Mind Key może być cofnięty — utworzyć nowy umysł
Patrz Autoryzacja.
Wywołania API zwracają 404
Symptomy
- 404 Not Found
- „Route not found"
Rozwiązania
> [!CRITICAL]
> Nie wolno zgadywać ścieżek endpointów. Istnieją tylko ścieżki w .
1. Sprawdzić poprawne endpointy: 
2. Porównać URL dokładnie — wielkość liter ma znaczenie, bez końcowych ukośników
3. Sprawdzić metodę HTTP —  i  to różne endpointy
Wywołania API zwracają 429
Symptomy
- 429 Too Many Requests
- „Rate limit exceeded"
Rozwiązania
1. Przełączyć się na autoryzację nagłówkiem (bez limitu):
   [CODE BLOCK]
2. Odczekać  sekund, jeśli trzeba użyć 
Patrz Limity żądań.
Wyszukiwanie wspomnień nie zwraca wyników
Symptomy
-  zwraca puste
- Wspomnienia na pewno istnieją
Rozwiązania
1. Zweryfikować istnienie wspomnień: 
2. Sprawdzić składnię wyszukiwania — FTS5 ma specyficzną składnię
3. Spróbować prostszego zapytania —  zamiast 
4. Użyć wyszukiwania semantycznego do zapytań koncepcyjnych: 
Patrz Wyszukiwanie FTS5.
Wspomnienia nie utrwalają się
Symptomy
- POST /memory zwraca sukces
- GET /memory/recall nie pokazuje ich
Rozwiązania
1. Zweryfikować ten sam Mind Key — różne klucze = różne umysły
2. Sprawdzić odpowiedź — POST zwraca 
3. Spróbować GET /memory (lista JSON) zamiast /memory/recall (tekst)
4. Sprawdzić filtr —  lub  mogą je ukrywać
Narzędzia nie pojawiają się w Claude Desktop
Symptomy
- Claude Desktop pokazuje 0 narzędzi
- Brak ikony 🔌
Rozwiązania
1. W pełni zrestartować Claude Desktop (Cmd+Q)
2. Zweryfikować, czy plik konfiguracyjny jest poprawnym JSON-em
3. Sprawdzić Node.js 18+ zainstalowany
4. Uruchomić MCP ręcznie: 
5. Sprawdzić logi: 
Patrz Rozwiązywanie problemów MCP.
Synapse jest offline
Symptomy
- Nie można dotrzeć do synapse.schaefer.zone
- curl przekracza czas oczekiwania
Rozwiązania
1. Sprawdzić połączenie internetowe — spróbować innej strony
2. Sprawdzić kondycję Synapse: 
3. Poczekać — może to być tymczasowa awaria lub wdrożenie
4. Sprawdzić stronę statusu (jeśli dostępna)
Dla self-hosted: sprawdzić status kontenera Docker, połączenie z bazą danych.
Błędy bazy danych
Symptomy
- 500 Internal Server Error
- „Database connection failed"
Rozwiązania
Dla self-hosted:
1. Sprawdzić, czy PostgreSQL działa: 
2. Sprawdzić DATABASEURL w środowisku
3. Sprawdzić migracje: 
4. Sprawdzić miejsce na dysku: 
Dla hostowanej wersji: zgłosić do wsparcia.
Webhook się nie wyzwala
Symptomy
- Zarejestrowany webhook, ale brak wywołań zwrotnych
- Brak POST pod podany URL
Rozwiązania
1. Zweryfikować osiągalność URL: 
2. Sprawdzić filtr zdarzeń —  pasuje do wszystkich zdarzeń pamięci
3. Przetestować webhook: 
4. Sprawdzić, czy webhook jest włączony: 
5. Zweryfikować SSL — Synapse wymaga ważnego HTTPS dla URL-i webhooków
Patrz Webhooks API.
Zadanie cron się nie uruchamia
Symptomy
- Utworzono zadanie cron, ale się nie wyzwala
-  się nie aktualizuje
Rozwiązania
1. Sprawdzić składnię harmonogramu — musi być poprawny cron 5-polowy lub liczba całkowita sekund
2. Zweryfikować, czy endpoint jest dozwolony — musi być http(s), bez prywatnych IP
3. Sprawdzić, czy zadanie jest włączone: 
4. Poczekać na następny zaplanowany czas — cron nie jest natychmiastowy
Patrz Cron i Scheduler.
Potrzebna dalsza pomoc?
1. Sprawdzić istniejącą dokumentację: <https://synapse.schaefer.zone/docs>
2. Przeszukać dokumentację: 
3. Otworzyć zgłoszenie: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. Kontakt: patrz strona 
Następne kroki
- Błędy i ich obsługa
- FAQ API
- Rozwiązywanie problemów MCP