Felsöknings-FAQ

Lösningar på vanliga Synapse-problem.

Jag kan inte logga in

Symptom

• POST /login 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: POST /register
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: POST /login
2. Lista minds: GET /minds (med JWT)
3. Skapa ny mind: POST /minds
4. Spara ny Mind Key
5. (Valfritt) Ta bort gammal mind: DELETE /minds/:id

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: Authorization: Bearer mk_...
2. Kontrollera att Mind Key börjar med mk_ (inte eyJ som är JWT)
3. Testa direkt:

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

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

1. Kontrollera giltiga endpoints: curl https://synapse.schaefer.zone/endpoints
2. Jämför URL exakt — skiftesokänslig, inga avslutande snedstreck
3. Kontrollera HTTP-metod — GET /memory vs POST /memory är olika

API-anrop returnerar 429

Symptom

• 429 Too Many Requests
• "Rate limit exceeded"

Lösningar

1. Byt till header-auth (ingen hastighetsgräns):

   # Don't
   curl ".../memory/recall?key=mk_..."
   
   # Do
   curl -H "Authorization: Bearer mk_..." .../memory/recall

2. Vänta Retry-After sekunder om ni måste använda ?key=

Se Hastighetsgränser.

Minnessökning returnerar inga resultat

Symptom

• GET /memory/search?q=... returnerar tomt
• Vet att minnen finns

Lösningar

1. Verifiera att minnen finns: GET /memory/recall
2. Kontrollera söksyntax — FTS5 har specifik syntax
3. Prova enklare fråga — ?q=docker istället för ?q=docker+swarm+deployment
4. Använd semantisk sökning för begreppsliga frågor: GET /memory/semantic-search?q=...

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 { "id": "mem_...", "status": "stored" }
3. Prova GET /memory (JSON-lista) istället för /memory/recall (text)
4. Kontrollera filter — ?category= eller ?tag= 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: npx -y synapse-mcp-api@latest
5. Kontrollera loggar: ~/Library/Logs/Claude/mcp.log

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: curl https://synapse.schaefer.zone/health
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: docker ps | grep postgres
2. Kontrollera DATABASE_URL i env
3. Kontrollera migreringar: npm run migrate:check
4. Kontrollera diskutrymme: df -h

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: curl -X POST your-url -d '{}'
2. Kontrollera händelsefilter — memory.* matchar alla minneshändelser
3. Testa webhook: POST /webhooks/:id/test
4. Kontrollera att webhook är aktiverad: GET /webhooks/:id
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
• next_run 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: GET /cron
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: GET /docs/search?q=your+question
3. Öppna ärende: https://gitlab.com/schaefer-services/synapse/-/issues
4. Kontakt: se /support-sida

Nästa steg

• Fel & felhantering
• API FAQ
• MCP-felsökning