Guida Dify + MCP 2026: Connetti agenti IA a qualsiasi strumento
Il Model Context Protocol (MCP) è il nuovo standard universale per connettere i modelli IA agli strumenti esterni. Questa guida ti mostra come integrare server MCP in Dify — dando ai tuoi agenti accesso al filesystem, GitHub, Slack, database e qualsiasi API attraverso un'interfaccia standardizzata.
Cos'è MCP (Model Context Protocol)?
Il Model Context Protocol (MCP) è uno standard aperto introdotto da Anthropic alla fine del 2024. Definisce un modo universale per i modelli di linguaggio di connettersi a strumenti e fonti di dati esterne. Prima di MCP, ogni piattaforma IA richiedeva le proprie integrazioni personalizzate per ogni strumento — un connettore GitHub, un adattatore per database, un lettore di file, tutti sviluppati separatamente. MCP cambia tutto questo.
La migliore analogia: MCP è come l'USB-C per l'IA. Così come USB-C permette di collegare qualsiasi dispositivo a qualsiasi computer, MCP permette a qualsiasi agente IA di connettersi a qualsiasi server di strumenti compatibile MCP. Uno standard, estensibilità infinita.
Nota tecnica: MCP usa un'architettura client-server su HTTP o stdio. L'agente IA (client) invia richieste ai server MCP che espongono "strumenti" — funzioni che l'agente può chiamare. Il protocollo è indipendente dal linguaggio: i server possono essere scritti in Node.js, Python, Go o qualsiasi altro linguaggio.
Standardizzato
Un protocollo per tutti gli strumenti. Costruisci una volta, connetti ovunque.
Open Source
Licenza Apache 2.0. Ecosistema di server guidato dalla community.
Sicuro
I server girano in locale o sulla tua rete privata. I tuoi dati restano tuoi.
Estensibile
Crea server MCP personalizzati per qualsiasi API, database o servizio.
Dify come client MCP
Dify supporta MCP nativamente come client, il che significa che i tuoi agenti Dify possono comunicare con qualsiasi server MCP. Quando aggiungi un server MCP a Dify, scopre automaticamente tutti gli strumenti esposti e li rende disponibili nelle tue applicazioni Agent. Il tuo agente IA decide autonomamente quando chiamare quali strumenti.
Questo è un significativo passo avanti rispetto alle integrazioni API tradizionali. Invece di definire manualmente ogni chiamata API come uno "strumento personalizzato" in Dify, punti semplicemente Dify verso un server MCP e l'intero catalogo di strumenti viene letto automaticamente. Aggiungi un server MCP GitHub e il tuo agente può immediatamente elencare repository, leggere file, creare issue e revisionare pull request.
Cosa puoi connettere via MCP
Come connettere un server MCP a Dify
Aggiungere un server MCP come strumento in Dify richiede circa 2 minuti. Ecco il processo completo passo dopo passo:
Avviare il server MCP
Lancia il tuo server MCP in locale o sul tuo server. Ad esempio, per avviare il server filesystem ufficiale di Anthropic: npx @modelcontextprotocol/server-filesystem /percorso/ai/tuoi/file — questo avvia un server MCP HTTP sulla porta 3000 per impostazione predefinita.
Aprire gli Strumenti di Dify
Nella tua istanza Dify, clicca su Strumenti nella navigazione superiore. Poi clicca su Strumenti personalizzati nella barra laterale sinistra.
Creare un nuovo strumento MCP
Clicca sul pulsante "+ Crea". Nel selettore del tipo di strumento, scegli Server MCP (non OpenAPI).
Inserire l'URL del server MCP
Incolla l'URL del tuo server MCP, ad esempio http://localhost:3000/mcp. Se il tuo server richiede autenticazione, inserisci il token nel campo dell'intestazione Authorization.
Scoperta automatica
Dify recupera automaticamente il manifesto degli strumenti del server. Vedrai un elenco di tutti gli strumenti esposti — es. "read_file", "list_directory", "write_file" per un server filesystem.
Aggiungere all'app Agent
Apri o crea un'applicazione Agent in Dify. Nella sezione Strumenti, clicca su Aggiungi strumento e seleziona il tuo server MCP. Il tuo agente può ora usare tutti gli strumenti scoperti.
Consiglio self-hosted: Se Dify e il tuo server MCP girano sullo stesso host, usa l'IP interno o il nome host del server — non localhost, perché Dify gira dentro Docker. Ad esempio: http://172.17.0.1:3000/mcp o http://host.docker.internal:3000/mcp su macOS/Windows.
Server MCP popolari per Dify
Anthropic e la community mantengono un ecosistema crescente di server MCP. Questi sono i più utili da connettere a Dify:
| Server MCP | Funzione | Strumenti principali | Installazione |
|---|---|---|---|
| filesystem | Leggere e scrivere file locali | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | Repository GitHub, PR, issue | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Messaggi e canali Slack | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | Accesso SQL in sola lettura | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | Ricerca web in tempo reale | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | Automazione browser e scraping | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Indicizzazione file Windows | search, get_file_info | npx @modelcontextprotocol/server-everything |
Configurare un server MCP: esempio passo dopo passo
Esempio completo: configurare il server MCP filesystem di Anthropic in modo che il tuo agente Dify possa leggere e scrivere file sul tuo server.
Passo 1: Installare Node.js 18+ (saltare se già installato)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
Passo 2: Avviare il server MCP filesystem
npx @modelcontextprotocol/server-filesystem /home/user/documenti
# Server avviato su http://localhost:3000/mcp
Passo 3: Eseguire come servizio in background (opzionale)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documenti" --name mcp-filesystem pm2 save && pm2 startup
Passo 4: Testare il server
curl http://localhost:3000/mcp
# Dovrebbe restituire: {"name":"filesystem","version":"...","tools":[...]} Passo 5: Server MCP GitHub (con autenticazione)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_il_tuo_token_qui \ npx @modelcontextprotocol/server-github
# Crea un PAT GitHub su: github.com/settings/tokens
Casi d'uso reali
Tre configurazioni Dify + MCP pronte per la produzione che puoi replicare oggi stesso:
Caso d'uso 1: Assistente documentale IA
Connetti il server MCP filesystem a un agente Dify. La tua IA può ora sfogliare le cartelle dei documenti, leggere contratti, estrarre dati chiave, confrontare versioni e scrivere riepiloghi su disco — tutto in linguaggio naturale. Chiedi "riassumi tutti i report PDF in /report/T1 e crea un executive summary" e osservalo lavorare.
Caso d'uso 2: Revisore di PR GitHub
Connetti il server MCP GitHub a Dify. Costruisci un agente che revisiona automaticamente le pull request: elenca le PR aperte, legge il diff, verifica gli standard di codice, identifica bug potenziali e pubblica un commento di revisione — tutto dall'interfaccia Dify. Pianificalo tramite i workflow Dify per code review automatica.
Caso d'uso 3: Analista di database
Connetti il server MCP PostgreSQL a Dify con credenziali in sola lettura. Costruisci un analista dati in linguaggio naturale: gli utenti fanno domande di business in italiano, l'agente scrive query SQL, le esegue sul database e restituisce gli insight in forma leggibile. Nessuna conoscenza di SQL necessaria per gli utenti finali.
Domande frequenti
Cos'è MCP (Model Context Protocol)?
MCP è uno standard aperto di Anthropic che definisce come i modelli IA si connettono a strumenti e fonti di dati esterne. È come l'USB-C per l'IA — invece di integrazioni personalizzate, uno standard universale funziona ovunque. Dify supporta MCP come client.
Cosa posso connettere a Dify via MCP?
Via MCP puoi connettere Dify a: filesystem locali (leggi/scrivi file), GitHub (repo, PR, issue), Slack (messaggi, canali), database PostgreSQL, browser web (Puppeteer), ricerca web (Brave, DuckDuckGo) e qualsiasi servizio con server MCP.
Ho bisogno di programmare per usare MCP con Dify?
Per i server MCP ufficiali (filesystem, GitHub, ecc.), basta un singolo comando npx per avviarlo, poi aggiungi l'URL in Dify. Nessun codice necessario. Costruire un server MCP personalizzato richiede conoscenze base di Node.js o Python.
MCP è sicuro per la produzione?
La sicurezza MCP dipende dalla configurazione. Esegui sempre i server MCP su localhost o una rete privata — mai direttamente su internet. Usa token di autenticazione e limita l'accesso al filesystem a directory specifiche.
Pronto a usare Dify + MCP in produzione?
MCP è più potente quando Dify e i server MCP sono self-hosted insieme — sullo stesso server privato, senza che i dati lascino la tua infrastruttura. Hetzner offre VPS da 3,79 €/mese con le prestazioni per far girare Dify e più server MCP contemporaneamente. Oppure usa Elestio per un deployment Dify completamente gestito in un clic.