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 claude_desktop_config.json:

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

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: ~/Library/Logs/Claude/mcp.log

Veda Troubleshooting MCP.

Come uso una mente diversa?

Cambii SYNAPSE_MIND_KEY 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:

• minimal: 8 strumenti compositi (~500 token)
• standard: 25 strumenti (~2.500 token)
• full: 119 strumenti (~8.250 token, predefinito)

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

Come faccio debug dei problemi MCP?

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

Veda Troubleshooting MCP.

Il server MCP è gratuito?

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

Posso fare self-host del server MCP?

Sì:

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

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: @modelcontextprotocol/sdk
• Python: mcp

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