# 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?](/docs/mcp/what-is-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?](/docs/mcp/what-is-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](/docs/mcp/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`:

```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](/docs/mcp/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](/docs/mcp/troubleshooting).

## 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](/docs/mcp/troubleshooting).

## 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ì:

```bash
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](/docs/mcp/custom-client).

## 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?](/docs/mcp/what-is-mcp)
- [Configurazione Claude Desktop](/docs/mcp/claude-desktop)
- [Troubleshooting MCP](/docs/mcp/troubleshooting)