MCP in Claude Desktop

Claude Desktop è l'app desktop di Anthropic per macOS e Windows. Con il server MCP di Synapse configurato, Claude ottiene accesso nativo a tutti i 79 strumenti di Synapse — può memorizzare memorie, richiamarle, gestire attività, chattare e molto altro.

Prerequisiti

• App Claude Desktop (macOS o Windows)
• Node.js 18+ installato (node --version)
• La propria Mind Key di Synapse

Passaggio 1: aprire il file di configurazione

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

Se il file non esiste, lo crei.

Passaggio 2: aggiungere il server MCP di Synapse

{
  "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"
      }
    }
  }
}

Passaggio 3: riavviare Claude Desktop

1. Chiuda completamente Claude Desktop (Cmd+Q su macOS, non solo la finestra)
2. Riapra Claude Desktop
3. Inizi una nuova chat
4. Cerchi l'icona della spina 🔌 in basso a sinistra — dovrebbe indicare "79 tools"

Passaggio 4: testare

In una nuova chat, digiti:

memory_recall aufrufen

Claude dovrebbe richiamare lo strumento memory_recall e rispondere con un riassunto delle memorie memorizzate (oppure "No memories yet" se la mente è vuota).

Strumenti disponibili (selezione)

Elenco completo: Cos'è MCP?

Risoluzione dei problemi

Nessuno strumento appare in Claude Desktop

1. Verifichi la versione di Node.js: node --version (deve essere ≥ 18)
2. Controlli che il file di configurazione sia JSON valido (nessuna virgola finale)
3. Riavvii completamente Claude Desktop (Cmd+Q, non solo chiuda)
4. Controlli i log di Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)

Errore "Mind Key invalid"

• Verifichi che SYNAPSE_MIND_KEY inizi con mk_
• Ottenga una nuova key tramite POST /minds (richiede JWT da /login)
• Nessun apice attorno alla key nel JSON

npx non trovato

• Installi Node.js 18+: https://nodejs.org/
• Riavvii il terminale dopo l'installazione
• Su macOS con Homebrew: brew install node

Gli strumenti appaiono ma le chiamate falliscono

• Controlli che SYNAPSE_URL sia raggiungibile: curl https://synapse.schaefer.zone/health
• Verifichi che la Mind Key funzioni: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Veda Risoluzione dei problemi MCP

Profili degli strumenti (risparmio token)

Se sta usando un LLM più piccolo o vuole risparmiare token di contesto, imposti un profilo di strumenti:

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

Profili: minimal (8 strumenti), standard (25), full (119, predefinito).

Prossimi passi

• Configurazione di Claude Code
• Configurazione di Cursor
• Risoluzione dei problemi MCP