# 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**:
   ```bash
   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](/docs/getting-started/authentication).

## API-anrop returnerar 404

### Symptom

- 404 Not Found
- "Route not found"

### Lösningar

> [!CRITICAL]
> Gissa inte endpointsökvägar. Endast sökvägar i `GET /endpoints` existerar.

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):
   ```bash
   # 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](/docs/api/rate-limits).

## 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](/docs/concepts/fts5-search).

## 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](/docs/mcp/troubleshooting).

## 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](/docs/api/webhooks).

## 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](/docs/api/cron).

## 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](/docs/api/errors)
- [API FAQ](/docs/faq/api-faq)
- [MCP-felsökning](/docs/mcp/troubleshooting)