# MCP in Claude Desktop
SUMMARY: Colleghi Synapse a Claude Desktop in 2 minuti. Claude ottiene 79 strumenti Synapse in modo nativo.

KEY CONTEXT:
Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
             %APPDATA%\Claude\claude_desktop_config.json (Windows)
MCP server command: npx -y synapse-mcp-api@latest
Env vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)
After config: restart Claude Desktop, check for 🔌 icon with "79 tools"
Test: type "memory_recall aufrufen" in a new chat
Troubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting

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 ()
- La propria Mind Key di Synapse
Passaggio 1: aprire il file di configurazione
- macOS: 
- Windows: 
Se il file non esiste, lo crei.
Passaggio 2: aggiungere il server MCP di Synapse
[CODE BLOCK]
> [!TIP]
> Se ha già altri server MCP configurati, aggiunga semplicemente il blocco
>  all'interno dell'oggetto  esistente.
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:
[CODE BLOCK]
Claude dovrebbe richiamare lo strumento  e rispondere con un
riassunto delle memorie memorizzate (oppure "No memories yet" se la mente è
vuota).
Strumenti disponibili (selezione)
| Strumento | Descrizione |
|------|-------------|
|  | Richiama tutte le memorie |
|  | Memorizza una nuova memoria |
|  | Cerca nelle memorie |
|  | Elenca le attività |
|  | Crea un'attività |
|  | Controlla i nuovi messaggi |
|  | Risponde a un messaggio |
|  | Apre una scheda del browser |
|  | Elenca i computer registrati |
Elenco completo: Cos'è MCP?
Risoluzione dei problemi
Nessuno strumento appare in Claude Desktop
1. Verifichi la versione di Node.js:  (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:  (macOS)
Errore "Mind Key invalid"
- Verifichi che  inizi con 
- Ottenga una nuova key tramite  (richiede JWT da )
- 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: 
Gli strumenti appaiono ma le chiamate falliscono
- Controlli che  sia raggiungibile: 
- Verifichi che la Mind Key funzioni: 
- 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:
[CODE BLOCK]
Profili:  (8 strumenti),  (25),  (119, predefinito).
Prossimi passi
- Configurazione di Claude Code
- Configurazione di Cursor
- Risoluzione dei problemi MCP