MCP è lo standard di connessione fra Claude Desktop e i Suoi strumenti. Invece di dieci integrazioni proprietarie, applicazione e strumento parlano lo stesso protocollo, e Lei collega direttamente posta, calendario o filesystem invece di copiare e incollare.
Capire il file di configurazione
Un unico file determina quali server conosce Claude Desktop: claude_desktop_config.json. Su macOS si trova in ~/Library/Application Support/Claude, su Windows in %APPDATA%\Claude, su Linux in ~/.config/Claude.
Una voce per server, con nome, comando e argomenti. Facoltativamente variabili d’ambiente, facoltativamente un trasporto diverso. Dopo ogni modifica l’applicazione va riavviata completamente: su macOS non basta chiudere la finestra.
Prima di attivare, esegua un lint JSON. Basta una virgola mancante per far sparire l’intero elenco dei server.
Sei server con cui parto più spesso
Server filesystem. Claude legge e scrive in una cartella nettamente delimitata. Abiliti solo un percorso scelto esplicitamente.
Server GitHub o GitLab. Contesto del repository, pull request, issue: un account bot dedicato con permessi minimi è obbligatorio.
Server Notion o Confluence. Leggere e alimentare la base di conoscenza. Chiarisca prima i permessi sulle pagine, altrimenti Claude sovrascrive delle sezioni.
Server Gmail o Outlook. Cercare nella casella di posta e salvare bozze. Cominci in sola lettura; l’invio solo quando le regole sono chiare.
Server Google Drive o OneDrive. Riassumere PDF, interrogare fogli di calcolo, confrontare versioni. Non abiliti mai l’intero drive.
Server JIRA o Linear. Portare i ticket come contesto. Preferisca token di sola lettura; la scrittura solo per compiti ben delimitati.
Quando l’icona del martello resta vuota
Nella pratica quattro problemi coprono il 90 % dei casi.
Errore di sintassi JSON. Basta una virgola dimenticata o una parentesi doppia. Prima di salvare, passi il file in un linter JSON.
Percorso errato al file eseguibile. Usi percorsi assoluti, non relativi. Su macOS e Linux controlli i permessi di esecuzione.
Variabili d’ambiente mancanti. Token e percorsi vanno nel blocco env della configurazione del server. L’applicazione non si affida al profilo della shell.
Il server si blocca all’avvio. Controlli nel file di log se il processo è in attesa di un input. Causa frequente: un flusso OAuth interattivo da completare una volta.