Come collegare server MCP a Claude Desktop

Server remoti: aggiungere un connettore personalizzato

Apri Claude Desktop, vai su Impostazioni, poi Connettori, e clicca su Aggiungi connettore personalizzato. Dagli un nome, incolla l'URL del server e conferma. I connettori personalizzati che usano MCP remoto sono disponibili sui piani Free, Pro, Max, Team ed Enterprise; un account Free è limitato a un connettore personalizzato. Sui piani Team ed Enterprise un proprietario dell'organizzazione aggiunge prima il connettore nelle impostazioni dell'organizzazione, poi i membri lo abilitano dalla propria pagina Connettori.

I server che supportano OAuth ti chiedono di accedere e approvare gli ambiti nel browser la prima volta che li usi; non serve altro. Una sezione facoltativa Impostazioni avanzate accetta un client ID e un client secret OAuth per i server che richiedono un client pre-registrato, cosa che la maggior parte dei server pubblici non richiede. Per il server di HostTracker l'URL è https://mcp.host-tracker.com/mcp; usa OAuth con registrazione dinamica del client, quindi il connettore mantiene solo gli ambiti che approvi tu, e non c'è alcuna chiave da incollare.

I connettori girano dal lato di Anthropic invece che sulla tua macchina, quindi non possono raggiungere un server sulla tua rete locale, e sono lo stesso meccanismo usato da claude.ai e Cowork. Il file di configurazione descritto di seguito è la controparte locale.

Server locali: modificare claude_desktop_config.json

Apri Impostazioni, scegli la scheda Sviluppatore, e clicca su Modifica configurazione. Questo apre il file di configurazione nel tuo editor, creandolo se non esiste ancora. Il file si trova in ~/Library/Application Support/Claude/claude_desktop_config.json su macOS e in %APPDATA%\Claude\claude_desktop_config.json su Windows; nella beta Linux, usa il pulsante Modifica configurazione invece di indovinare un percorso. Ogni server è una voce sotto mcpServers con il comando da avviare e i suoi argomenti:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Salva il file, poi chiudi completamente Claude Desktop e riavvialo; chiudere solo la finestra non basta, perché i server vengono avviati quando parte l'app. Su Windows il runtime da cui dipende il comando, per esempio Node.js per npx, deve essere installato e presente nel PATH che vede l'app desktop, quindi un server che funziona nel terminale ma non dall'app di solito è dovuto a una differenza di PATH.

Per vedere se un server si è caricato, clicca sull'icona "Aggiungi file, connettori e altro" in basso a sinistra nella casella dei messaggi, passa il mouse su Connettori e apri Gestisci connettori; il server è elencato lì con i suoi strumenti. La documentazione più vecchia chiama questa icona il martelletto, e la pagina di risoluzione dei problemi usa ancora quel nome in un titolo.

Estensioni dalla directory

Impostazioni, poi Estensioni, poi Sfoglia estensioni mostra una directory curata di server locali impacchettati come estensioni, che si installano con un solo clic e si aggiornano da soli. Un pacchetto scaricato si installa tramite Installa estensione scegliendo il file; questi pacchetti usano il formato .mcpb, che ha sostituito il precedente nome .dxt, e possono racchiudere server Node.js, Python o binari. I pacchetti distribuiti privatamente non si aggiornano da soli e vanno reinstallati a mano dopo una modifica.

Dove sono i log quando non compare nulla

Claude Desktop scrive un log di connessione generale e uno per ogni server. Su macOS si trovano in ~/Library/Logs/Claude/ come mcp.log e mcp-server-NOME.log; su Windows in %APPDATA%\Claude\logs. Il file specifico del server contiene l'output di errore proprio del server, dove viene indicato con precisione un modulo mancante, un percorso errato o una credenziale rifiutata. Se il file è vuoto, l'app non è mai riuscita ad avviare il comando, il che riporta di nuovo al PATH o a un errore di sintassi JSON nel file di configurazione.

Un'app, due superfici

Claude Desktop ora include una scheda Code che esegue Claude Code all'interno dell'applicazione, accanto alla scheda Chat. I server dichiarati in claude_desktop_config.json sono disponibili sia nella superficie di chat sia nelle sessioni locali della scheda Code, insieme a quelli di ~/.claude.json e al .mcp.json di un progetto; quando lo stesso nome esiste in entrambi i posti, la scheda Code usa la definizione del file desktop. Il Claude Code a riga di comando standalone non legge il file desktop. Se hai configurato i server prima nell'app desktop e vuoi averli nel terminale, claude mcp add-from-claude-desktop li importa su macOS e Windows Subsystem for Linux, come descritto in come aggiungere un server MCP a Claude Code.

Un server di monitoraggio remoto come primo connettore

Un server remoto è il modo più rapido per confermare che il flusso dei connettori funziona, perché non c'è nulla da installare e la risposta è verificabile. Aggiungi il server di HostTracker come connettore personalizzato, accedi quando richiesto, e chiedi a Claude se un sito che conosci è raggiungibile; la risposta dovrebbe citare un controllo eseguito dai punti di controllo di HostTracker in ubicazioni specifiche invece di indovinare. La pagina del server MCP elenca tutti i 65 strumenti e gli ambiti richiesti da ciascuno, dai controlli istantanei agli aggiornamenti delle pagine di stato.