{"title":"Felsöknings-FAQ","slug":"troubleshooting","category":"faq","summary":"Lösningar på vanliga Synapse-problem — autentisering, nätverk, data, driftsättning.","audience":["human","llm"],"tags":["faq","troubleshooting","problems","solutions"],"difficulty":"beginner","updated":"2026-06-27","word_count":605,"read_minutes":3,"lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Felsöknings-FAQ\n\nLösningar på vanliga Synapse-problem.\n\n## Jag kan inte logga in\n\n### Symptom\n\n- `POST /login` returnerar 401\n- \"Invalid email or password\"\n\n### Lösningar\n\n1. **Verifiera att e-postadressen är korrekt** — skiftesokänslig\n2. **Kontrollera lösenordet** — minst 6 tecken\n3. **Registrera först** om ni inte har ett konto: `POST /register`\n4. **Återställ lösenord** (om SMTP konfigurerat) via webbgränssnittet\n\n## Jag har tappat min Mind Key\n\n### Symptom\n\n- Kan inte komma åt minnen\n- Mind Key har raderats/tappats\n\n### Lösningar\n\nMind Keys kan inte återställas. Ni måste:\n\n1. Logga in för att få JWT: `POST /login`\n2. Lista minds: `GET /minds` (med JWT)\n3. Skapa ny mind: `POST /minds`\n4. Spara ny Mind Key\n5. (Valfritt) Ta bort gammal mind: `DELETE /minds/:id`\n\n**Data i den gamla mind är förlorad** om ni inte kan hitta Mind Key.\n\n## API-anrop returnerar 401\n\n### Symptom\n\n- Alla API-anrop returnerar 401 Unauthorized\n- \"Mind Key fehlt oder ungültig\"\n\n### Lösningar\n\n1. **Verifiera header-format**: `Authorization: Bearer mk_...`\n2. **Kontrollera att Mind Key börjar med `mk_`** (inte `eyJ` som är JWT)\n3. **Testa direkt**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n4. **Mind Key kan vara återkallad** — skapa en ny mind\n\nSe [Autentisering](/docs/getting-started/authentication).\n\n## API-anrop returnerar 404\n\n### Symptom\n\n- 404 Not Found\n- \"Route not found\"\n\n### Lösningar\n\n> [!CRITICAL]\n> Gissa inte endpointsökvägar. Endast sökvägar i `GET /endpoints` existerar.\n\n1. **Kontrollera giltiga endpoints**: `curl https://synapse.schaefer.zone/endpoints`\n2. **Jämför URL exakt** — skiftesokänslig, inga avslutande snedstreck\n3. **Kontrollera HTTP-metod** — `GET /memory` vs `POST /memory` är olika\n\n## API-anrop returnerar 429\n\n### Symptom\n\n- 429 Too Many Requests\n- \"Rate limit exceeded\"\n\n### Lösningar\n\n1. **Byt till header-auth** (ingen hastighetsgräns):\n ```bash\n # Don't\n curl \".../memory/recall?key=mk_...\"\n \n # Do\n curl -H \"Authorization: Bearer mk_...\" .../memory/recall\n ```\n2. **Vänta `Retry-After` sekunder** om ni måste använda `?key=`\n\nSe [Hastighetsgränser](/docs/api/rate-limits).\n\n## Minnessökning returnerar inga resultat\n\n### Symptom\n\n- `GET /memory/search?q=...` returnerar tomt\n- Vet att minnen finns\n\n### Lösningar\n\n1. **Verifiera att minnen finns**: `GET /memory/recall`\n2. **Kontrollera söksyntax** — FTS5 har specifik syntax\n3. **Prova enklare fråga** — `?q=docker` istället för `?q=docker+swarm+deployment`\n4. **Använd semantisk sökning** för begreppsliga frågor: `GET /memory/semantic-search?q=...`\n\nSe [FTS5-sökning](/docs/concepts/fts5-search).\n\n## Minnen persistens inte\n\n### Symptom\n\n- POST /memory returnerar framgång\n- GET /memory/recall visar dem inte\n\n### Lösningar\n\n1. **Verifiera samma Mind Key** — olika nycklar = olika minds\n2. **Kontrollera svar** — POST returnerar `{ \"id\": \"mem_...\", \"status\": \"stored\" }`\n3. **Prova GET /memory** (JSON-lista) istället för /memory/recall (text)\n4. **Kontrollera filter** — `?category=` eller `?tag=` kan dölja dem\n\n## Verktyg visas inte i Claude Desktop\n\n### Symptom\n\n- Claude Desktop visar 0 verktyg\n- Ingen 🔌-ikon\n\n### Lösningar\n\n1. **Starta om Claude Desktop helt** (Cmd+Q)\n2. **Verifiera att konfigurationsfilen** är giltig JSON\n3. **Kontrollera att Node.js 18+** är installerat\n4. **Kör MCP manuellt**: `npx -y synapse-mcp-api@latest`\n5. **Kontrollera loggar**: `~/Library/Logs/Claude/mcp.log`\n\nSe [MCP-felsökning](/docs/mcp/troubleshooting).\n\n## Synapse är offline\n\n### Symptom\n\n- Kan inte nå synapse.schaefer.zone\n- curl time-out\n\n### Lösningar\n\n1. **Kontrollera er internetanslutning** — prova en annan webbplats\n2. **Kontrollera Synapse-hälsa**: `curl https://synapse.schaefer.zone/health`\n3. **Vänta** — kan vara tillfälligt avbrott eller driftsättning\n4. **Kontrollera statussida** (om tillgänglig)\n\nFör egenvärd: kontrollera Docker-containerstatus, databasanslutning.\n\n## Databasfel\n\n### Symptom\n\n- 500 Internal Server Error\n- \"Database connection failed\"\n\n### Lösningar\n\nFör egenvärd:\n\n1. **Kontrollera att PostgreSQL körs**: `docker ps | grep postgres`\n2. **Kontrollera DATABASE_URL** i env\n3. **Kontrollera migreringar**: `npm run migrate:check`\n4. **Kontrollera diskutrymme**: `df -h`\n\nFör värdhostad: rapportera till support.\n\n## Webhook utlöses inte\n\n### Symptom\n\n- Registrerad webhook men får inga återanrop\n- Ingen POST till er URL\n\n### Lösningar\n\n1. **Verifiera att URL:en är nåbar**: `curl -X POST your-url -d '{}'`\n2. **Kontrollera händelsefilter** — `memory.*` matchar alla minneshändelser\n3. **Testa webhook**: `POST /webhooks/:id/test`\n4. **Kontrollera att webhook är aktiverad**: `GET /webhooks/:id`\n5. **Verifiera SSL** — Synapse kräver giltig HTTPS för webhook-URL:er\n\nSe [Webhooks API](/docs/api/webhooks).\n\n## Cron-jobb körs inte\n\n### Symptom\n\n- Skapat cron-jobb men det utlöses inte\n- `next_run` uppdateras inte\n\n### Lösningar\n\n1. **Kontrollera schemasyntax** — måste vara giltig 5-fältig cron ELLER heltal sekunder\n2. **Verifiera att endpoint tillåts** — måste vara http(s), inga privata IP:er\n3. **Kontrollera att jobbet är aktiverat**: `GET /cron`\n4. **Vänta till nästa schemalagda tid** — cron är inte omedelbar\n\nSe [Cron & Scheduler](/docs/api/cron).\n\n## Behöver mer hjälp?\n\n1. **Kontrollera befintlig dokumentation**: \n2. **Sök i dokumentation**: `GET /docs/search?q=your+question`\n3. **Öppna ärende**: \n4. **Kontakt**: se `/support`-sida\n\n## Nästa steg\n\n- [Fel & felhantering](/docs/api/errors)\n- [API FAQ](/docs/faq/api-faq)\n- [MCP-felsökning](/docs/mcp/troubleshooting)\n","content_html":"

Felsöknings-FAQ

\n

Lösningar på vanliga Synapse-problem.

\n

Jag kan inte logga in

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Verifiera att e-postadressen är korrekt — skiftesokänslig
    2. \n
  2. Kontrollera lösenordet — minst 6 tecken
    3. \n
  3. Registrera först om ni inte har ett konto: POST /register
    4. \n
  4. Återställ lösenord (om SMTP konfigurerat) via webbgränssnittet
    5. \n
\n

Jag har tappat min Mind Key

\n

Symptom

\n\n

Lösningar

\n

Mind Keys kan inte återställas. Ni måste:

\n
    \n
  1. Logga in för att få JWT: POST /login
    2. \n
  2. Lista minds: GET /minds (med JWT)
    3. \n
  3. Skapa ny mind: POST /minds
    4. \n
  4. Spara ny Mind Key
    5. \n
  5. (Valfritt) Ta bort gammal mind: DELETE /minds/:id
    6. \n
\n

Data i den gamla mind är förlorad om ni inte kan hitta Mind Key.

\n

API-anrop returnerar 401

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Verifiera header-format: Authorization: Bearer mk_...
    2. \n
  2. Kontrollera att Mind Key börjar med mk_ (inte eyJ som är JWT)
    3. \n
  3. Testa direkt:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    4. \n
  4. Mind Key kan vara återkallad — skapa en ny mind
    5. \n
\n

Se Autentisering.

\n

API-anrop returnerar 404

\n

Symptom

\n\n

Lösningar

\n
Gissa inte endpointsökvägar. Endast sökvägar i `GET /endpoints` existerar.
    \n
  1. Kontrollera giltiga endpoints: curl https://synapse.schaefer.zone/endpoints
    2. \n
  2. Jämför URL exakt — skiftesokänslig, inga avslutande snedstreck
    3. \n
  3. Kontrollera HTTP-metod — GET /memory vs POST /memory är olika
    4. \n
\n

API-anrop returnerar 429

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Byt till header-auth (ingen hastighetsgräns):
    # Don't\ncurl ".../memory/recall?key=mk_..."\n\n# Do\ncurl -H "Authorization: Bearer mk_..." .../memory/recall
    2. \n
  2. Vänta Retry-After sekunder om ni måste använda ?key=
    3. \n
\n

Se Hastighetsgränser.

\n

Minnessökning returnerar inga resultat

\n

Symptom

\n\n

Lösningar

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

Se FTS5-sökning.

\n

Minnen persistens inte

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Verifiera samma Mind Key — olika nycklar = olika minds
    2. \n
  2. Kontrollera svar — POST returnerar { "id": "mem_...", "status": "stored" }
    3. \n
  3. Prova GET /memory (JSON-lista) istället för /memory/recall (text)
    4. \n
  4. Kontrollera filter — ?category= eller ?tag= kan dölja dem
    5. \n
\n

Verktyg visas inte i Claude Desktop

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Starta om Claude Desktop helt (Cmd+Q)
    2. \n
  2. Verifiera att konfigurationsfilen är giltig JSON
    3. \n
  3. Kontrollera att Node.js 18+ är installerat
    4. \n
  4. Kör MCP manuellt: npx -y synapse-mcp-api@latest
    5. \n
  5. Kontrollera loggar: ~/Library/Logs/Claude/mcp.log
    6. \n
\n

Se MCP-felsökning.

\n

Synapse är offline

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Kontrollera er internetanslutning — prova en annan webbplats
    2. \n
  2. Kontrollera Synapse-hälsa: curl https://synapse.schaefer.zone/health
    3. \n
  3. Vänta — kan vara tillfälligt avbrott eller driftsättning
    4. \n
  4. Kontrollera statussida (om tillgänglig)
    5. \n
\n

För egenvärd: kontrollera Docker-containerstatus, databasanslutning.

\n

Databasfel

\n

Symptom

\n\n

Lösningar

\n

För egenvärd:

\n
    \n
  1. Kontrollera att PostgreSQL körs: docker ps | grep postgres
    2. \n
  2. Kontrollera DATABASE_URL i env
    3. \n
  3. Kontrollera migreringar: npm run migrate:check
    4. \n
  4. Kontrollera diskutrymme: df -h
    5. \n
\n

För värdhostad: rapportera till support.

\n

Webhook utlöses inte

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Verifiera att URL:en är nåbar: curl -X POST your-url -d '{}'
    2. \n
  2. Kontrollera händelsefilter — memory.* matchar alla minneshändelser
    3. \n
  3. Testa webhook: POST /webhooks/:id/test
    4. \n
  4. Kontrollera att webhook är aktiverad: GET /webhooks/:id
    5. \n
  5. Verifiera SSL — Synapse kräver giltig HTTPS för webhook-URL:er
    6. \n
\n

Se Webhooks API.

\n

Cron-jobb körs inte

\n

Symptom

\n\n

Lösningar

\n
    \n
  1. Kontrollera schemasyntax — måste vara giltig 5-fältig cron ELLER heltal sekunder
    2. \n
  2. Verifiera att endpoint tillåts — måste vara http(s), inga privata IP:er
    3. \n
  3. Kontrollera att jobbet är aktiverat: GET /cron
    4. \n
  4. Vänta till nästa schemalagda tid — cron är inte omedelbar
    5. \n
\n

Se Cron & Scheduler.

\n

Behöver mer hjälp?

\n
    \n
  1. Kontrollera befintlig dokumentation: https://synapse.schaefer.zone/docs
    2. \n
  2. Sök i dokumentation: GET /docs/search?q=your+question
    3. \n
  3. Öppna ärende: https://gitlab.com/schaefer-services/synapse/-/issues
    4. \n
  4. Kontakt: se /support-sida
    5. \n
\n

Nästa steg

\n\n","urls":{"html":"/docs/faq/troubleshooting","text":"/docs/faq/troubleshooting?format=text","json":"/docs/faq/troubleshooting?format=json","llm":"/docs/faq/troubleshooting?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}