{"title":"MCP in Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Colleghi Synapse a Claude Desktop in 2 minuti. Claude ottiene 79 strumenti Synapse in modo nativo.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":423,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# MCP in Claude Desktop\n\nClaude Desktop è l'app desktop di Anthropic per macOS e Windows. Con il\nserver MCP di Synapse configurato, Claude ottiene accesso nativo a tutti i 79\nstrumenti di Synapse — può memorizzare memorie, richiamarle, gestire attività,\nchattare e molto altro.\n\n## Prerequisiti\n\n- App Claude Desktop (macOS o Windows)\n- Node.js 18+ installato (`node --version`)\n- La propria Mind Key di Synapse\n\n## Passaggio 1: aprire il file di configurazione\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nSe il file non esiste, lo crei.\n\n## Passaggio 2: aggiungere il server MCP di Synapse\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> Se ha già altri server MCP configurati, aggiunga semplicemente il blocco\n> `\"synapse\"` all'interno dell'oggetto `\"mcpServers\"` esistente.\n\n## Passaggio 3: riavviare Claude Desktop\n\n1. Chiuda completamente Claude Desktop (Cmd+Q su macOS, non solo la finestra)\n2. Riapra Claude Desktop\n3. Inizi una nuova chat\n4. Cerchi l'icona della spina 🔌 in basso a sinistra — dovrebbe indicare \"79 tools\"\n\n## Passaggio 4: testare\n\nIn una nuova chat, digiti:\n\n```\nmemory_recall aufrufen\n```\n\nClaude dovrebbe richiamare lo strumento `memory_recall` e rispondere con un\nriassunto delle memorie memorizzate (oppure \"No memories yet\" se la mente è\nvuota).\n\n## Strumenti disponibili (selezione)\n\n| Strumento | Descrizione |\n|------|-------------|\n| `memory_recall` | Richiama tutte le memorie |\n| `memory_store` | Memorizza una nuova memoria |\n| `memory_search` | Cerca nelle memorie |\n| `task_list` | Elenca le attività |\n| `task_create` | Crea un'attività |\n| `chat_poll` | Controlla i nuovi messaggi |\n| `chat_reply` | Risponde a un messaggio |\n| `browser_new` | Apre una scheda del browser |\n| `computer_list` | Elenca i computer registrati |\n\nElenco completo: [Cos'è MCP?](/docs/mcp/what-is-mcp)\n\n## Risoluzione dei problemi\n\n### Nessuno strumento appare in Claude Desktop\n\n1. Verifichi la versione di Node.js: `node --version` (deve essere ≥ 18)\n2. Controlli che il file di configurazione sia JSON valido (nessuna virgola finale)\n3. Riavvii completamente Claude Desktop (Cmd+Q, non solo chiuda)\n4. Controlli i log di Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Errore \"Mind Key invalid\"\n\n- Verifichi che `SYNAPSE_MIND_KEY` inizi con `mk_`\n- Ottenga una nuova key tramite `POST /minds` (richiede JWT da `/login`)\n- Nessun apice attorno alla key nel JSON\n\n### npx non trovato\n\n- Installi Node.js 18+: \n- Riavvii il terminale dopo l'installazione\n- Su macOS con Homebrew: `brew install node`\n\n### Gli strumenti appaiono ma le chiamate falliscono\n\n- Controlli che `SYNAPSE_URL` sia raggiungibile: `curl https://synapse.schaefer.zone/health`\n- Verifichi che la Mind Key funzioni: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Veda [Risoluzione dei problemi MCP](/docs/mcp/troubleshooting)\n\n## Profili degli strumenti (risparmio token)\n\nSe sta usando un LLM più piccolo o vuole risparmiare token di contesto, imposti\nun profilo di strumenti:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nProfili: `minimal` (8 strumenti), `standard` (25), `full` (119, predefinito).\n\n## Prossimi passi\n\n- [Configurazione di Claude Code](/docs/mcp/claude-code)\n- [Configurazione di Cursor](/docs/mcp/cursor)\n- [Risoluzione dei problemi MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP in Claude Desktop

\n

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

\n

Prerequisiti

\n\n

Passaggio 1: aprire il file di configurazione

\n\n

Se il file non esiste, lo crei.

\n

Passaggio 2: aggiungere il server MCP di Synapse

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
Se ha già altri server MCP configurati, aggiunga semplicemente il blocco\n`\"synapse\"` all'interno dell'oggetto `\"mcpServers\"` esistente.

Passaggio 3: riavviare Claude Desktop

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

Passaggio 4: testare

\n

In una nuova chat, digiti:

\n
memory_recall aufrufen

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

\n

Strumenti disponibili (selezione)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
StrumentoDescrizione
memory_recallRichiama tutte le memorie
memory_storeMemorizza una nuova memoria
memory_searchCerca nelle memorie
task_listElenca le attività
task_createCrea un'attività
chat_pollControlla i nuovi messaggi
chat_replyRisponde a un messaggio
browser_newApre una scheda del browser
computer_listElenca i computer registrati
\n

Elenco completo: Cos'è MCP?

\n

Risoluzione dei problemi

\n

Nessuno strumento appare in Claude Desktop

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

Errore "Mind Key invalid"

\n\n

npx non trovato

\n\n

Gli strumenti appaiono ma le chiamate falliscono

\n\n

Profili degli strumenti (risparmio token)

\n

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

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

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

\n

Prossimi passi

\n\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}