MCP Academy · Lezione

L'handshake di inizializzazione

Scopra come client e server concordano su versione e funzionalità.

Lezione 3 di 413 passaggi

L'handshake di inizializzazione è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 3 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.

Le prime parole contano

Prima di eseguire qualsiasi strumento, client e server devono incontrarsi. Questo scambio iniziale è l'handshake initialize e non accade nient'altro finché non si conclude.

Il client parla per primo

L'handshake inizia sempre con il client che invia una richiesta initialize. Il server rimane in attesa e risponde solo dopo essere stato salutato.

{"jsonrpc": "2.0", "id": 0, "method": "initialize"}

Concordare una versione

Il client propone un protocolVersion, così entrambe le parti usano la stessa versione di MCP. Il server conferma nella risposta una versione supportata.

{"params": {"protocolVersion": "2025-06-18"}}

Dichiarare le funzionalità

Ogni parte elenca le proprie capabilities, ad esempio strumenti, risorse o sampling. In questo modo comunica all'altra parte quali funzionalità può usare in sicurezza.

{"capabilities": {"tools": {}, "resources": {}}}

Presentarsi

Il client invia anche clientInfo con il proprio nome e la propria versione. È come un piccolo biglietto da visita, che permette al server di sapere esattamente chi si è collegato.

{"clientInfo": {"name": "claude-desktop", "version": "1.0"}}

Il server risponde

Il server risponde con la versione scelta, le proprie capabilities e serverInfo. Ora entrambe le parti sanno che cosa può fare l'altra.

{"result": {"protocolVersion": "2025-06-18",
  "serverInfo": {"name": "my-server", "version": "0.1"}}}

Concludere l'accordo

Dopo la risposta, il client invia un ultimo messaggio notifications/initialized. Non contiene un id né richiede una risposta: segnala semplicemente che la configurazione è completa.

{"jsonrpc": "2.0", "method": "notifications/initialized"}

Solo allora inizia il lavoro vero

Finché non arriva la notifica initialized, il server dovrebbe rifiutare le altre chiamate. L'handshake controlla tutto ciò che segue.

Perché negoziare?

Versioni e funzionalità evolvono, quindi l'handshake permette a un client nuovo e a un server datato di negoziare un terreno comune invece di interrompersi a causa di un'incompatibilità.

Le funzionalità definiscono la sessione

Se il server non ha mai annunciato le resources, un client corretto non le richiederà. Le funzionalità dichiarate definiscono discretamente le regole dell'intera sessione.

L'handshake in tre battute

Ricordi il ritmo: il client invia initialize, il server risponde e il client conferma con initialized. Tre battute e la connessione è attiva.

Verifica rapida

Che cosa invia il client per completare l'handshake initialize?

Riepilogo: salutarsi

Ha seguito l'handshake dall'inizio alla fine: il client propone una versione e le funzionalità, il server conferma e una nota finale initialized apre la sessione al lavoro vero.

Gratis per iniziare

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 «L'handshake di inizializzazione» è gratuita?

Sì — il testo completo di «L'handshake di inizializzazione» è 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 «L'handshake di inizializzazione»?

Scopra come client e server concordano su versione e funzionalità. 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 3 di 4.

Quanto tempo richiede la lezione «L'handshake di inizializzazione»?

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

  1. Richieste, risposte e notifiche
  2. Anatomia di una chiamata JSON-RPC
  3. L'handshake di inizializzazione
  4. Leggere gli errori sul wire
← Torna a MCP Academy