# FAQ MCP
SUMMARY: Domande comuni sull'integrazione MCP — strumenti, transport, troubleshooting.

FAQ MCP
Domande comuni sul server MCP di Synapse.
Cos'è MCP?
MCP (Model Context Protocol) è uno standard aperto di Anthropic per
l'integrazione LLM-strumento. Invece di incollare la documentazione API nei
prompt, registra gli strumenti con un server MCP, e l'LLM li chiama come
funzioni native.
Veda Cos'è MCP?.
Quanti strumenti espone Synapse MCP?
79 strumenti in 12 categorie: memory, chat, scheduler, tasks, scripts,
computers, push, user, utility, visualization, sharing, webhooks, browser.
Veda Cos'è MCP? per la lista completa.
Quali client MCP sono supportati?
- Claude Desktop (macOS, Windows)
- Claude Code (terminale)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Qualsiasi client compatibile con MCP
Veda Configurazione Claude Desktop per esempi di
configurazione.
Quali transport sono supportati?
1. stdio (locale, consigliato per desktop)
2. HTTP/SSE (remoto, multi-tenant)
3. WebSocket (mobile, alto volume)
Come configuro Claude Desktop?
Modifichi :
[CODE BLOCK]
Veda Configurazione Claude Desktop.
Perché gli strumenti non appaiono in Claude Desktop?
1. Riavvii completamente Claude Desktop (Cmd+Q su macOS)
2. Verifichi che il file di configurazione sia JSON valido
3. Verifichi Node.js 18+ installato
4. Controlli i log MCP: 
Veda Troubleshooting MCP.
Come uso una mente diversa?
Cambii  nella sua configurazione MCP e riavvii il client.
Per menti multiple, esegua più istanze del server MCP con Mind Key diverse.
Posso limitare quali strumenti vengono esposti?
Sì, usi i Tool Profile:
- : 8 strumenti compositi (500 token)
- : 25 strumenti (2.500 token)
- : 119 strumenti (8.250 token, predefinito)
Lo imposti tramite variabile env  o header .
Come faccio debug dei problemi MCP?
1. Esegua il server MCP manualmente: 
2. Controlli i log del client (varia per client)
3. Verifichi che la Mind Key funzioni: 
4. Verifichi la salute di Synapse: 
Veda Troubleshooting MCP.
Il server MCP è gratuito?
Sì. Il pacchetto npm  è open source. Il server MCP hosted su
 è gratuito per uso pubblico.
Posso fare self-host del server MCP?
Sì:
[CODE BLOCK]
In cosa differisce MCP dalle chiamate API dirette?
| Aspetto | API diretta | MCP |
|--------|-----------|-----|
| LLM deve conoscere | URL, header, auth | Solo nomi degli strumenti |
| Gestione auth | Manuale | Automatica (variabile env) |
| Scoperta strumenti | Legge /endpoints | Automatica tramite protocollo MCP |
| Gestione errori | Manuale | Standardizzata |
| Ideale per | Integrazioni personalizzate | Agenti LLM |
Posso costruire il mio client MCP?
Sì. Usi l'SDK MCP ufficiale:
- TypeScript: 
- Python: 
Veda Client MCP personalizzato.
Come segnalo bug MCP?
Apra un issue: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>
Includa:
- Versione del server MCP
- Nome e versione del client
- Sistema operativo
- Log rilevanti
- Passaggi per riprodurre
Prossimi passi
- Cos'è MCP?
- Configurazione Claude Desktop
- Troubleshooting MCP