MCP i Claude Desktop

Claude Desktop är Anthropics skrivbordsapp för macOS och Windows. Med Synapse MCP-server konfigurerad får Claude inbyggd åtkomst till alla 79 Synapse-verktyg — den kan lagra minnen, återkalla dem, hantera uppgifter, chatta med er och mer.

Förutsättningar

• Claude Desktop-app (macOS eller Windows)
• Node.js 18+ installerat (node --version)
• Er Synapse Mind Key

Steg 1: Öppna konfigurationsfilen

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Om filen inte finns, skapa den.

Steg 2: Lägg till Synapse MCP-server

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

Steg 3: Starta om Claude Desktop

1. Avsluta Claude Desktop helt (Cmd+Q på macOS, inte bara stäng fönstret)
2. Öppna Claude Desktop igen
3. Starta en ny chatt
4. Leta efter 🔌-pluggikonen nere till vänster — den bör visa "79 tools"

Steg 4: Testa det

I en ny chatt, skriv:

memory_recall aufrufen

Claude bör anropa verktyget memory_recall och svara med en sammanfattning av era lagrade minnen (eller "No memories yet" om er mind är tom).

Tillgängliga verktyg (urval)

Fullständig lista: Vad är MCP?

Felsökning

Inga verktyg visas i Claude Desktop

1. Verifiera Node.js-version: node --version (måste vara ≥ 18)
2. Kontrollera att konfigurationsfilen är giltig JSON (inga avslutande kommatecken)
3. Starta om Claude Desktop helt (Cmd+Q, inte bara stäng)
4. Kontrollera Claude Desktop-loggar: ~/Library/Logs/Claude/mcp.log (macOS)

"Mind Key invalid"-fel

• Verifiera att SYNAPSE_MIND_KEY börjar med mk_
• Hämta en ny nyckel via POST /minds (kräver JWT från /login)
• Inga citattecken runt nyckeln i JSON

npx hittades inte

• Installera Node.js 18+: https://nodejs.org/
• Starta om terminal efter installation
• På macOS med Homebrew: brew install node

Verktyg visas men anrop misslyckas

• Kontrollera att SYNAPSE_URL är nåbar: curl https://synapse.schaefer.zone/health
• Verifiera att er Mind Key fungerar: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Se MCP-felsökning

Verktygsprofiler (spara tokens)

Om ni använder en mindre LLM eller vill spara kontext-tokens, sätt en verktygsprofil:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone",
        "MCP_PROFILE": "standard"
      }
    }
  }
}

Profiler: minimal (8 verktyg), standard (25), full (119, standard).

Nästa steg

• Claude Code-konfiguration
• Cursor-konfiguration
• MCP-felsökning