# Felsöknings-FAQ
SUMMARY: Lösningar på vanliga Synapse-problem — autentisering, nätverk, data, driftsättning.

Felsöknings-FAQ
Lösningar på vanliga Synapse-problem.
Jag kan inte logga in
Symptom
-  returnerar 401
- "Invalid email or password"
Lösningar
1. Verifiera att e-postadressen är korrekt — skiftesokänslig
2. Kontrollera lösenordet — minst 6 tecken
3. Registrera först om ni inte har ett konto: 
4. Återställ lösenord (om SMTP konfigurerat) via webbgränssnittet
Jag har tappat min Mind Key
Symptom
- Kan inte komma åt minnen
- Mind Key har raderats/tappats
Lösningar
Mind Keys kan inte återställas. Ni måste:
1. Logga in för att få JWT: 
2. Lista minds:  (med JWT)
3. Skapa ny mind: 
4. Spara ny Mind Key
5. (Valfritt) Ta bort gammal mind: 
Data i den gamla mind är förlorad om ni inte kan hitta Mind Key.
API-anrop returnerar 401
Symptom
- Alla API-anrop returnerar 401 Unauthorized
- "Mind Key fehlt oder ungültig"
Lösningar
1. Verifiera header-format: 
2. Kontrollera att Mind Key börjar med  (inte  som är JWT)
3. Testa direkt:
   [CODE BLOCK]
4. Mind Key kan vara återkallad — skapa en ny mind
Se Autentisering.
API-anrop returnerar 404
Symptom
- 404 Not Found
- "Route not found"
Lösningar
> [!CRITICAL]
> Gissa inte endpointsökvägar. Endast sökvägar i  existerar.
1. Kontrollera giltiga endpoints: 
2. Jämför URL exakt — skiftesokänslig, inga avslutande snedstreck
3. Kontrollera HTTP-metod —  vs  är olika
API-anrop returnerar 429
Symptom
- 429 Too Many Requests
- "Rate limit exceeded"
Lösningar
1. Byt till header-auth (ingen hastighetsgräns):
   [CODE BLOCK]
2. Vänta  sekunder om ni måste använda 
Se Hastighetsgränser.
Minnessökning returnerar inga resultat
Symptom
-  returnerar tomt
- Vet att minnen finns
Lösningar
1. Verifiera att minnen finns: 
2. Kontrollera söksyntax — FTS5 har specifik syntax
3. Prova enklare fråga —  istället för 
4. Använd semantisk sökning för begreppsliga frågor: 
Se FTS5-sökning.
Minnen persistens inte
Symptom
- POST /memory returnerar framgång
- GET /memory/recall visar dem inte
Lösningar
1. Verifiera samma Mind Key — olika nycklar = olika minds
2. Kontrollera svar — POST returnerar 
3. Prova GET /memory (JSON-lista) istället för /memory/recall (text)
4. Kontrollera filter —  eller  kan dölja dem
Verktyg visas inte i Claude Desktop
Symptom
- Claude Desktop visar 0 verktyg
- Ingen 🔌-ikon
Lösningar
1. Starta om Claude Desktop helt (Cmd+Q)
2. Verifiera att konfigurationsfilen är giltig JSON
3. Kontrollera att Node.js 18+ är installerat
4. Kör MCP manuellt: 
5. Kontrollera loggar: 
Se MCP-felsökning.
Synapse är offline
Symptom
- Kan inte nå synapse.schaefer.zone
- curl time-out
Lösningar
1. Kontrollera er internetanslutning — prova en annan webbplats
2. Kontrollera Synapse-hälsa: 
3. Vänta — kan vara tillfälligt avbrott eller driftsättning
4. Kontrollera statussida (om tillgänglig)
För egenvärd: kontrollera Docker-containerstatus, databasanslutning.
Databasfel
Symptom
- 500 Internal Server Error
- "Database connection failed"
Lösningar
För egenvärd:
1. Kontrollera att PostgreSQL körs: 
2. Kontrollera DATABASEURL i env
3. Kontrollera migreringar: 
4. Kontrollera diskutrymme: 
För värdhostad: rapportera till support.
Webhook utlöses inte
Symptom
- Registrerad webhook men får inga återanrop
- Ingen POST till er URL
Lösningar
1. Verifiera att URL:en är nåbar: 
2. Kontrollera händelsefilter —  matchar alla minneshändelser
3. Testa webhook: 
4. Kontrollera att webhook är aktiverad: 
5. Verifiera SSL — Synapse kräver giltig HTTPS för webhook-URL:er
Se Webhooks API.
Cron-jobb körs inte
Symptom
- Skapat cron-jobb men det utlöses inte
-  uppdateras inte
Lösningar
1. Kontrollera schemasyntax — måste vara giltig 5-fältig cron ELLER heltal sekunder
2. Verifiera att endpoint tillåts — måste vara http(s), inga privata IP:er
3. Kontrollera att jobbet är aktiverat: 
4. Vänta till nästa schemalagda tid — cron är inte omedelbar
Se Cron & Scheduler.
Behöver mer hjälp?
1. Kontrollera befintlig dokumentation: <https://synapse.schaefer.zone/docs>
2. Sök i dokumentation: 
3. Öppna ärende: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. Kontakt: se -sida
Nästa steg
- Fel & felhantering
- API FAQ
- MCP-felsökning