# Troubleshooting-FAQ
SUMMARY: Lösungen für häufige Synapse-Probleme — Auth, Netzwerk, Daten, Deployment.

Troubleshooting-FAQ
Lösungen für häufige Synapse-Probleme.
Ich kann mich nicht einloggen
Symptome
-  liefert 401
- „Invalid email or password"
Lösungen
1. E-Mail verifizieren — Case-sensitive
2. Passwort prüfen — mindestens 6 Zeichen
3. Zuerst registrieren, falls du kein Konto hast: 
4. Passwort zurücksetzen (falls SMTP konfiguriert) via Web-UI
Ich habe meinen Mind Key verloren
Symptome
- Kann nicht auf Memories zugreifen
- Mind Key wurde gelöscht/verloren
Lösungen
Mind Keys können nicht wiederhergestellt werden. Du musst:
1. Einloggen, um JWT zu erhalten: 
2. Minds auflisten:  (mit JWT)
3. Neuen Mind anlegen: 
4. Neuen Mind Key speichern
5. (Optional) Alten Mind löschen: 
Daten im alten Mind sind verloren, außer du findest den Mind Key.
API-Aufrufe liefern 401
Symptome
- Alle API-Aufrufe liefern 401 Unauthorized
- „Mind Key fehlt oder ungültig"
Lösungen
1. Header-Format verifizieren: 
2. Prüfen, dass Mind Key mit  beginnt (nicht , das ist JWT)
3. Direkt testen:
   [CODE BLOCK]
4. Mind Key könnte widerrufen sein — neuen Mind anlegen
Siehe Authentifizierung.
API-Aufrufe liefern 404
Symptome
- 404 Not Found
- „Route not found"
Lösungen
> [!CRITICAL]
> Rate keine Endpunkt-Pfade. Nur Pfade in  existieren.
1. Gültige Endpunkte prüfen: 
2. URL exakt vergleichen — Case-sensitive, keine Trailing-Slashes
3. HTTP-Methode prüfen —  vs  sind unterschiedlich
API-Aufrufe liefern 429
Symptome
- 429 Too Many Requests
- „Rate limit exceeded"
Lösungen
1. Auf Header-Auth wechseln (kein Rate Limit):
   [CODE BLOCK]
2.  Sekunden warten, falls du  verwenden musst
Siehe Rate Limits.
Memory-Suche liefert keine Ergebnisse
Symptome
-  liefert leer
- weiß, dass Memories existieren
Lösungen
1. Verifizieren, dass Memories existieren: 
2. Such-Syntax prüfen — FTS5 hat spezifische Syntax
3. Einfachere Query versuchen —  statt 
4. Semantische Suche für konzeptionelle Queries: 
Siehe FTS5-Suche.
Memories werden nicht persistiert
Symptome
- POST /memory liefert Success
- GET /memory/recall zeigt sie nicht
Lösungen
1. Selben Mind Key verifizieren — verschiedene Keys = verschiedene Minds
2. Response prüfen — POST liefert 
3. GET /memory versuchen (JSON-Liste) statt /memory/recall (Text)
4. Filter prüfen —  oder  könnten sie verbergen
Tools erscheinen nicht in Claude Desktop
Symptome
- Claude Desktop zeigt 0 Tools
- Kein 🔌-Icon
Lösungen
1. Claude Desktop vollständig neu starten (Cmd+Q)
2. Config-Datei prüfen — valides JSON
3. Node.js 18+ installiert prüfen
4. MCP manuell ausführen: 
5. Logs prüfen: 
Siehe MCP-Troubleshooting.
Synapse ist offline
Symptome
- synapse.schaefer.zone nicht erreichbar
- curl läuft in Timeout
Lösungen
1. Internet prüfen — andere Seite versuchen
2. Synapse-Health prüfen: 
3. Warten — könnte temporärer Ausfall oder Deployment sein
4. Status-Seite prüfen (falls verfügbar)
Für Self-Hosted: Docker-Container-Status und Datenbankverbindung prüfen.
Datenbankfehler
Symptome
- 500 Internal Server Error
- „Database connection failed"
Lösungen
Für Self-Hosted:
1. PostgreSQL läuft prüfen: 
2. DATABASEURL in Env prüfen
3. Migrationen prüfen: 
4. Speicherplatz prüfen: 
Für gehostet: an Support melden.
Webhook feuert nicht
Symptome
- Webhook registriert, aber keine Callbacks erhalten
- Kein POST an deine URL
Lösungen
1. URL erreichbar verifizieren: 
2. Events-Filter prüfen —  matched alle Memory-Events
3. Webhook testen: 
4. Webhook aktiviert prüfen: 
5. SSL verifizieren — Synapse erfordert gültiges HTTPS für Webhook-URLs
Siehe Webhooks-API.
Cron-Job läuft nicht
Symptome
- Cron-Job angelegt, aber er feuert nicht
-  aktualisiert nicht
Lösungen
1. Schedule-Syntax prüfen — muss gültiges 5-Feld-Cron ODER Integer-Sekunden sein
2. Endpunkt erlaubt verifizieren — muss http(s) sein, keine privaten IPs
3. Job aktiviert prüfen: 
4. Auf nächste geplante Zeit warten — Cron ist nicht instant
Siehe Cron & Scheduler.
Brauchst du weitere Hilfe?
1. Bestehende Doku prüfen: <https://synapse.schaefer.zone/docs>
2. Doku durchsuchen: 
3. Issue öffnen: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. Kontakt: siehe -Seite
Nächste Schritte
- Errors & Fehlerbehandlung
- API-FAQ
- MCP-Troubleshooting