Développer rapidement vos Workflow N8N avec Claude Code
Introduction
L’automatisation des tâches est devenue un enjeu central pour les développeurs et les équipes techniques. N8N, plateforme open-source d’automatisation, offre une interface visuelle puissante pour créer des workflows. Mais que se passerait-il si on pouvait déléguer non seulement la création de ces workflows, mais aussi toute la configuration de l’environnement à une IA, sans toucher à un seul fichier de configuration ?
C’est exactement ce que j’ai testé. Un simple message à Claude Code, quelques informations saisies dans l’interface, et le tour était joué.
Dans cet article, je partage mon retour d’expérience sur cette approche ultra-simplifiée du développement assisté par IA pour N8N, avec un cas d’usage concret : un webhook de réception de données de formulaire et notification Telegram.
Architecture globale
L’expérience : zéro fichier de configuration
Mon unique prompt
install this MCP server: https://github.com/czlonkowski/n8n-mcp
install these skills: https://github.com/czlonkowski/n8n-skills
Make sure they are accessible by Claude Code in this project
so we can build flawless n8n workflows
Ce qui s’est passé ensuite
Aucune manipulation de fichiers .env, .bashrc, ou configuration JSON !
Configuration interactive : capture d’écran du flow
┌─────────────────────────────────────────────────────────┐
│ Claude Code │
├─────────────────────────────────────────────────────────┤
│ │
│ ✅ MCP server installé et compilé │
│ ✅ Skills N8N récupérés et organisés │
│ │
│ Pour me connecter à votre instance N8N, j'ai besoin : │
│ │
│ 🔗 URL de votre instance N8N │
│ ┌─────────────────────────────────────────────────┐ │
│ │ https://mon-instance-n8n.com │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 🔑 Votre clé API N8N │
│ ┌─────────────────────────────────────────────────┐ │
│ │ •••••••••••••••••••••••••••••••• │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [Valider] │
│ │
│ ✅ Connexion testée avec succès ! │
│ Prêt à créer des workflows N8N. │
│ │
└─────────────────────────────────────────────────────────┘
Avantages de cette approche
🔒 Sécurité
Avantages concrets :
- ✅ Jamais de clé API en clair dans un fichier
- ✅ Impossible de commit accidentellement
- ✅ Pas de risque de partage dans un screenshot
- ✅ Pas de résidu dans l’historique bash
- ✅ Révocation facile (juste re-saisir)
⚡ Rapidité
| Étape | Méthode classique | Avec Claude Code |
|---|---|---|
Créer .env | 2 min | 0 min |
| Trouver le bon format | 3 min | 0 min |
| Sourcer variables | 1 min | 0 min |
| Tester connexion | 2 min | Automatique |
| Débugger si erreur | 5-10 min | 0 min |
| TOTAL | 13-18 min | 30 sec |
Structure du projet après installation
project-root/
├── .claude/
│ ├── config.json # Config MCP
│ └── credentials/ # Credentials chiffrés (géré par Claude)
│ └── n8n-mcp.enc # Jamais en clair !
├── skills/
│ └── n8n/ # Skills installés
│ ├── webhooks/
│ ├── api-integration/
│ ├── data-processing/
│ └── best-practices/
├── n8n-mcp/ # MCP server
│ ├── src/
│ ├── build/
│ └── package.json
└── workflows/ # Vos workflows
Notez l’absence de :
- ❌
.env - ❌
.env.local - ❌
config.jsonavec credentials - ❌ Tout fichier contenant des secrets en clair
Création du workflow : l’expérience complète
Mon prompt ultra-simple
Une fois l’installation terminée (30 secondes), j’ai simplement dit :
Crée-moi un workflow N8N simple :
- Webhook pour récupérer des données de formulaire
- Envoi des infos sur Telegram
Ce que Claude Code a fait
Workflow généré
Code généré (avec best practices des skills)
Node de validation
// Généré automatiquement avec patterns de sécurité
const requiredFields = ['nom', 'email', 'message'];
const errors = [];
// Validation de présence avec trim
for (const field of requiredFields) {
if (!$json[field] || $json[field].trim() === '') {
errors.push(`Le champ "${field}" est requis`);
}
}
// Validation email robuste
if ($json.email) {
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
if (!emailRegex.test($json.email.trim())) {
errors.push('Format email invalide');
}
}
// Validation longueur minimum
if ($json.message && $json.message.trim().length < 10) {
errors.push('Le message doit contenir au moins 10 caractères');
}
// Protection XSS basique
const sanitize = (str) => {
return str.replace(/[<>]/g, '');
};
if (errors.length > 0) {
return [{
json: {
success: false,
errors: errors,
statusCode: 400
}
}];
}
return [{
json: {
success: true,
data: {
nom: sanitize($json.nom.trim()),
email: $json.email.trim().toLowerCase(),
message: sanitize($json.message.trim()),
timestamp: new Date().toISOString()
}
}];
Node de formatage Telegram
// Pattern issu des skills pour messages professionnels
const { nom, email, message } = $json;
const timestamp = new Date().toLocaleString('fr-FR', {
dateStyle: 'long',
timeStyle: 'short'
});
const telegramMessage = `
🔔 <b>Nouveau message de contact</b>
👤 <b>Nom :</b> ${nom}
📧 <b>Email :</b> <code>${email}</code>
💬 <b>Message :</b>
<pre>${message}</pre>
🕐 <i>${timestamp}</i>
`.trim();
return [{
json: {
text: telegramMessage,
parse_mode: 'HTML',
disable_web_page_preview: true
}
}];
Ce que Claude Code m’a retourné
┌─────────────────────────────────────────────────────────┐
│ ✅ Workflow créé avec succès ! │
├─────────────────────────────────────────────────────────┤
│ │
│ 📋 Workflow : "Formulaire Contact → Telegram" │
│ 🆔 ID : ZXc9Kq2pL4mN3oP1 │
│ ✅ Statut : Actif │
│ │
│ 🌐 URL du webhook : │
│ https://mon-instance-n8n.com/webhook/formulaire-contact │
│ │
│ 📊 Nodes créés : │
│ • Webhook Trigger │
│ • Validation des données │
│ • Extraction et nettoyage │
│ • Formatage Telegram │
│ • Envoi Telegram │
│ • Réponses webhook (succès/erreur) │
│ │
│ ⚙️ Configuration requise : │
│ ⚠️ Vous devez encore configurer les credentials │
│ Telegram dans N8N : │
│ 1. Créer un bot via @BotFather │
│ 2. Obtenir le token │
│ 3. Ajouter credential "Telegram" dans N8N │
│ 4. Obtenir votre chat_id │
│ │
│ 🧪 Test rapide : │
│ curl -X POST \ │
│ https://mon-instance-n8n.com/webhook/formulaire-... \ │
│ -H "Content-Type: application/json" \ │
│ -d '{ │
│ "nom": "Test", │
│ "email": "test@example.com", │
│ "message": "Message de test" │
│ }' │
│ │
└─────────────────────────────────────────────────────────┘
Claude Code m’a même donné la commande curl pour tester ! 🎯
Retour d’expérience : ce qui change tout
🎊 Les moments “wow”
1. Zéro friction pour démarrer
Moi: install n8n mcp and skills
Claude: [fait tout]
Quelle est l'URL de votre instance?
Moi: https://...
Claude: Merci! Et la clé API?
Moi: [paste]
Claude: ✅ Connecté! Prêt à créer des workflows.
2. Credentials jamais exposés
J’ai fait un git status par réflexe :
$ git status
On branch main
Untracked files:
n8n-mcp/
skills/
workflows/
nothing to commit
Aucune trace de credentials ! 🎉
Claude Code a tout géré en interne, de manière sécurisée.
⚡ Gains mesurés
| Phase | Manuel | Claude Code | Gain |
|---|---|---|---|
| Setup environnement | 21 min | 1.5 min | 93% |
| Saisie credentials | 4 min | 0.5 min | 87% |
| Debug / validation | 6 min | 0 min | 100% |
| TOTAL SETUP | 31 min | 2 min | 94% |
Workflow complet : du besoin à la production
Timeline réelle de mon expérience
| Temps | Étape | Status |
|---|---|---|
| 00:00 | Prompt installation MCP + skills | Lancé |
| 00:30 | Saisie URL instance N8N | En cours |
| 01:00 | Saisie API key | En cours |
| 01:30 | Environnement prêt | ✅ |
| 02:00 | Demande création workflow | Lancé |
| 02:30 | Workflow généré et activé | ✅ |
| 03:00 | Configuration Telegram bot | En cours |
| 04:00 | Premier test webhook | En cours |
| 04:30 | Message reçu sur Telegram | ✅ |
| 05:00 | Workflow en production | ✅ |
Cas d’usage réels et extensions
Scénarios testés avec succès
Formulaire contact → Multi-canaux
Prompt :
Envoie les notifications sur Telegram ET par email ET dans Slack
Résultat :
Temps : 45 secondes
Best Practices découvertes
Soyez spécifique dans vos prompts
❌ Prompt vague :
Fais-moi un truc pour les formulaires
✅ Prompt précis :
Crée un workflow qui :
- Reçoit des données de formulaire (nom, email, message)
- Valide les champs
- Envoie sur Telegram avec formatage HTML
- Retourne JSON au frontend
Itérez progressivement
Versionnez vos workflows
# Claude Code peut exporter automatiquement
Export ce workflow en JSON dans ./workflows/v1.0.0/
Vous obtenez une sauvegarde versionnée
Conclusion
Ce qui a changé ma façon de travailler
Je ne code plus les workflows manuellement
- Je les décris en français
- Claude Code les génère
- Je me concentre sur la logique métier
Prototypage ultra-rapide
- Tester une idée : 2 minutes
- Valider avec le client : même jour
- Itérer : secondes, pas heures
Moins d’erreurs
- Les patterns sont cohérents
- Les validations sont systématiques
- La documentation est automatique
Recommandations finales
Pour démarrer
1. Install this MCP server: github.com/czlonkowski/n8n-mcp
2. Install these skills: github.com/czlonkowski/n8n-skills
3. Saisissez vos credentials quand demandé
4. Commencez par un workflow simple
5. Itérez !
Pour aller plus loin
- Créez vos propres skills pour vos patterns métier
- Documentez vos workflows (Claude peut le faire)
- Partagez avec l’équipe (export/import JSON)
- Automatisez le déploiement (CI/CD)
Métriques finales
| Métrique | Valeur |
|---|---|
| Temps setup initial | 2 min |
| Temps création workflow simple | 2-3 min |
| Temps création workflow complexe | 10-15 min |
| Gain de temps moyen | 93% |
| Workflows créés (mon test) | 8 |
| Erreurs de configuration | 0 |
| Credentials exposés | 0 |
| Satisfaction | 🌟🌟🌟🌟🌟 |
L’avenir
Avec cette approche, on peut imaginer :
- Génération de workflows à partir de maquettes
- Analyse de logs et optimisation auto
- Suggestion de workflows basée sur les données
- Tests automatisés des workflows
- Documentation auto-générée
Ressources
💡 Astuce finale : Commencez votre prochain projet N8N par ce simple message dans Claude Code :
install n8n mcp and skills, let's build workflows
C’est tout ce dont vous avez besoin.