Di cosa hai bisogno

  • Claude Desktop, l'app per computer (non la versione nel browser: i server locali si configurano nell'app desktop).
  • Node.js installato, il motore che esegue la maggior parte dei server. Si scarica gratis dal sito ufficiale.
  • Il server che vuoi collegare. Negli esempi qui sotto usiamo il server filesystem, che dà a Claude accesso a una cartella.

Come si fa

Il percorso è lo stesso su Windows e Mac; cambia solo dove l'app salva il file.

  1. Apri il file di configurazione dall'app. In Claude Desktop vai nelle Impostazioni e cerca la sezione per gli sviluppatori: da lì si apre (o si crea) il file claude_desktop_config.json nel tuo editor di testo. È il modo consigliato, così non devi cercarlo a mano nel computer.
  2. Aggiungi il server. La sintassi operativa:
{
  "mcpServers": {
    "documenti": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/tuonome/Documenti"]
    }
  }
}

mcpServers è il contenitore; documenti è il nome che dai tu al collegamento; l'ultimo valore è la cartella che Claude potrà vedere. Se hai già altri server, aggiungi questo dentro le stesse parentesi, separato da una virgola.

  1. Salva e riavvia Claude del tutto. Non basta chiudere la finestra: esci dall'app e riaprila, così rilegge la configurazione.
  2. Verifica. Nella casella di scrittura compare l'icona degli strumenti; aprila e controlla che il tuo server sia elencato. Oppure chiedi a Claude "che strumenti hai a disposizione?".

Esempio concreto

Anna vuole che Claude legga la cartella dove tiene le bozze dei suoi articoli. Apre le Impostazioni di Claude Desktop, entra nella sezione sviluppatore e fa aprire il file di configurazione. Incolla il blocco del server filesystem e cambia il percorso con quello della cartella bozze. Salva, esce da Claude e lo riapre.

Al riavvio vede comparire l'icona degli strumenti. Scrive: "leggi le bozze nella cartella e dimmi quale è la più completa". Claude apre i file da solo e risponde indicando il documento e perché. Anna non ha incollato nulla a mano: ha collegato la cartella una volta e ora Claude ci accede quando serve.

Quando NON funziona (e come rimediare)

Se dopo il riavvio non vedi il server

Quasi sempre è il file scritto male. Claude non carica un server se il JSON (il formato del file, fatto di parentesi e virgole) non è valido: una virgola in più o una parentesi mancante bastano. Copia il contenuto del file in una chat di Claude sul browser e chiedi "questo JSON è valido? correggilo".

Se Claude dice di non poter accedere alla cartella

Controlla il percorso: deve essere esatto. Su Mac assomiglia a /Users/nome/Documenti, su Windows a C:\\Users\\nome\\Documenti (con le doppie barre nel file). Se sbagli anche una lettera, il server parte ma non trova nulla. Copia il percorso direttamente dalle proprietà della cartella.

Se hai modificato il file ma non cambia niente

Hai dimenticato il riavvio completo. Claude legge la configurazione solo all'avvio: esci davvero dall'app (anche dall'icona in basso, se resta attiva) e riaprila.

Un consiglio da chi lo usa davvero

Prima di salvare modifiche importanti al file, copialo da qualche parte come backup. Un file di configurazione rotto impedisce a tutti i server di caricarsi, non solo a quello nuovo. Avere la versione che funzionava ti fa tornare indietro in dieci secondi invece di ricostruire tutto.

Domande frequenti

Posso collegare più server insieme a Claude Desktop?

Sì. Vanno tutti dentro mcpServers, ognuno con un nome diverso, separati da una virgola. Conviene aggiungerli uno alla volta e verificare che funzionino, così se qualcosa si rompe sai qual è la voce da correggere.

Devo rifare la configurazione a ogni aggiornamento di Claude?

No, il file resta. Gli aggiornamenti dell'app non cancellano i server che hai configurato. Se un giorno un server smette di funzionare, di solito è perché è cambiato lui, non Claude.

Serve il piano a pagamento di Claude per usare MCP?

I server MCP si configurano nell'app desktop e il protocollo è gratuito. Eventuali limiti dipendono dal tuo piano d'uso di Claude, non dal collegamento dei server in sé, che non ha un costo aggiuntivo.