Follow these steps to get started using these resources:
- Crea un Fork del Repository: Click
- Clona il Repository:
git clone https://github.com/microsoft/mcp-for-beginners.git - Unisciti a
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Preferisci Clonare Localmente?
Questo repository include traduzioni in oltre 50 lingue, che aumentano significativamente la dimensione del download. Per clonare senza traduzioni, usa il sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Questo ti darà tutto il necessario per completare il corso con un download molto più veloce.
Benvenuto nel tuo viaggio nel Model Context Protocol! Se ti sei mai chiesto come le applicazioni AI comunicano con diversi strumenti e servizi, stai per scoprire la soluzione elegante che sta trasformando il modo in cui gli sviluppatori costruiscono sistemi intelligenti.
Pensa a MCP come a un traduttore universale per le applicazioni AI - proprio come le porte USB ti permettono di collegare qualsiasi dispositivo al tuo computer, MCP permette ai modelli AI di connettersi a qualsiasi strumento o servizio in modo standardizzato. Che tu stia costruendo il tuo primo chatbot o lavorando su flussi di lavoro AI complessi, comprendere MCP ti darà il potere di creare applicazioni più potenti e flessibili.
Questo curriculum è progettato con pazienza e cura per il tuo percorso di apprendimento. Inizieremo con concetti semplici che già conosci e costruiremo gradualmente la tua competenza tramite pratica diretta nel tuo linguaggio di programmazione preferito. Ogni passaggio include spiegazioni chiare, esempi pratici e tanto incoraggiamento lungo la strada.
Quando terminerai questo percorso, avrai la sicurezza di costruire i tuoi server MCP, integrarli con piattaforme AI popolari e capire come questa tecnologia stia rimodellando il futuro dello sviluppo AI. Iniziamo questa avventura entusiasmante insieme!
Questo curriculum è allineato con la Specificazione MCP 2025-11-25 (l'ultima versione stabile). La specifica MCP usa versioni basate sulla data (formato YYYY-MM-DD) per assicurare un tracciamento chiaro delle versioni del protocollo.
Queste risorse diventeranno più preziose man mano che la tua comprensione crescerà, ma non sentirti sotto pressione di leggere tutto subito. Inizia dalle aree che ti interessano di più!
- 📘 Documentazione MCP – Questa è la tua risorsa principale per tutorial passo-passo e guide per l’utente. La documentazione è scritta pensando ai principianti, con esempi chiari che puoi seguire al tuo ritmo.
- 📜 Specificazione MCP – Considerala come il tuo manuale di riferimento completo. Durante il percorso, vi tornerai spesso per consultare dettagli specifici ed esplorare funzionalità avanzate.
- 📜 Versionamento Specifica MCP – Contiene informazioni sulla cronologia delle versioni del protocollo e come MCP usa il versionamento basato sulla data (formato YYYY-MM-DD).
- 🧑💻 Repository GitHub MCP – Qui troverai SDK, strumenti ed esempi di codice in diversi linguaggi di programmazione. È come una miniera di esempi pratici e componenti pronti all’uso.
- 🌐 Comunità MCP – Unisciti ad altri studenti e sviluppatori esperti nelle discussioni su MCP. È una comunità di supporto dove le domande sono benvenute e la conoscenza viene condivisa liberamente.
Al termine di questo curriculum, ti sentirai sicuro ed entusiasta delle tue nuove competenze. Ecco cosa raggiungerai:
• Comprendere i fondamenti di MCP: Capirai cos’è il Model Context Protocol e perché sta rivoluzionando come le applicazioni AI collaborano, usando analogie ed esempi che hanno senso.
• Costruire il tuo primo server MCP: Creerai un server MCP funzionante nel tuo linguaggio di programmazione preferito, partendo da esempi semplici e sviluppando le tue abilità passo dopo passo.
• Collegare modelli AI a strumenti reali: Imparerai a colmare il divario tra modelli AI e servizi effettivi, donando alle tue applicazioni nuove capacità potenti.
• Implementare le migliori pratiche di sicurezza: Capirai come mantenere sicure le tue implementazioni MCP, proteggendo sia le tue applicazioni che gli utenti.
• Distribuire con fiducia: Saprai come portare i tuoi progetti MCP dalla fase di sviluppo a quella di produzione, con strategie pratiche che funzionano nel mondo reale.
• Entrare a far parte della comunità MCP: Diventerai parte di una comunità in crescita di sviluppatori che stanno plasmando il futuro dello sviluppo di applicazioni AI.
Prima di addentrarci nei dettagli di MCP, assicuriamoci che tu ti senta a tuo agio con alcuni concetti fondamentali. Non preoccuparti se non sei un esperto in queste aree - spiegheremo tutto ciò che devi sapere lungo il percorso!
Pensa a un protocollo come alle regole per una conversazione. Quando chiami un amico, entrambi sapete di dire "ciao" quando rispondete, di parlare a turno e di dire "arrivederci" quando avete finito. Anche i programmi per computer hanno bisogno di regole simili per comunicare efficacemente.
MCP è un protocollo - un insieme di regole condivise che aiutano modelli AI e applicazioni a "conversare" in modo produttivo con strumenti e servizi. Proprio come avere regole per la conversazione rende la comunicazione tra umani più fluida, avere MCP rende la comunicazione delle applicazioni AI molto più affidabile e potente.
Usi già ogni giorno relazioni client-server! Quando usi un browser web (il client) per visitare un sito, ti connetti a un server web che ti invia il contenuto della pagina. Il browser sa come chiedere informazioni, e il server sa come rispondere.
In MCP, abbiamo una relazione simile: i modelli AI agiscono come client che richiedono informazioni o azioni, mentre i server MCP offrono queste capacità. È come avere un assistente utile (il server) a cui l’AI può chiedere di eseguire compiti specifici.
Immagina se ogni casa automobilistica usasse forme diverse per i distributori di benzina - avresti bisogno di un adattatore diverso per ogni auto! La standardizzazione significa accordarsi su approcci comuni per far funzionare tutto insieme senza problemi.
MCP fornisce questa standardizzazione per le applicazioni AI. Invece di dover scrivere codice personalizzato per ogni modello AI che deve lavorare con ogni strumento, MCP crea un modo universale per comunicare. Questo significa che gli sviluppatori possono costruire uno strumento una sola volta e farlo funzionare con molti sistemi AI diversi.
Il tuo viaggio MCP è strutturato attentamente per costruire fiducia e competenze in modo progressivo. Ogni fase introduce nuovi concetti mentre rinforza quelli già appresi.
Qui inizia la tua avventura! Ti introdurremo ai concetti MCP usando analogie familiari ed esempi semplici. Capirai cos’è MCP, perché esiste e come si inserisce nel mondo più ampio dello sviluppo AI.
• Modulo 0 - Introduzione a MCP: Inizieremo esplorando cos’è MCP e perché è così importante per le applicazioni AI moderne. Vedrai esempi reali di MCP in azione e capirai come risolve problemi comuni che gli sviluppatori incontrano.
• Modulo 1 - Concetti Core Spiegati: Qui imparerai gli elementi essenziali di MCP. Useremo molte analogie ed esempi visivi per assicurarti che questi concetti risultino naturali e comprensibili.
• Modulo 2 - Sicurezza in MCP: La sicurezza può sembrare intimidatoria, ma ti mostreremo come MCP include funzioni di sicurezza integrate e ti insegneremo le migliori pratiche per proteggere le tue applicazioni fin dall’inizio.
Adesso inizia il vero divertimento! Avrai esperienza pratica nella creazione di server e client MCP reali. Non preoccuparti - partiremo con cose semplici e ti guideremo passo dopo passo.
Questo modulo include più guide pratiche che ti permettono di esercitarti nel linguaggio di programmazione che preferisci. Creerai il tuo primo server, costruirai un client per collegarti a esso, e integrerai anche strumenti di sviluppo popolari come VS Code.
Ogni guida include esempi di codice completi, suggerimenti per la risoluzione dei problemi e spiegazioni sul perché facciamo determinate scelte progettuali. Alla fine di questa fase, avrai implementazioni MCP funzionanti di cui potrai andare fiero!
Con le basi padroneggiate, sei pronto a esplorare funzionalità MCP più sofisticate. Tratteremo strategie pratiche di implementazione, tecniche di debug e argomenti avanzati come l'integrazione di AI multimodale.
Imparerai anche come scalare le tue implementazioni MCP per l'uso in produzione e integrarti con piattaforme cloud come Azure. Questi moduli ti preparano a costruire soluzioni MCP che possono gestire le esigenze del mondo reale.
La fase finale si concentra sull'unirti alla comunità MCP e specializzarti nelle aree che più ti interessano. Imparerai come contribuire a progetti MCP open-source, implementare schemi avanzati di autenticazione e costruire soluzioni complete integrate con database.
Il modulo 11 merita una menzione speciale - è un percorso di apprendimento pratico completo di 13 laboratori che ti insegna a costruire server MCP pronti per la produzione con integrazione PostgreSQL. È come un progetto finale che unisce tutto ciò che hai imparato!
| Modulo | Argomento | Descrizione | Link |
|---|---|---|---|
| Modulo 0-3: Fondamenti | |||
| 00 | Introduzione a MCP | Panoramica del Model Context Protocol e la sua importanza nelle pipeline AI | Leggi di più |
| 01 | Concetti Fondamentali Spiegati | Esplorazione approfondita dei concetti base di MCP | Leggi di più |
| 02 | Sicurezza in MCP | Minacce alla sicurezza e migliori pratiche | Leggi di più |
| 03 | Introduzione a MCP | Configurazione dell’ambiente, server/client base, integrazione | Leggi di più |
| Modulo 3: Costruire il Tuo Primo Server & Client | |||
| 3.1 | Primo Server | Crea il tuo primo server MCP | Guida |
| 3.2 | Primo Client | Sviluppa un client MCP di base | Guida |
| 3.3 | Client con LLM | Integra modelli linguistici di grandi dimensioni | Guida |
| 3.4 | Integrazione VS Code | Usa server MCP in VS Code | Guida |
| 3.5 | Server stdio | Crea server usando il trasporto stdio | Guida |
| 3.6 | Streaming HTTP | Implementa lo streaming HTTP in MCP | Guida |
| 3.7 | AI Toolkit | Usa AI Toolkit con MCP | Guida |
| 3.8 | Testing | Testa la tua implementazione del server MCP | Guida |
| 3.9 | Deployment | Distribuisci server MCP in produzione | Guida |
| 3.10 | Uso avanzato del server | Usa server avanzati per funzionalità avanzate e migliorare l’architettura | Guida |
| 3.11 | Autenticazione semplice | Capitolo che illustra l’autenticazione dall’inizio e RBAC | Guida |
| 3.12 | Host MCP | Configura Claude Desktop, Cursor, Cline e altri host MCP | Guida |
| 3.13 | MCP Inspector | Debug e test dei server MCP con lo strumento Inspector | Guida |
| 3.14 | Campionamento | Usa il campionamento per collaborare con il client | Guida |
| 3.15 | App MCP | Costruisci App MCP | Guida |
| Modulo 4-5: Pratico & Avanzato | |||
| 04 | Implementazione Pratica | SDK, debug, testing, template di prompt riutilizzabili | Leggi di più |
| 4.1 | Paginazione | Gestisci grandi insiemi di risultati con paginazione basata su cursore | Guida |
| 05 | Argomenti Avanzati in MCP | AI multimodale, scalabilità, uso enterprise | Leggi di più |
| 5.1 | Integrazione Azure | Integrazione MCP con Azure | Guida |
| 5.2 | Multimodalità | Lavorare con modalità multiple | Guida |
| 5.3 | Demo OAuth2 | Implementazione dell’autenticazione OAuth2 | Guida |
| 5.4 | Contesti Radice | Comprendere e implementare contesti radice | Guida |
| 5.5 | Routing | Strategie di routing MCP | Guida |
| 5.6 | Campionamento | Tecniche di campionamento in MCP | Guida |
| 5.7 | Scalabilità | Scala implementazioni MCP | Guida |
| 5.8 | Sicurezza | Considerazioni avanzate sulla sicurezza | Guida |
| 5.9 | Ricerca Web | Implementa capacità di ricerca sul web | Guida |
| 5.10 | Streaming in tempo reale | Costruisci funzionalità di streaming in tempo reale | Guida |
| 5.11 | Ricerca in tempo reale | Implementa ricerca in tempo reale | Guida |
| 5.12 | Autenticazione Entra ID | Autenticazione con Microsoft Entra ID | Guida |
| 5.13 | Integrazione Foundry | Integra con Azure AI Foundry | Guida |
| 5.14 | Ingegneria del Contesto | Tecniche per un’efficace ingegneria del contesto | Guida |
| 5.15 | Trasporto Personalizzato MCP | Implementazioni di trasporto personalizzate | Guida |
| 5.16 | Funzionalità del Protocollo | Notifiche di progresso, cancellazione, template di risorse | Guida |
| 5.17 | Ragionamento Multi-Agente Avversario | Due agenti discutono posizioni opposte usando strumenti MCP condivisi, valutati da un agente giudice | Guida |
| Modulo 6-10: Comunità & Best Practices | |||
| 06 | Contributi della Comunità | Come contribuire all’ecosistema MCP | Guida |
| 07 | Insights dall’Adozione Iniziale | Storie di implementazioni nel mondo reale | Guida |
| 08 | Best Practices per MCP | Performance, tolleranza ai guasti, resilienza | Guida |
| 09 | Studi di Caso MCP | Esempi pratici di implementazione | Guida |
| 10 | Laboratorio Pratico | Costruire un Server MCP con AI Toolkit | Lab |
| Modulo 11: Laboratorio Pratico Server MCP | |||
| 11 | Integrazione Database Server MCP | Completo percorso pratico di 13 laboratori per integrazione con PostgreSQL | Lab |
| 11.1 | Introduzione | Panoramica di MCP con integrazione database e caso d’uso retail analytics | Lab 00 |
| 11.2 | Architettura Core | Comprendere l’architettura dei server MCP, livelli database e schemi di sicurezza | Lab 01 |
| 11.3 | Sicurezza & Multi-Tenancy | Sicurezza a livello di riga, autenticazione e accesso dati multi-tenant | Lab 02 |
| 11.4 | Configurazione Ambiente | Configurazione ambiente di sviluppo, Docker, risorse Azure | Lab 03 |
| 11.5 | Progettazione Database | Configurazione PostgreSQL, schema retail e dati di esempio | Lab 04 |
| 11.6 | Implementazione Server MCP | Costruzione del server FastMCP con integrazione su database | Lab 05 |
| 11.7 | Sviluppo Strumenti | Creazione di strumenti di interrogazione database e introspezione schema | Lab 06 |
| 11.8 | Ricerca Semantica | Implementazione di vettori embedding con Azure OpenAI e pgvector | Lab 07 |
| 11.9 | Testing & Debugging | Strategie di testing, strumenti di debug e approcci di validazione | Lab 08 |
| 11.10 | Integrazione VS Code | Configurazione dell’integrazione MCP in VS Code e uso AI Chat | Lab 09 |
| 11.11 | Strategie di Deploy | Deploy con Docker, Azure Container Apps e considerazioni di scalabilità | Lab 10 |
| 11.12 | Monitoraggio | Application Insights, logging, monitoraggio performance | Lab 11 |
| 11.13 | Best Practices | Ottimizzazione performance, rafforzamento sicurezza e consigli per produzione | Lab 12 |
Una delle parti più entusiasmanti dell’apprendimento MCP è vedere le tue abilità di programmazione svilupparsi progressivamente. Abbiamo progettato i nostri esempi di codice per iniziare semplici e diventare più sofisticati man mano che la tua comprensione si approfondisce. Ecco come introduciamo i concetti: con codice facile da capire ma che dimostra i reali principi MCP, capirai non solo cosa fa il codice, ma perché è strutturato in quel modo e come si inserisce in applicazioni MCP più grandi.
| Linguaggio | Descrizione | Link |
|---|---|---|
| C# | Esempio Server MCP | Visualizza Codice |
| Java | Calcolatrice MCP | Visualizza Codice |
| JavaScript | Demo MCP | Visualizza Codice |
| Python | Server MCP | Visualizza Codice |
| TypeScript | Esempio MCP | Visualizza Codice |
| Rust | Esempio MCP | Visualizza Codice |
| Linguaggio | Descrizione | Link |
|---|---|---|
| C# | Esempio Avanzato | Visualizza Codice |
| Java con Spring | Esempio Container App | Visualizza Codice |
| JavaScript | Esempio Avanzato | Visualizza Codice |
| Python | Implementazione Complessa | Visualizza Codice |
| TypeScript | Esempio di Contenitore | Visualizza Codice |
Per ottenere il massimo da questo curriculum, dovresti avere:
-
Conoscenze di base di programmazione in almeno uno dei seguenti linguaggi: C#, Java, JavaScript, Python o TypeScript
-
Comprensione del modello client-server e delle API
-
Familiarità con concetti REST e HTTP
-
(Opzionale) Background nei concetti di AI/ML
-
Partecipare alle nostre discussioni della community per supporto
Questo repository include diverse risorse per aiutarti a navigare e apprendere efficacemente:
È disponibile una completa Guida allo Studio per aiutarti a navigare efficacemente in questo repository. Questa mappa curriculare visuale mostra come tutti gli argomenti sono collegati e fornisce indicazioni su come utilizzare efficacemente i progetti di esempio. È particolarmente utile se sei un apprendente visivo che ama vedere la panoramica completa.
La guida include:
- Una mappa curriculare visuale che mostra tutti gli argomenti trattati
- Dettagliata suddivisione di ogni sezione del repository
- Indicazioni su come utilizzare i progetti di esempio
- Percorsi di apprendimento consigliati per diversi livelli di abilità
- Risorse aggiuntive per integrare il tuo percorso di apprendimento
Manteniamo un dettagliato Registro delle Modifiche che traccia tutti gli aggiornamenti significativi ai materiali del curriculum, così puoi rimanere aggiornato con le ultime migliorie e aggiunte.
- Nuovi contenuti aggiunti
- Cambiamenti strutturali
- Migliorie alle funzionalità
- Aggiornamenti alla documentazione
Ogni lezione in questa guida include:
- Spiegazioni chiare dei concetti MCP
- Esempi di codice live in più linguaggi
- Esercizi per costruire vere applicazioni MCP
- Risorse extra per chi vuole approfondire
Impariamo il Model Context Protocol (MCP), un framework all'avanguardia progettato per standardizzare le interazioni tra modelli AI e applicazioni client. Attraverso questa sessione adatta ai principianti, ti introdurremo a MCP e ti guideremo nella creazione del tuo primo server MCP.
JavaScript: https://aka.ms/letslearnmcp-javascript
Congratulazioni! Hai appena compiuto il primo passo in un entusiasmante percorso che espanderà le tue capacità di programmazione e ti collegherà all'avanguardia dello sviluppo AI.
Leggendo questa introduzione, hai già iniziato a costruire la tua base di conoscenza MCP. Comprendi cos’è MCP, perché è importante e come questo curriculum supporta il tuo percorso di apprendimento. È un risultato significativo e l’inizio della tua competenza in questa tecnologia importante.
Man mano che progredirai nei moduli, ricorda che ogni esperto è stato una volta un principiante. I concetti che ora potrebbero sembrarti complessi diventeranno naturali mano a mano che li praticherai e applicherai. Ogni piccolo passo costruisce capacità potenti che ti serviranno per tutta la tua carriera di sviluppo.
Stai entrando a far parte di una comunità di apprendenti ed esperti appassionati di MCP e desiderosi di aiutare gli altri a riuscire. Che tu sia bloccato su una sfida di codice o entusiasta di condividere una scoperta, la comunità è qui per sostenerti nel tuo percorso.
Se ti blocchi o hai domande sulla costruzione di app AI. Unisciti agli altri apprendenti e sviluppatori esperti nelle discussioni su MCP. È una comunità di supporto dove le domande sono benvenute e la conoscenza viene condivisa liberamente.
Se hai feedback sul prodotto o riscontri errori durante la costruzione visita:
La tua avventura MCP inizia ora! Inizia con il Modulo 0 per immergerti nelle tue prime esperienze pratiche MCP, oppure esplora i progetti di esempio per vedere cosa costruirai. Ricorda: ogni esperto è partito esattamente da dove sei ora, e con pazienza e pratica rimarrai stupito da ciò che potrai realizzare.
Benvenuto nel mondo dello sviluppo Model Context Protocol. Costruiamo qualcosa di straordinario insieme!
Questo curriculum si rafforza grazie ai contributi di apprendenti come te! Che tu stia correggendo un refuso, suggerendo una spiegazione più chiara o aggiungendo un nuovo esempio, i tuoi contributi aiutano altri principianti a riuscire.
Grazie al Microsoft Valued Professional Shivam Goyal per aver contribuito con esempi di codice.
Il processo di contributo è pensato per essere accogliente e di supporto. La maggior parte dei contributi richiede un Contributor License Agreement (CLA), ma gli strumenti automatizzati ti guideranno attraverso il processo senza problemi.
Questo intero curriculum è disponibile sotto licenza MIT LICENSE, il che significa che puoi usarlo, modificarlo e condividerlo liberamente. Questo supporta la nostra missione di rendere la conoscenza MCP accessibile agli sviluppatori di tutto il mondo.
Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede che tu accetti un Contributor License Agreement (CLA) dichiarando di avere il diritto e di concederci i diritti per usare il tuo contributo. Per dettagli, visita https://cla.opensource.microsoft.com.
Quando invii una pull request, un bot CLA determinerà automaticamente se devi fornire un CLA e decorerà la PR di conseguenza (es., verifica stato, commento). Segui semplicemente le istruzioni fornite dal bot. Dovrai farlo solo una volta per tutti i repository che usano il nostro CLA.
Questo progetto ha adottato il Codice di Condotta Open Source di Microsoft. Per maggiori informazioni, consulta le FAQ sul Codice di Condotta o contatta opencode@microsoft.com per ulteriori domande o commenti.
Pronto a iniziare il tuo viaggio MCP? Inizia con il Modulo 00 - Introduzione a MCP e fai i tuoi primi passi nel mondo dello sviluppo Model Context Protocol!
Il nostro team produce altri corsi! Dai un’occhiata:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Disclaimer: Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Pur impegnandoci per garantire l’accuratezza, si prega di notare che le traduzioni automatizzate possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un umano. Non ci assumiamo alcuna responsabilità per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.