{"title":"FAQ MCP","slug":"mcp-faq","category":"faq","summary":"Domande comuni sull'integrazione MCP — strumenti, transport, troubleshooting.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":455,"read_minutes":2,"lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# FAQ MCP\n\nDomande comuni sul server MCP di Synapse.\n\n## Cos'è MCP?\n\nMCP (Model Context Protocol) è uno standard aperto di Anthropic per\nl'integrazione LLM-strumento. Invece di incollare la documentazione API nei\nprompt, registra gli strumenti con un server MCP, e l'LLM li chiama come\nfunzioni native.\n\nVeda [Cos'è MCP?](/docs/mcp/what-is-mcp).\n\n## Quanti strumenti espone Synapse MCP?\n\n**79 strumenti** in 12 categorie: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.\n\nVeda [Cos'è MCP?](/docs/mcp/what-is-mcp) per la lista completa.\n\n## Quali client MCP sono supportati?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminale)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Qualsiasi client compatibile con MCP\n\nVeda [Configurazione Claude Desktop](/docs/mcp/claude-desktop) per esempi di\nconfigurazione.\n\n## Quali transport sono supportati?\n\n1. **stdio** (locale, consigliato per desktop)\n2. **HTTP/SSE** (remoto, multi-tenant)\n3. **WebSocket** (mobile, alto volume)\n\n## Come configuro Claude Desktop?\n\nModifichi `claude_desktop_config.json`:\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_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nVeda [Configurazione Claude Desktop](/docs/mcp/claude-desktop).\n\n## Perché gli strumenti non appaiono in Claude Desktop?\n\n1. **Riavvii completamente Claude Desktop** (Cmd+Q su macOS)\n2. **Verifichi che il file di configurazione sia JSON valido**\n3. **Verifichi Node.js 18+** installato\n4. **Controlli i log MCP**: `~/Library/Logs/Claude/mcp.log`\n\nVeda [Troubleshooting MCP](/docs/mcp/troubleshooting).\n\n## Come uso una mente diversa?\n\nCambii `SYNAPSE_MIND_KEY` nella sua configurazione MCP e riavvii il client.\n\nPer menti multiple, esegua più istanze del server MCP con Mind Key diverse.\n\n## Posso limitare quali strumenti vengono esposti?\n\nSì, usi i **Tool Profile**:\n\n- `minimal`: 8 strumenti compositi (~500 token)\n- `standard`: 25 strumenti (~2.500 token)\n- `full`: 119 strumenti (~8.250 token, predefinito)\n\nLo imposti tramite variabile env `MCP_PROFILE` o header `Mcp-Tool-Profile`.\n\n## Come faccio debug dei problemi MCP?\n\n1. **Esegua il server MCP manualmente**: `npx -y synapse-mcp-api@latest`\n2. **Controlli i log del client** (varia per client)\n3. **Verifichi che la Mind Key funzioni**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Verifichi la salute di Synapse**: `curl https://synapse.schaefer.zone/health`\n\nVeda [Troubleshooting MCP](/docs/mcp/troubleshooting).\n\n## Il server MCP è gratuito?\n\nSì. Il pacchetto npm `synapse-mcp-api` è open source. Il server MCP hosted su\n`synapse-mcp.schaefer.zone` è gratuito per uso pubblico.\n\n## Posso fare self-host del server MCP?\n\nSì:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## In cosa differisce MCP dalle chiamate API dirette?\n\n| Aspetto | API diretta | MCP |\n|--------|-----------|-----|\n| LLM deve conoscere | URL, header, auth | Solo nomi degli strumenti |\n| Gestione auth | Manuale | Automatica (variabile env) |\n| Scoperta strumenti | Legge /endpoints | Automatica tramite protocollo MCP |\n| Gestione errori | Manuale | Standardizzata |\n| Ideale per | Integrazioni personalizzate | Agenti LLM |\n\n## Posso costruire il mio client MCP?\n\nSì. Usi l'SDK MCP ufficiale:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nVeda [Client MCP personalizzato](/docs/mcp/custom-client).\n\n## Come segnalo bug MCP?\n\nApra un issue: \n\nIncluda:\n\n- Versione del server MCP\n- Nome e versione del client\n- Sistema operativo\n- Log rilevanti\n- Passaggi per riprodurre\n\n## Prossimi passi\n\n- [Cos'è MCP?](/docs/mcp/what-is-mcp)\n- [Configurazione Claude Desktop](/docs/mcp/claude-desktop)\n- [Troubleshooting MCP](/docs/mcp/troubleshooting)\n","content_html":"

FAQ MCP

\n

Domande comuni sul server MCP di Synapse.

\n

Cos'è MCP?

\n

MCP (Model Context Protocol) è uno standard aperto di Anthropic per\nl'integrazione LLM-strumento. Invece di incollare la documentazione API nei\nprompt, registra gli strumenti con un server MCP, e l'LLM li chiama come\nfunzioni native.

\n

Veda Cos'è MCP?.

\n

Quanti strumenti espone Synapse MCP?

\n

79 strumenti in 12 categorie: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.

\n

Veda Cos'è MCP? per la lista completa.

\n

Quali client MCP sono supportati?

\n\n

Veda Configurazione Claude Desktop per esempi di\nconfigurazione.

\n

Quali transport sono supportati?

\n
    \n
  1. stdio (locale, consigliato per desktop)
    2. \n
  2. HTTP/SSE (remoto, multi-tenant)
    3. \n
  3. WebSocket (mobile, alto volume)
    4. \n
\n

Come configuro Claude Desktop?

\n

Modifichi claude_desktop_config.json:

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

Veda Configurazione Claude Desktop.

\n

Perché gli strumenti non appaiono in Claude Desktop?

\n
    \n
  1. Riavvii completamente Claude Desktop (Cmd+Q su macOS)
    2. \n
  2. Verifichi che il file di configurazione sia JSON valido
    3. \n
  3. Verifichi Node.js 18+ installato
    4. \n
  4. Controlli i log MCP: ~/Library/Logs/Claude/mcp.log
    5. \n
\n

Veda Troubleshooting MCP.

\n

Come uso una mente diversa?

\n

Cambii SYNAPSE_MIND_KEY nella sua configurazione MCP e riavvii il client.

\n

Per menti multiple, esegua più istanze del server MCP con Mind Key diverse.

\n

Posso limitare quali strumenti vengono esposti?

\n

Sì, usi i Tool Profile:

\n\n

Lo imposti tramite variabile env MCP_PROFILE o header Mcp-Tool-Profile.

\n

Come faccio debug dei problemi MCP?

\n
    \n
  1. Esegua il server MCP manualmente: npx -y synapse-mcp-api@latest
    2. \n
  2. Controlli i log del client (varia per client)
    3. \n
  3. Verifichi che la Mind Key funzioni: curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. Verifichi la salute di Synapse: curl https://synapse.schaefer.zone/health
    5. \n
\n

Veda Troubleshooting MCP.

\n

Il server MCP è gratuito?

\n

Sì. Il pacchetto npm synapse-mcp-api è open source. Il server MCP hosted su\nsynapse-mcp.schaefer.zone è gratuito per uso pubblico.

\n

Posso fare self-host del server MCP?

\n

Sì:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

In cosa differisce MCP dalle chiamate API dirette?

\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
AspettoAPI direttaMCP
LLM deve conoscereURL, header, authSolo nomi degli strumenti
Gestione authManualeAutomatica (variabile env)
Scoperta strumentiLegge /endpointsAutomatica tramite protocollo MCP
Gestione erroriManualeStandardizzata
Ideale perIntegrazioni personalizzateAgenti LLM
\n

Posso costruire il mio client MCP?

\n

Sì. Usi l'SDK MCP ufficiale:

\n\n

Veda Client MCP personalizzato.

\n

Come segnalo bug MCP?

\n

Apra un issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

Includa:

\n\n

Prossimi passi

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