Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Impara Configurazione e Test | Configurazione e Impostazione
Creazione di Agenti AI Personalizzati con Anthropic Claude

bookConfigurazione e Test

Una volta che lo script è pronto, il passo successivo è collegarlo a Claude. Questa operazione va eseguita solo una volta, anche se in seguito aggiorni lo script con nuove funzionalità. Per iniziare, apri Claude Desktop e vai alla scheda Impostazioni. Esistono diversi modi per accedervi:

Come aprire le Impostazioni
expand arrow
  • Fai clic sul menu hamburger nell'angolo in alto a sinistra, quindi vai su File > Impostazioni
  • Usa la scorciatoia Ctrl + ,
  • Oppure fai clic sull'icona del profilo nell'angolo in basso a sinistra e scegli Impostazioni

Una volta aperto il pannello Impostazioni, scorri fino in fondo. Vedrai una sezione Desktop App con tre schede disponibili solo nella versione desktop: Generale, Estensioni e Sviluppatore. Per configurare la connessione al server MCP, seleziona la scheda Sviluppatore. All'interno della scheda Sviluppatore, fai clic su Modifica Configurazione. Questo apre la cartella in cui sono archiviati i file di configurazione di Claude e evidenzia il file claude-desktop-config.json. Al suo interno troverai qualcosa di simile a questo:

claude-desktop-config.json

claude-desktop-config.json

copy

Questo è semplicemente un file JSON. La chiave "mcpServers" è il punto in cui Claude cerca le informazioni sui server a cui deve connettersi. Attualmente è vuota. Per aggiungere un server, inserire una nuova coppia chiave-valore all'interno delle parentesi graffe. La chiave può essere qualsiasi nome desiderato e verrà utilizzata per etichettare il server all'interno di Claude. Successivamente, aggiungere un oggetto {} che conterrà la configurazione del server.

claude-desktop-config.json

claude-desktop-config.json

copy
Note
Nota

Se desideri approfondire il formato JSON, puoi consultare l'articolo Understanding and Working with JSON Data.

Se apri Claude ora, riceverai un avviso. Questo è normale: significa che Claude ha trovato il tuo server, ma manca delle informazioni richieste. In particolare, Claude sta cercando la chiave "command", che indica come eseguire il server. Per fare in modo che Claude esegua effettivamente il tuo script, devi fornire lo stesso comando che useresti nel terminale. Per gli script Python, solitamente è python.

L'ultimo passaggio consiste nell'aggiungere la chiave "args". Si tratta di un elenco di input aggiuntivi che Claude utilizzerà con il comando — nella maggior parte dei casi, è semplicemente il percorso completo del tuo script:

file1

file1

copy
Note
Nota

Assicurati che il percorso e il nome del file siano corretti, altrimenti Claude non sarà in grado di eseguire il tuo script. Se preferisci non scrivere tutto da solo, puoi copiare e incollare questo come modello.

Una volta salvato il file, riapri Claude e torna alla scheda Sviluppatore. Questa volta, il tuo server dovrebbe essere contrassegnato come In esecuzione. Ora puoi provarlo inviando un prompt come il seguente.

Claude chiederà il permesso di utilizzare il tuo server MCP. Puoi cliccare su Consenti una volta per testarlo in sicurezza, oppure su Consenti sempre se si tratta del tuo server e ti fidi. Se tutto è configurato correttamente, Claude chiamerà il tuo strumento e restituirà il risultato — in questo caso, l'ora corrente.

question mark

Qual è lo scopo della chiave command nel file claude-desktop-config.json?

Select the correct answer

Tutto è chiaro?

Come possiamo migliorarlo?

Grazie per i tuoi commenti!

Sezione 2. Capitolo 4

Chieda ad AI

expand

Chieda ad AI

ChatGPT

Chieda pure quello che desidera o provi una delle domande suggerite per iniziare la nostra conversazione

Awesome!

Completion rate improved to 11.11

bookConfigurazione e Test

Scorri per mostrare il menu

Una volta che lo script è pronto, il passo successivo è collegarlo a Claude. Questa operazione va eseguita solo una volta, anche se in seguito aggiorni lo script con nuove funzionalità. Per iniziare, apri Claude Desktop e vai alla scheda Impostazioni. Esistono diversi modi per accedervi:

Come aprire le Impostazioni
expand arrow
  • Fai clic sul menu hamburger nell'angolo in alto a sinistra, quindi vai su File > Impostazioni
  • Usa la scorciatoia Ctrl + ,
  • Oppure fai clic sull'icona del profilo nell'angolo in basso a sinistra e scegli Impostazioni

Una volta aperto il pannello Impostazioni, scorri fino in fondo. Vedrai una sezione Desktop App con tre schede disponibili solo nella versione desktop: Generale, Estensioni e Sviluppatore. Per configurare la connessione al server MCP, seleziona la scheda Sviluppatore. All'interno della scheda Sviluppatore, fai clic su Modifica Configurazione. Questo apre la cartella in cui sono archiviati i file di configurazione di Claude e evidenzia il file claude-desktop-config.json. Al suo interno troverai qualcosa di simile a questo:

claude-desktop-config.json

claude-desktop-config.json

copy

Questo è semplicemente un file JSON. La chiave "mcpServers" è il punto in cui Claude cerca le informazioni sui server a cui deve connettersi. Attualmente è vuota. Per aggiungere un server, inserire una nuova coppia chiave-valore all'interno delle parentesi graffe. La chiave può essere qualsiasi nome desiderato e verrà utilizzata per etichettare il server all'interno di Claude. Successivamente, aggiungere un oggetto {} che conterrà la configurazione del server.

claude-desktop-config.json

claude-desktop-config.json

copy
Note
Nota

Se desideri approfondire il formato JSON, puoi consultare l'articolo Understanding and Working with JSON Data.

Se apri Claude ora, riceverai un avviso. Questo è normale: significa che Claude ha trovato il tuo server, ma manca delle informazioni richieste. In particolare, Claude sta cercando la chiave "command", che indica come eseguire il server. Per fare in modo che Claude esegua effettivamente il tuo script, devi fornire lo stesso comando che useresti nel terminale. Per gli script Python, solitamente è python.

L'ultimo passaggio consiste nell'aggiungere la chiave "args". Si tratta di un elenco di input aggiuntivi che Claude utilizzerà con il comando — nella maggior parte dei casi, è semplicemente il percorso completo del tuo script:

file1

file1

copy
Note
Nota

Assicurati che il percorso e il nome del file siano corretti, altrimenti Claude non sarà in grado di eseguire il tuo script. Se preferisci non scrivere tutto da solo, puoi copiare e incollare questo come modello.

Una volta salvato il file, riapri Claude e torna alla scheda Sviluppatore. Questa volta, il tuo server dovrebbe essere contrassegnato come In esecuzione. Ora puoi provarlo inviando un prompt come il seguente.

Claude chiederà il permesso di utilizzare il tuo server MCP. Puoi cliccare su Consenti una volta per testarlo in sicurezza, oppure su Consenti sempre se si tratta del tuo server e ti fidi. Se tutto è configurato correttamente, Claude chiamerà il tuo strumento e restituirà il risultato — in questo caso, l'ora corrente.

question mark

Qual è lo scopo della chiave command nel file claude-desktop-config.json?

Select the correct answer

Tutto è chiaro?

Come possiamo migliorarlo?

Grazie per i tuoi commenti!

Sezione 2. Capitolo 4
some-alt