Collegare n8n e Claude Code: Guida completa all'integrazione MCP 2026
L'automazione dei processi aziendali ha raggiunto una nuova dimensione. Con l'integrazione di n8n e Claude Code tramite il Model Context Protocol (MCP), puoi ora creare workflow completi con un singolo prompt.
Il server n8n-MCP è un ponte open-source che dà agli assistenti IA accesso completo ai 1.084 node di automazione workflow di n8n. In questa guida, ti mostriamo come configurare e sfruttare questa potente combinazione.
Il problema: La creazione manuale di workflow richiede tempo
Tradizionalmente, creare workflow n8n richiede diversi passaggi:
- Configurazione manuale dei node nell'editor n8n
- Test e debug di ogni connessione
- Iterazione per tentativi ed errori
- Documentazione dei workflow creati
Un workflow tipico può costare ore di sviluppo – tempo che potresti dedicare a compiti più importanti.
La soluzione: Automazione dei workflow guidata dall'IA
Con l'integrazione n8n-MCP, Claude Code diventa il tuo architetto personale di workflow:
┌─────────────────┐ ┌─────────────┐ ┌──────────────┐
│ Claude Code │────▶│ MCP Server │────▶│ n8n │
│ (Agente IA) │◀────│ (Ponte) │◀────│ (Workflow) │
└─────────────────┘ └─────────────┘ └──────────────┘
│ │
└──────── Linguaggio naturale ─────────────┘
Descrivi semplicemente cosa vuoi automatizzare, e Claude Code crea, valida e distribuisce il workflow automaticamente.
Cos'è il Model Context Protocol (MCP)?
Il Model Context Protocol (MCP) è stato introdotto da Anthropic alla fine del 2024 ed è uno standard aperto che definisce come i modelli di IA comunicano con i sistemi esterni.
Da gennaio 2026, MCP 1.0 è lo standard de facto per l'integrazione degli strumenti IA.
Concetti fondamentali del MCP
| Concetto | Descrizione |
|---|---|
| Host | L'applicazione IA (es. Claude Code, Claude Desktop) |
| Server | Fornisce strumenti e risorse (es. n8n-MCP) |
| Client | Connette l'host al server |
| Tools | Funzioni eseguibili (es. creare workflow) |
| Resources | Fonti di dati e informazioni di contesto |
Perché il MCP è importante
- Standardizzazione: Interfaccia unificata per tutti gli strumenti IA
- Sicurezza: Accesso controllato ai sistemi esterni
- Scalabilità: I server sviluppati una volta funzionano con tutti gli host compatibili MCP
- Interoperabilità: Claude, GPT e altri modelli possono usare gli stessi strumenti
Cos'è n8n?
n8n (pronunciato "n-eight-n") è una piattaforma open-source per l'automazione dei workflow. Permette la creazione visuale di automazioni collegando diversi node.
Funzionalità principali di n8n
- 400+ integrazioni pre-costruite (Slack, Google, Airtable, ecc.)
- Self-hosted o Cloud: Controllo totale sui tuoi dati
- Licenza fair-code: Gratuito per utenti individuali
- Node IA: Integrazione nativa di LLM nei workflow
n8n come server e client MCP
n8n può assumere due ruoli:
- Server MCP: Espone i tuoi workflow come strumenti per agenti IA
- Client MCP: Chiama strumenti MCP esterni dai workflow
Cos'è Claude Code?
Claude Code (Versione 2.1, gennaio 2026) è lo strumento CLI di Anthropic per lo sviluppo software assistito da IA.
È basato su Claude Opus 4.5 e offre capacità avanzate di automazione e orchestrazione.
Funzionalità di Claude Code 2.1
| Funzionalità | Descrizione |
|---|---|
| Integrazione MCP | Supporto nativo per server MCP |
| Sistema di Skills | Capacità estensibili tramite plugin |
| Workflow multi-agente | Orchestrazione di più agenti IA |
| Context Fork | Esplorazione parallela di approcci |
| Coding agentico | Creazione e refactoring autonomo del codice |
Perché Claude Code per n8n?
Claude Code è particolarmente adatto all'integrazione con n8n perché:
- Workflow agentici: Esecuzione autonoma di compiti complessi
- Uso degli strumenti: Interazione diretta con API esterne
- Sessioni persistenti: Il contesto persiste tra le interazioni
- Validazione: Verifica automatica dei workflow creati
Passo dopo passo: Collegare Claude Code con n8n-MCP
Prerequisiti
Prima di iniziare, avrai bisogno di:
- Node.js 18+ installato
- Claude Code 2.1+ installato (
npm install -g @anthropic-ai/claude-code) - Istanza n8n (Cloud o self-hosted)
- Chiave API n8n (per la gestione dei workflow)
Il server n8n-MCP è disponibile su GitHub: github.com/czlonkowski/n8n-mcp
Opzione 1: Configurazione base (Solo documentazione)
Questa configurazione dà a Claude Code accesso alla documentazione n8n e agli strumenti di validazione:
Linux/macOS/WSL:
claude mcp add n8n-mcp \
-e MCP_MODE=stdio \
-e LOG_LEVEL=error \
-e DISABLE_CONSOLE_OUTPUT=true \
-- npx n8n-mcp
Windows PowerShell:
claude mcp add n8n-mcp `
'-e MCP_MODE=stdio' `
'-e LOG_LEVEL=error' `
'-e DISABLE_CONSOLE_OUTPUT=true' `
-- npx n8n-mcp
Opzione 2: Configurazione completa (con gestione workflow)
Per la funzionalità completa – creazione, aggiornamento ed esecuzione di workflow – aggiungi le tue credenziali n8n:
Linux/macOS/WSL:
claude mcp add n8n-mcp \
-e MCP_MODE=stdio \
-e LOG_LEVEL=error \
-e DISABLE_CONSOLE_OUTPUT=true \
-e N8N_API_URL=https://tua-istanza-n8n.com \
-e N8N_API_KEY=tua-chiave-api \
-- npx n8n-mcp
Per istanze n8n locali:
-e N8N_API_URL=http://localhost:5678
Opzione 3: Configurazione Docker
Per un'esecuzione isolata con Docker:
{
"mcpServers": {
"n8n-mcp": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MCP_MODE=stdio",
"-e", "LOG_LEVEL=error",
"-e", "DISABLE_CONSOLE_OUTPUT=true",
"-e", "N8N_API_URL=http://host.docker.internal:5678",
"-e", "N8N_API_KEY=TUA_CHIAVE_API",
"ghcr.io/czlonkowski/n8n-mcp:latest"
]
}
}
}
Verificare la configurazione
Dopo l'installazione, verifica lo stato:
# Elencare tutti i server MCP
claude mcp list
# Dettagli del server n8n-MCP
claude mcp get n8n-mcp
# In una sessione Claude Code: mostrare gli strumenti disponibili
/mcp
Strumenti MCP disponibili
Il server n8n-MCP fornisce più di 20 strumenti organizzati in quattro categorie principali.
Strumenti principali (7 strumenti – Sempre disponibili)
| Strumento | Funzione |
|---|---|
get_n8n_documentation | Accesso alla documentazione n8n |
search_n8n_nodes | Cercare i node disponibili |
get_node_details | Informazioni dettagliate sui node |
validate_workflow_json | Validare la struttura JSON |
validate_node_minimal | Verificare la configurazione minima |
validate_workflow_connections | Verificare le connessioni tra node |
validate_workflow_expressions | Validare le espressioni n8n |
Gestione workflow (6 strumenti – Richiede chiave API)
| Strumento | Funzione |
|---|---|
n8n_list_workflows | Elencare tutti i workflow |
n8n_get_workflow | Ottenere dettagli del workflow |
n8n_create_workflow | Creare nuovo workflow |
n8n_update_workflow | Aggiornare workflow esistente |
n8n_update_partial_workflow | Aggiornamenti parziali (diff) |
n8n_delete_workflow | Eliminare workflow |
Gestione esecuzioni (4 strumenti – Richiede chiave API)
| Strumento | Funzione |
|---|---|
n8n_execute_workflow | Eseguire workflow |
n8n_get_executions | Ottenere storico esecuzioni |
n8n_get_execution | Dettagli di un'esecuzione |
n8n_delete_execution | Eliminare un'esecuzione |
Strumenti di sistema (3 strumenti – Richiede chiave API)
| Strumento | Funzione |
|---|---|
n8n_validate_workflow | Validare workflow distribuito |
n8n_activate_workflow | Attivare workflow |
n8n_deactivate_workflow | Disattivare workflow |
Casi d'uso pratici
Esempio 1: Creare un workflow di nurturing dei lead
Prompt a Claude Code:
Crea un workflow n8n che:
1. Riceve nuovi lead da un webhook
2. Valida l'indirizzo email con Hunter.io
3. Per email valide, genera un messaggio personalizzato con Claude
4. Invia il messaggio tramite Instantly.ai
5. Aggiorna lo stato del lead in Airtable
Claude Code farà:
- Identificare i node necessari
- Generare il JSON del workflow
- Validare tutte le connessioni
- Creare il workflow nella tua istanza n8n
- Opzionalmente attivarlo
Esempio 2: Automatizzare una pipeline di contenuti
Prompt:
Costruisci un workflow per il riutilizzo dei contenuti:
- Trigger: Nuovo video YouTube caricato
- Estrarre trascrizione con Assembly AI
- Generare articolo blog con Claude
- Creare snippet social media per LinkedIn e X
- Pianificare post con Buffer
Esempio 3: Monitoring e alerting
Prompt:
Crea un workflow di monitoring:
- Controllare lo stato delle nostre API ogni 5 minuti
- In caso di errore: Inviare messaggio Slack a #ops
- Registrare tutti i controlli in Google Sheets
- Creare report settimanale di uptime
Best practice per n8n + Claude Code
1. Usare prompt strutturati
COMPITO: [Cosa deve essere automatizzato]
TRIGGER: [Cosa avvia il workflow]
PASSI: [Lista numerata delle azioni]
OUTPUT: [Risultato atteso]
GESTIONE ERRORI: [Cosa fare in caso di errore]
2. Validazione prima del deployment
Claude Code valida automaticamente i workflow, ma dovresti anche:
- Far verificare la sintassi delle espressioni
- Verificare le connessioni tra node
- Eseguire un test con dati di esempio
3. Approccio iterativo
Inizia con un workflow semplice e espandi gradualmente:
Prima iterazione: Webhook → Messaggio Slack
Seconda iterazione: + Validazione dati
Terza iterazione: + Gestione errori
Quarta iterazione: + Logging e monitoring
4. Usare operazioni di diff dei workflow
Per modifiche minori, usa n8n_update_partial_workflow invece di aggiornamenti completi – questo risparmia token e riduce gli errori.
Risoluzione dei problemi
Problema: Server MCP non raggiungibile
# Verificare lo stato
claude mcp list
# Ri-aggiungere il server
claude mcp remove n8n-mcp
claude mcp add n8n-mcp [opzioni]
Problema: Connessione API fallita
Verifica:
- URL API corretto? Nessuno slash finale
- Chiave API valida? In n8n: Settings → API → Create API Key
- Firewall/Rete? n8n deve essere raggiungibile dal tuo sistema
Problema: La creazione del workflow fallisce
Cause comuni:
- Credenziali mancanti in n8n
- Configurazione node non valida
- Errori di sintassi nelle espressioni
Soluzione: Usa gli strumenti di validazione prima del deployment:
validate_workflow_json → validate_workflow_connections → n8n_create_workflow
Il futuro: MCP come standard per l'automazione IA
La combinazione di n8n e Claude Code tramite MCP è solo l'inizio. Stiamo già vedendo:
- Sistemi multi-agente: Più agenti IA che orchestrano workflow insieme
- Workflow auto-riparanti: L'IA rileva gli errori e li corregge automaticamente
- Linguaggio naturale come interfaccia: Workflow creati e modificati tramite conversazione
n8n non ha solo adottato MCP – sta diventando un componente centrale dell'infrastruttura di automazione IA.
Risorse
- Repository GitHub n8n-MCP: github.com/czlonkowski/n8n-mcp
- Documentazione ufficiale n8n: docs.n8n.io
- Documentazione Claude Code: docs.anthropic.com/claude-code
- Specifica MCP: modelcontextprotocol.io
Definition of Done ✅
La tua integrazione n8n + Claude Code è completa quando:
- Claude Code è installato (Versione 2.1+)
- Il server n8n-MCP è aggiunto e attivo (
claude mcp list) - Le credenziali API sono configurate (per la gestione workflow)
- Un workflow di test è stato creato con successo
- Il workflow è stato validato e attivato
Domande frequenti (FAQ)
Qual è la differenza tra n8n come server MCP e client MCP?
Come server MCP, n8n espone i tuoi workflow come strumenti che agenti IA come Claude possono chiamare.
Come client MCP, n8n stesso può incorporare strumenti MCP esterni nei workflow.
Per l'integrazione con Claude Code, hai bisogno di un server MCP separato come n8n-mcp che fa da ponte tra Claude Code e la tua istanza n8n.
Ho bisogno di una chiave API per le funzioni base?
No. Senza chiave API, hai accesso ai 7 strumenti principali: documentazione, ricerca node e validazione.
Tuttavia, per creare, aggiornare ed eseguire effettivamente i workflow, hai bisogno di una chiave API n8n.
n8n-MCP funziona anche con Claude Desktop invece di Claude Code?
Sì. Il server n8n-MCP supporta sia Claude Code che Claude Desktop.
La configurazione avviene tramite claude_desktop_config.json invece di comandi CLI. Gli strumenti e le funzioni disponibili sono identici.
Quanto è sicura la connessione MCP alla mia istanza n8n?
La sicurezza dipende dalla tua configurazione:
- La chiave API non dovrebbe mai essere memorizzata in repository pubblici
- Usa variabili d'ambiente e limita l'accesso API alle operazioni necessarie
- Per istanze n8n self-hosted, raccomandiamo HTTPS e IP whitelisting
Posso modificare workflow n8n esistenti con Claude Code?
Assolutamente. Usa n8n_get_workflow per recuperare lo stato attuale, descrivi le modifiche desiderate, e Claude Code usa n8n_update_workflow o n8n_update_partial_workflow per la modifica.
L'operazione diff è particolarmente efficiente per piccole modifiche.
Conclusione
L'integrazione di n8n e Claude Code tramite MCP trasforma il modo in cui creiamo automazioni. Invece di ore di configurazione manuale, descrivi semplicemente i tuoi requisiti – e l'IA fa il resto.
Pronto per il prossimo passo? Contattaci via email per una consulenza personalizzata sull'automazione IA per la tua azienda.
Questo articolo è stato aggiornato l'ultima volta il 12 gennaio 2026 e riflette lo stato attuale di Claude Code 2.1, MCP 1.0 e n8n.