# 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

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

> [!TIP]
> Se ha già altri server MCP configurati, aggiunga semplicemente il blocco
> `"synapse"` all'interno dell'oggetto `"mcpServers"` 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:

```
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)

| Strumento | Descrizione |
|------|-------------|
| `memory_recall` | Richiama tutte le memorie |
| `memory_store` | Memorizza una nuova memoria |
| `memory_search` | Cerca nelle memorie |
| `task_list` | Elenca le attività |
| `task_create` | Crea un'attività |
| `chat_poll` | Controlla i nuovi messaggi |
| `chat_reply` | Risponde a un messaggio |
| `browser_new` | Apre una scheda del browser |
| `computer_list` | Elenca i computer registrati |

Elenco completo: [Cos'è MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

## Profili degli strumenti (risparmio token)

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

```json
{
  "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](/docs/mcp/claude-code)
- [Configurazione di Cursor](/docs/mcp/cursor)
- [Risoluzione dei problemi MCP](/docs/mcp/troubleshooting)