Al termine di questo modulo, sarai in grado di:
- ✅ Comprendere l'architettura e i vantaggi del Model Context Protocol (MCP)
- ✅ Esplorare l’ecosistema dei server MCP di Microsoft
- ✅ Integrare i server MCP con AI Toolkit Agent Builder
- ✅ Costruire un agente di automazione browser funzionante usando Playwright MCP
- ✅ Configurare e testare gli strumenti MCP all'interno dei tuoi agenti
- ✅ Esportare e distribuire agenti basati su MCP per l’uso in produzione
Nel Modulo 1 abbiamo imparato le basi di AI Toolkit e creato il nostro primo Python Agent. Ora potenzieremo i tuoi agenti collegandoli a strumenti e servizi esterni tramite il rivoluzionario Model Context Protocol (MCP).
Pensalo come un upgrade da una semplice calcolatrice a un computer completo: i tuoi agenti AI avranno la capacità di:
- 🌐 Navigare e interagire con siti web
- 📁 Accedere e gestire file
- 🔧 Integrarsi con sistemi aziendali
- 📊 Elaborare dati in tempo reale da API
Il Model Context Protocol (MCP) è il “USB-C per le applicazioni AI”: uno standard aperto rivoluzionario che collega i Large Language Models (LLM) a strumenti esterni, fonti di dati e servizi. Proprio come USB-C ha eliminato il caos dei cavi offrendo un connettore universale, MCP elimina la complessità dell’integrazione AI con un protocollo standardizzato.
Prima di MCP:
- 🔧 Integrazioni personalizzate per ogni strumento
- 🔄 Dipendenza da fornitori con soluzioni proprietarie
- 🔒 Vulnerabilità di sicurezza dovute a connessioni ad hoc
- ⏱️ Mesi di sviluppo per integrazioni base
Con MCP:
- ⚡ Integrazione plug-and-play degli strumenti
- 🔄 Architettura indipendente dal fornitore
- 🛡️ Best practice di sicurezza integrate
- 🚀 Minuti per aggiungere nuove funzionalità
MCP segue un’architettura client-server che crea un ecosistema sicuro e scalabile:
graph TB
A[AI Application/Agent] --> B[MCP Client]
B --> C[MCP Server 1: Files]
B --> D[MCP Server 2: Web APIs]
B --> E[MCP Server 3: Database]
B --> F[MCP Server N: Custom Tools]
C --> G[Local File System]
D --> H[External APIs]
E --> I[Database Systems]
F --> J[Enterprise Systems]
🔧 Componenti Principali:
| Componente | Ruolo | Esempi |
|---|---|---|
| MCP Hosts | Applicazioni che consumano i servizi MCP | Claude Desktop, VS Code, AI Toolkit |
| MCP Clients | Gestori del protocollo (1:1 con i server) | Integrati nelle applicazioni host |
| MCP Servers | Espongono funzionalità tramite protocollo standard | Playwright, Files, Azure, GitHub |
| Transport Layer | Metodi di comunicazione | stdio, HTTP, WebSockets |
Microsoft guida l’ecosistema MCP con una suite completa di server enterprise che rispondono a esigenze aziendali reali.
🔗 Repository: azure/azure-mcp
🎯 Scopo: Gestione completa delle risorse Azure con integrazione AI
✨ Caratteristiche principali:
- Provisioning infrastrutturale dichiarativo
- Monitoraggio risorse in tempo reale
- Raccomandazioni per ottimizzazione dei costi
- Verifica della conformità alla sicurezza
🚀 Casi d’uso:
- Infrastructure-as-Code con assistenza AI
- Scalabilità automatica delle risorse
- Ottimizzazione dei costi cloud
- Automazione dei workflow DevOps
📚 Documentazione: Microsoft Dataverse Integration
🎯 Scopo: Interfaccia in linguaggio naturale per dati aziendali
✨ Caratteristiche principali:
- Query di database in linguaggio naturale
- Comprensione del contesto aziendale
- Template personalizzati per prompt
- Governance dei dati enterprise
🚀 Casi d’uso:
- Reportistica di business intelligence
- Analisi dati clienti
- Insights sul pipeline di vendita
- Query per conformità normativa
🔗 Repository: microsoft/playwright-mcp
🎯 Scopo: Automazione browser e interazione web
✨ Caratteristiche principali:
- Automazione cross-browser (Chrome, Firefox, Safari)
- Rilevamento intelligente degli elementi
- Generazione screenshot e PDF
- Monitoraggio traffico di rete
🚀 Casi d’uso:
- Workflow di testing automatizzato
- Web scraping ed estrazione dati
- Monitoraggio UI/UX
- Automazione analisi competitiva
🔗 Repository: microsoft/files-mcp-server
🎯 Scopo: Operazioni intelligenti sul file system
✨ Caratteristiche principali:
- Gestione file dichiarativa
- Sincronizzazione contenuti
- Integrazione controllo versioni
- Estrazione metadati
🚀 Casi d’uso:
- Gestione documentazione
- Organizzazione repository di codice
- Workflow di pubblicazione contenuti
- Gestione file per pipeline dati
🔗 Repository: microsoft/markitdown
🎯 Scopo: Elaborazione avanzata di Markdown
✨ Caratteristiche principali:
- Parsing ricco di Markdown
- Conversione formati (MD ↔ HTML ↔ PDF)
- Analisi struttura contenuti
- Elaborazione template
🚀 Casi d’uso:
- Workflow di documentazione tecnica
- Sistemi di gestione contenuti
- Generazione report
- Automazione knowledge base
📦 Package: @microsoft/clarity-mcp-server
🎯 Scopo: Analisi web e insight sul comportamento utenti
✨ Caratteristiche principali:
- Analisi dati heatmap
- Registrazioni sessioni utente
- Metriche di performance
- Analisi funnel di conversione
🚀 Casi d’uso:
- Ottimizzazione siti web
- Ricerca esperienza utente
- Analisi A/B testing
- Dashboard business intelligence
Oltre ai server Microsoft, l’ecosistema MCP include:
- 🐙 GitHub MCP: Gestione repository e analisi codice
- 🗄️ Database MCP: integrazioni PostgreSQL, MySQL, MongoDB
- ☁️ Cloud Provider MCP: strumenti AWS, GCP, Digital Ocean
- 📧 Communication MCP: integrazioni Slack, Teams, Email
🎯 Obiettivo del Progetto: Creare un agente intelligente di automazione browser usando Playwright MCP server che possa navigare siti, estrarre informazioni ed eseguire interazioni web complesse.
- Apri AI Toolkit Agent Builder
- Crea un Nuovo Agente con la seguente configurazione:
- Nome:
BrowserAgent - Model: Choose GPT-4o
- Nome:
- Navigate to Tools Section in Agent Builder
- Click "Add Tool" to open the integration menu
- Select "MCP Server" from available options
🔍 Understanding Tool Types:
- Built-in Tools: Pre-configured AI Toolkit functions
- MCP Servers: External service integrations
- Custom APIs: Your own service endpoints
- Function Calling: Direct model function access
- Click "Use Featured MCP Servers" to access Microsoft's verified servers
- Select "Playwright" from the featured list
- Accept Default MCP ID or customize for your environment
🔑 Critical Step: Select ALL available Playwright methods for maximum functionality
🛠️ Essential Playwright Tools:
- Navigation:
goto,goBack,goForward,reload - Interaction:
click,fill,press,hover,drag - Extraction:
textContent,innerHTML,getAttribute - Validation:
isVisible,isEnabled,waitForSelector - Capture:
screenshot,pdf,video - Network:
setExtraHTTPHeaders,route,waitForResponse
✅ Indicatori di Successo:
- Tutti gli strumenti appaiono nell’interfaccia di Agent Builder
- Nessun messaggio di errore nel pannello di integrazione
- Lo stato del server Playwright mostra “Connected”
🔧 Risoluzione Problemi Comuni:
- Connessione Fallita: Controlla la connettività internet e le impostazioni firewall
- Strumenti Mancanti: Assicurati che tutte le funzionalità siano state selezionate durante la configurazione
- Errori di Permessi: Verifica che VS Code abbia i permessi di sistema necessari
Crea prompt sofisticati che sfruttino appieno le capacità di Playwright:
# Web Automation Expert System Prompt
## Core Identity
You are an advanced web automation specialist with deep expertise in browser automation, web scraping, and user experience analysis. You have access to Playwright tools for comprehensive browser control.
## Capabilities & Approach
### Navigation Strategy
- Always start with screenshots to understand page layout
- Use semantic selectors (text content, labels) when possible
- Implement wait strategies for dynamic content
- Handle single-page applications (SPAs) effectively
### Error Handling
- Retry failed operations with exponential backoff
- Provide clear error descriptions and solutions
- Suggest alternative approaches when primary methods fail
- Always capture diagnostic screenshots on errors
### Data Extraction
- Extract structured data in JSON format when possible
- Provide confidence scores for extracted information
- Validate data completeness and accuracy
- Handle pagination and infinite scroll scenarios
### Reporting
- Include step-by-step execution logs
- Provide before/after screenshots for verification
- Suggest optimizations and alternative approaches
- Document any limitations or edge cases encountered
## Ethical Guidelines
- Respect robots.txt and rate limiting
- Avoid overloading target servers
- Only extract publicly available information
- Follow website terms of serviceProgetta prompt che mostrino varie funzionalità:
🌐 Esempio di Analisi Web:
Navigate to github.com/kinfey and provide a comprehensive analysis including:
1. Repository structure and organization
2. Recent activity and contribution patterns
3. Documentation quality assessment
4. Technology stack identification
5. Community engagement metrics
6. Notable projects and their purposes
Include screenshots at key steps and provide actionable insights.- Clicca su "Run" per avviare la sequenza di automazione
- Monitora l’Esecuzione in Tempo Reale:
- Il browser Chrome si avvia automaticamente
- L’agente naviga sul sito target
- Vengono catturati screenshot a ogni step importante
- I risultati dell’analisi vengono mostrati in tempo reale
Esamina l’analisi completa nell’interfaccia di Agent Builder:
Agent Builder supporta diverse opzioni di deployment:
✅ Competenze Acquisite:
- Comprendere architettura e vantaggi MCP
- Navigare l’ecosistema dei server MCP Microsoft
- Integrare Playwright MCP con AI Toolkit
- Costruire agenti di automazione browser sofisticati
- Prompt engineering avanzato per automazione web
- 🔗 Specifica MCP: Documentazione Ufficiale del Protocollo
- 🛠️ API Playwright: Riferimento Completo Metodi
- 🏢 Server MCP Microsoft: Guida all’Integrazione Enterprise
- 🌍 Esempi dalla Community: Galleria Server MCP
🎉 Congratulazioni! Hai padroneggiato l’integrazione MCP e ora puoi costruire agenti AI pronti per la produzione con capacità di strumenti esterni!
Pronto a portare le tue competenze MCP al livello successivo? Procedi a Modulo 3: Sviluppo Avanzato MCP con AI Toolkit dove imparerai a:
- Creare i tuoi server MCP personalizzati
- Configurare e utilizzare l’ultima SDK Python MCP
- Impostare MCP Inspector per il debugging
- Padroneggiare i workflow avanzati di sviluppo server MCP
- Costruire da zero un Weather MCP Server
Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Pur impegnandoci per l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda la traduzione professionale effettuata da un umano. Non siamo responsabili per eventuali malintesi o interpretazioni errate derivanti dall'uso di questa traduzione.










