{"title":"MCP-felsökning","slug":"troubleshooting","category":"mcp","summary":"Lös vanliga MCP-integrationsproblem — server startar inte, verktyg visas inte, auth-fel.","audience":["human","llm"],"tags":["mcp","troubleshooting","errors","debugging"],"difficulty":"intermediate","updated":"2026-06-27","word_count":510,"read_minutes":3,"llm_context":"Common issues:\n1. Node.js < 18 → upgrade to 18+\n2. Mind Key invalid → check format (mk_...), get fresh via POST /minds\n3. npx not found → install Node.js\n4. Tools not appearing → restart client, check config JSON validity\n5. SYNAPSE_URL unreachable → curl /health to verify\n6. MCP server crashes → check logs, run npx manually to see error\nDebug steps: run `npx -y synapse-mcp-api@latest` manually, check stderr\nLogs: Claude Desktop ~/Library/Logs/Claude/mcp.log, Cursor ~/.cursor/logs/\n","lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# MCP-felsökning\n\nVanliga problem och lösningar vid integration av Synapse MCP med er LLM-klient.\n\n## Snabb checklista för diagnostik\n\n1. ✅ Node.js 18+ installerat? (`node --version`)\n2. ✅ Mind Key börjar med `mk_`? (inte JWT `eyJ...`)\n3. ✅ Synapse API nåbart? (`curl https://synapse.schaefer.zone/health`)\n4. ✅ Mind Key fungerar? (`curl -H \"Authorization: Bearer mk_...\" .../memory/recall`)\n5. ✅ Konfigurationsfil är giltig JSON? (inga avslutande kommatecken, inga kommentarer)\n6. ✅ Klient omstartad efter konfigurationsändring?\n7. ✅ MCP-server startar manuellt? (`npx -y synapse-mcp-api@latest`)\n\n## Problem: Inga verktyg visas i klienten\n\n### Symptom\n\n- Claude Desktop / Cursor / Continue visar 0 verktyg\n- Ingen 🔌-ikon eller \"synapse\"-post i MCP-serverlista\n\n### Lösningar\n\n1. **Starta om klienten helt** — Cmd+Q på macOS (inte bara stäng fönstret)\n2. **Kontrollera sökväg till konfigurationsfil**:\n - Claude Desktop macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n - Claude Desktop Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n - Cursor: `~/.cursor/config.json`\n - Continue: `~/.continue/config.json`\n3. **Validera JSON** — klistra in konfiguration i \n4. **Kontrollera klientloggar** för MCP-fel:\n - Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n - Cursor: View → Output → MCP\n5. **Kör MCP-server manuellt** för att se startfel:\n ```bash\n SYNAPSE_MIND_KEY=mk_... npx -y synapse-mcp-api@latest\n ```\n\n## Problem: \"Mind Key invalid\"-fel\n\n### Symptom\n\n- Verktyg visas men anrop misslyckas med \"401 Unauthorized\"\n- Fel: \"Mind Key fehlt oder ungültig\"\n\n### Lösningar\n\n1. **Verifiera Mind Key-format** — börjar med `mk_`, ~40 tecken\n2. **Testa direkt**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n3. **Kontrollera att miljövariabel är satt** — för stdio-transport måste\n miljövariabeln vara i MCP-serverkonfigurationen, inte ert shell\n4. **Hämta en ny Mind Key**:\n ```bash\n # Login to get JWT\n curl -X POST .../login -d '{\"email\":\"...\",\"password\":\"...\"}'\n # Create new mind\n curl -X POST .../minds -H \"Authorization: Bearer YOUR_JWT\" -d '{\"name\":\"new mind\"}'\n ```\n\n## Problem: npx hittades inte\n\n### Symptom\n\n- Fel: \"npx: command not found\"\n- MCP-server startar inte\n\n### Lösningar\n\n1. **Installera Node.js 18+**:\n - macOS: `brew install node` eller ladda ner från \n - Linux: `curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs`\n - Windows: ladda ner från \n2. **Starta om terminal** efter installation\n3. **Verifiera**: `node --version && npx --version`\n\n## Problem: SYNAPSE_URL onåbar\n\n### Symptom\n\n- MCP-server startar men verktygsanrop time-outar\n- Fel: \"fetch failed\" eller \"ECONNREFUSED\"\n\n### Lösningar\n\n1. **Testa anslutning**:\n ```bash\n curl https://synapse.schaefer.zone/health\n ```\n2. **Kontrollera företagsbrandvägg** — kan blockera utgående HTTPS\n3. **Prova alternativ URL**:\n - Produktion: `https://synapse.schaefer.zone`\n - MCP-server: `https://synapse-mcp.schaefer.zone`\n4. **För egenvärd**: säkerställ att er Synapse-instans körs och är åtkomlig\n\n## Problem: MCP-server kraschar\n\n### Symptom\n\n- MCP-server avslutas omedelbart efter start\n- Klientloggar visar \"MCP server disconnected\"\n\n### Lösningar\n\n1. **Kör manuellt för att se fel**:\n ```bash\n SYNAPSE_MIND_KEY=mk_... SYNAPSE_URL=https://synapse.schaefer.zone \\\n npx -y synapse-mcp-api@latest\n ```\n2. **Kontrollera portkonflikter** — MCP-server använder port 13100 som standard\n3. **Rensa npx-cache**:\n ```bash\n npx clear-npx-cache\n # or\n rm -rf ~/.npm/_npx\n ```\n4. **Uppdatera till senaste**:\n ```bash\n npx -y synapse-mcp-api@latest --version\n ```\n\n## Problem: Verktygsanrop returnerar 429\n\n### Symptom\n\n- Fel: \"Rate limit exceeded\"\n\n### Lösningar\n\nDetta bör inte hända med MCP (använder header-auth, ingen hastighetsgräns). Om det gör det:\n\n1. **Kontrollera om ni använder `?key=` nånstans** — byt till header-auth\n2. **Verifiera `SYNAPSE_URL`** — säkerställ att den pekar på rätt instans\n3. **Kontakta support** om problemet kvarstår\n\n## Problem: Verktyg visas men fungerar inte\n\n### Symptom\n\n- Verktyg listade i klient\n- Att anropa ett verktyg returnerar fel eller inget resultat\n\n### Lösningar\n\n1. **Kontrollera verktygsnamnet** — måste vara exakt (t.ex. `memory_recall`, inte `memory.recall`)\n2. **Verifiera argument** — kontrollera verktygets indataschema\n3. **Testa via direkt API**:\n ```bash\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer mk_...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"category\":\"fact\",\"key\":\"test\",\"content\":\"hello\"}'\n ```\n4. **Kontrollera Synapse-hälsa**:\n ```bash\n curl https://synapse.schaefer.zone/health\n ```\n\n## Få hjälp\n\nOm inget av ovanstående löser ert problem:\n\n1. **Kontrollera befintliga ärenden**: \n2. **Öppna ett nytt ärende** med:\n - MCP-serverversion (`npx -y synapse-mcp-api@latest --version`)\n - Klientnamn och version\n - Operativsystem\n - Relevanta loggutdrag\n - Steg för att reproducera\n\n## Nästa steg\n\n- [Claude Desktop-konfiguration](/docs/mcp/claude-desktop)\n- [Claude Code-konfiguration](/docs/mcp/claude-code)\n- [API-fel](/docs/api/errors)\n","content_html":"

MCP-felsökning

\n

Vanliga problem och lösningar vid integration av Synapse MCP med er LLM-klient.

\n

Snabb checklista för diagnostik

\n
    \n
  1. ✅ Node.js 18+ installerat? (node --version)
    2. \n
  2. ✅ Mind Key börjar med mk_? (inte JWT eyJ...)
    3. \n
  3. ✅ Synapse API nåbart? (curl https://synapse.schaefer.zone/health)
    4. \n
  4. ✅ Mind Key fungerar? (curl -H "Authorization: Bearer mk_..." .../memory/recall)
    5. \n
  5. ✅ Konfigurationsfil är giltig JSON? (inga avslutande kommatecken, inga kommentarer)
    6. \n
  6. ✅ Klient omstartad efter konfigurationsändring?
    7. \n
  7. ✅ MCP-server startar manuellt? (npx -y synapse-mcp-api@latest)
    8. \n
\n

Problem: Inga verktyg visas i klienten

\n

Symptom

\n
    \n
  • Claude Desktop / Cursor / Continue visar 0 verktyg
    • \n
  • Ingen 🔌-ikon eller "synapse"-post i MCP-serverlista
    • \n
\n

Lösningar

\n
    \n
  1. Starta om klienten helt — Cmd+Q på macOS (inte bara stäng fönstret)
    2. \n
  2. Kontrollera sökväg till konfigurationsfil:
      \n
    • Claude Desktop macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • \n
    • Claude Desktop Windows: %APPDATA%\\Claude\\claude_desktop_config.json
      • \n
    • Cursor: ~/.cursor/config.json
      • \n
    • Continue: ~/.continue/config.json
      • \n
    \n
    3. \n
  3. Validera JSON — klistra in konfiguration i https://jsonlint.com
    4. \n
  4. Kontrollera klientloggar för MCP-fel:
      \n
    • Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)
      • \n
    • Cursor: View → Output → MCP
      • \n
    \n
    5. \n
  5. Kör MCP-server manuellt för att se startfel:
    SYNAPSE_MIND_KEY=mk_... npx -y synapse-mcp-api@latest
    6. \n
\n

Problem: "Mind Key invalid"-fel

\n

Symptom

\n
    \n
  • Verktyg visas men anrop misslyckas med "401 Unauthorized"
    • \n
  • Fel: "Mind Key fehlt oder ungültig"
    • \n
\n

Lösningar

\n
    \n
  1. Verifiera Mind Key-format — börjar med mk_, ~40 tecken
    2. \n
  2. Testa direkt:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    3. \n
  3. Kontrollera att miljövariabel är satt — för stdio-transport måste\nmiljövariabeln vara i MCP-serverkonfigurationen, inte ert shell
    4. \n
  4. Hämta en ny Mind Key:
    # Login to get JWT\ncurl -X POST .../login -d '{"email":"...","password":"..."}'\n# Create new mind\ncurl -X POST .../minds -H "Authorization: Bearer YOUR_JWT" -d '{"name":"new mind"}'
    5. \n
\n

Problem: npx hittades inte

\n

Symptom

\n
    \n
  • Fel: "npx: command not found"
    • \n
  • MCP-server startar inte
    • \n
\n

Lösningar

\n
    \n
  1. Installera Node.js 18+:
      \n
    • macOS: brew install node eller ladda ner från https://nodejs.org
      • \n
    • Linux: curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs
      • \n
    • Windows: ladda ner från https://nodejs.org
      • \n
    \n
    2. \n
  2. Starta om terminal efter installation
    3. \n
  3. Verifiera: node --version && npx --version
    4. \n
\n

Problem: SYNAPSE_URL onåbar

\n

Symptom

\n
    \n
  • MCP-server startar men verktygsanrop time-outar
    • \n
  • Fel: "fetch failed" eller "ECONNREFUSED"
    • \n
\n

Lösningar

\n
    \n
  1. Testa anslutning:
    curl https://synapse.schaefer.zone/health
    2. \n
  2. Kontrollera företagsbrandvägg — kan blockera utgående HTTPS
    3. \n
  3. Prova alternativ URL:
      \n
    • Produktion: https://synapse.schaefer.zone
      • \n
    • MCP-server: https://synapse-mcp.schaefer.zone
      • \n
    \n
    4. \n
  4. För egenvärd: säkerställ att er Synapse-instans körs och är åtkomlig
    5. \n
\n

Problem: MCP-server kraschar

\n

Symptom

\n
    \n
  • MCP-server avslutas omedelbart efter start
    • \n
  • Klientloggar visar "MCP server disconnected"
    • \n
\n

Lösningar

\n
    \n
  1. Kör manuellt för att se fel:
    SYNAPSE_MIND_KEY=mk_... SYNAPSE_URL=https://synapse.schaefer.zone \\\n  npx -y synapse-mcp-api@latest
    2. \n
  2. Kontrollera portkonflikter — MCP-server använder port 13100 som standard
    3. \n
  3. Rensa npx-cache:
    npx clear-npx-cache\n# or\nrm -rf ~/.npm/_npx
    4. \n
  4. Uppdatera till senaste:
    npx -y synapse-mcp-api@latest --version
    5. \n
\n

Problem: Verktygsanrop returnerar 429

\n

Symptom

\n
    \n
  • Fel: "Rate limit exceeded"
    • \n
\n

Lösningar

\n

Detta bör inte hända med MCP (använder header-auth, ingen hastighetsgräns). Om det gör det:

\n
    \n
  1. Kontrollera om ni använder ?key= nånstans — byt till header-auth
    2. \n
  2. Verifiera SYNAPSE_URL — säkerställ att den pekar på rätt instans
    3. \n
  3. Kontakta support om problemet kvarstår
    4. \n
\n

Problem: Verktyg visas men fungerar inte

\n

Symptom

\n
    \n
  • Verktyg listade i klient
    • \n
  • Att anropa ett verktyg returnerar fel eller inget resultat
    • \n
\n

Lösningar

\n
    \n
  1. Kontrollera verktygsnamnet — måste vara exakt (t.ex. memory_recall, inte memory.recall)
    2. \n
  2. Verifiera argument — kontrollera verktygets indataschema
    3. \n
  3. Testa via direkt API:
    curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer mk_..." \\\n  -H "Content-Type: application/json" \\\n  -d '{"category":"fact","key":"test","content":"hello"}'
    4. \n
  4. Kontrollera Synapse-hälsa:
    curl https://synapse.schaefer.zone/health
    5. \n
\n

Få hjälp

\n

Om inget av ovanstående löser ert problem:

\n
    \n
  1. Kontrollera befintliga ärenden: https://gitlab.com/schaefer-services/synapse-mcp/-/issues
    2. \n
  2. Öppna ett nytt ärende med:
      \n
    • MCP-serverversion (npx -y synapse-mcp-api@latest --version)
      • \n
    • Klientnamn och version
      • \n
    • Operativsystem
      • \n
    • Relevanta loggutdrag
      • \n
    • Steg för att reproducera
      • \n
    \n
    3. \n
\n

Nästa steg

\n\n","urls":{"html":"/docs/mcp/troubleshooting","text":"/docs/mcp/troubleshooting?format=text","json":"/docs/mcp/troubleshooting?format=json","llm":"/docs/mcp/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"]}