# MCP-felsökning
SUMMARY: Lös vanliga MCP-integrationsproblem — server startar inte, verktyg visas inte, auth-fel.

KEY CONTEXT:
Common issues:
1. Node.js < 18 → upgrade to 18+
2. Mind Key invalid → check format (mk_...), get fresh via POST /minds
3. npx not found → install Node.js
4. Tools not appearing → restart client, check config JSON validity
5. SYNAPSE_URL unreachable → curl /health to verify
6. MCP server crashes → check logs, run npx manually to see error
Debug steps: run `npx -y synapse-mcp-api@latest` manually, check stderr
Logs: Claude Desktop ~/Library/Logs/Claude/mcp.log, Cursor ~/.cursor/logs/

MCP-felsökning
Vanliga problem och lösningar vid integration av Synapse MCP med er LLM-klient.
Snabb checklista för diagnostik
1. ✅ Node.js 18+ installerat? ()
2. ✅ Mind Key börjar med ? (inte JWT )
3. ✅ Synapse API nåbart? ()
4. ✅ Mind Key fungerar? ()
5. ✅ Konfigurationsfil är giltig JSON? (inga avslutande kommatecken, inga kommentarer)
6. ✅ Klient omstartad efter konfigurationsändring?
7. ✅ MCP-server startar manuellt? ()
Problem: Inga verktyg visas i klienten
Symptom
- Claude Desktop / Cursor / Continue visar 0 verktyg
- Ingen 🔌-ikon eller "synapse"-post i MCP-serverlista
Lösningar
1. Starta om klienten helt — Cmd+Q på macOS (inte bara stäng fönstret)
2. Kontrollera sökväg till konfigurationsfil:
   - Claude Desktop macOS: 
   - Claude Desktop Windows: 
   - Cursor: 
   - Continue: 
3. Validera JSON — klistra in konfiguration i <https://jsonlint.com>
4. Kontrollera klientloggar för MCP-fel:
   - Claude Desktop:  (macOS)
   - Cursor: View → Output → MCP
5. Kör MCP-server manuellt för att se startfel:
   [CODE BLOCK]
Problem: "Mind Key invalid"-fel
Symptom
- Verktyg visas men anrop misslyckas med "401 Unauthorized"
- Fel: "Mind Key fehlt oder ungültig"
Lösningar
1. Verifiera Mind Key-format — börjar med , 40 tecken
2. Testa direkt:
   [CODE BLOCK]
3. Kontrollera att miljövariabel är satt — för stdio-transport måste
   miljövariabeln vara i MCP-serverkonfigurationen, inte ert shell
4. Hämta en ny Mind Key:
   [CODE BLOCK]
Problem: npx hittades inte
Symptom
- Fel: "npx: command not found"
- MCP-server startar inte
Lösningar
1. Installera Node.js 18+:
   - macOS:  eller ladda ner från <https://nodejs.org>
   - Linux: 
   - Windows: ladda ner från <https://nodejs.org>
2. Starta om terminal efter installation
3. Verifiera: 
Problem: SYNAPSEURL onåbar
Symptom
- MCP-server startar men verktygsanrop time-outar
- Fel: "fetch failed" eller "ECONNREFUSED"
Lösningar
1. Testa anslutning:
   [CODE BLOCK]
2. Kontrollera företagsbrandvägg — kan blockera utgående HTTPS
3. Prova alternativ URL:
   - Produktion: 
   - MCP-server: 
4. För egenvärd: säkerställ att er Synapse-instans körs och är åtkomlig
Problem: MCP-server kraschar
Symptom
- MCP-server avslutas omedelbart efter start
- Klientloggar visar "MCP server disconnected"
Lösningar
1. Kör manuellt för att se fel:
   [CODE BLOCK]
2. Kontrollera portkonflikter — MCP-server använder port 13100 som standard
3. Rensa npx-cache:
   [CODE BLOCK]
4. Uppdatera till senaste:
   [CODE BLOCK]
Problem: Verktygsanrop returnerar 429
Symptom
- Fel: "Rate limit exceeded"
Lösningar
Detta bör inte hända med MCP (använder header-auth, ingen hastighetsgräns). Om det gör det:
1. Kontrollera om ni använder  nånstans — byt till header-auth
2. Verifiera  — säkerställ att den pekar på rätt instans
3. Kontakta support om problemet kvarstår
Problem: Verktyg visas men fungerar inte
Symptom
- Verktyg listade i klient
- Att anropa ett verktyg returnerar fel eller inget resultat
Lösningar
1. Kontrollera verktygsnamnet — måste vara exakt (t.ex. , inte )
2. Verifiera argument — kontrollera verktygets indataschema
3. Testa via direkt API:
   [CODE BLOCK]
4. Kontrollera Synapse-hälsa:
   [CODE BLOCK]
Få hjälp
Om inget av ovanstående löser ert problem:
1. Kontrollera befintliga ärenden: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>
2. Öppna ett nytt ärende med:
   - MCP-serverversion ()
   - Klientnamn och version
   - Operativsystem
   - Relevanta loggutdrag
   - Steg för att reproducera
Nästa steg
- Claude Desktop-konfiguration
- Claude Code-konfiguration
- API-fel