Collegarlo a Claude Desktop
Modifichi la configurazione affinché Claude carichi il Suo server.
Collegarlo a Claude Desktop è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Dallo script a un host reale
Il server è in esecuzione, ma nessuno comunica ancora con lui. Colleghiamolo a un host reale: Claude Desktop. 🖥️
Legge un file di configurazione
Claude Desktop individua i server in un unico file JSON chiamato claude_desktop_config.json. Inserisca lì ogni server e l'applicazione li caricherà all'avvio.
Dove si trova il file
Su macOS il file si trova in Application Support; su Windows si trova nella cartella AppData roaming. Lo apra dalle impostazioni dell'applicazione.
~/Library/Application Support/Claude/claude_desktop_config.jsonLa chiave mcpServers
Ogni server va inserito nell'oggetto mcpServers di primo livello. Ogni chiave è il nome scelto da Lei; il valore descrive come avviarlo.
{
"mcpServers": {}
}Comando e argomenti
Per ogni server deve specificare un command da eseguire e un array di args. Insieme definiscono esattamente come l'host avvia il processo.
{
"weather": {
"command": "python",
"args": ["/abs/path/server.py"]
}
}Usare percorsi assoluti
L'host avvia il processo dalla propria directory di lavoro, quindi i percorsi relativi non funzionano. Indichi sempre negli args un percorso assoluto per lo script.
uv semplifica tutto
Se il progetto usa uv, imposti il comando su uv e lasci che esegua il modulo nell'ambiente corretto, senza bisogno di un'installazione globale.
{
"command": "uv",
"args": ["run", "server.py"]
}Passare le variabili d'ambiente
I segreti, come le chiavi API, vanno inseriti in un oggetto env facoltativo. L'host li passa all'avvio del server, così non finiscono nel codice.
"env": { "API_KEY": "sk-..." }Riavviare per applicare le modifiche
Claude legge la configurazione solo all'avvio. Dopo ogni modifica deve riavviare completamente l'applicazione affinché rilevi il nuovo server.
L'icona del martello
Quando tutto funziona, nella chat appare un piccolo indicatore degli strumenti. Facendovi clic, vedrà gli strumenti che il server offre ora a Claude. 🔨
Scegliere con cura il nome
La chiave scelta in mcpServers diventa il nome del server. Lo mantenga breve e univoco, così più server non entreranno mai in conflitto nell'host.
Controllo rapido
Quale modifica deve apportare a Claude Desktop prima che carichi un server appena aggiunto?
Riepilogo
Ha aggiunto il server a claude_desktop_config.json con command, args ed env, ha usato percorsi assoluti e ha riavviato l'applicazione. Ora è attivo in Claude! ✅
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Collegarlo a Claude Desktop» è gratuita?
Sì — il testo completo di «Collegarlo a Claude Desktop» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Collegarlo a Claude Desktop»?
Modifichi la configurazione affinché Claude carichi il Suo server. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Collegarlo a Claude Desktop»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Come funziona il trasporto stdio
- Collegarlo a Claude Desktop
- Esplorare con MCP Inspector
- Eseguire il debug di un server che non si avvia