n8n Workflow Patterns

Patterns canoniques pour utiliser n8n (open source self-hosted ou n8n.cloud) en s'appuyant sur le MCP server n8n-mcp déclaré dans plugins/atum-nocode/.mcp.json.

MCP server n8n disponible : exposes 1396 nodes (812 core + 584 community). Claude Code peut directement créer / lister / inspecter / debug des workflows n8n.

Prérequis utilisateur : Node.js + instance n8n accessible (self-hosted Docker ou n8n.cloud) + API key.

1. Setup n8n self-hosted

# Docker
docker run -d --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=$(openssl rand -base64 24) \
  -e N8N_HOST=n8n.example.com \
  -e WEBHOOK_URL=https://n8n.example.com/ \
  -e N8N_PROTOCOL=https \
  n8nio/n8n

Génère ensuite l'API key dans Settings → API → Create API Key.

# Set env vars pour le MCP
export N8N_API_URL=https://n8n.example.com/api/v1
export N8N_API_KEY=your-api-key

2. Workflow types

Trigger
├── Webhook (HTTP endpoint)
├── Cron (scheduled)
├── Manual (test)
├── Polling (every N min, check API for changes)
└── Event (Slack mention, GitHub PR opened, Stripe payment, etc.)

→
Regular nodes (process data)
├── HTTP Request (REST APIs)
├── Code (JS/Python custom)
├── IF / Switch (branching)
├── Set / Merge / Split (data transform)
├── 1396 SaaS integrations (Slack, Notion, Airtable, Stripe, ...)
└── AI nodes (OpenAI, Anthropic, LangChain)

→
Output / action
├── HTTP Request (POST somewhere)
├── Send email
├── Slack message
├── Create row in DB / Airtable / Notion
└── Trigger another workflow

3. Pattern : Webhook → process → respond

[Webhook trigger]
       │
       ▼
[Validate input (Code or IF)]
       │ ✅
       ▼
[Process (HTTP, DB, transform)]
       │
       ▼
[Webhook response: 200 OK]

// Code node — validation
const body = $input.first().json
if (!body.email || !body.email.includes('@')) {
  return [{ json: { error: 'Invalid email' }, statusCode: 400 }]
}
return [{ json: body }]

4. Pattern : sub-workflows réutilisables

[Main workflow]
     │
     ├──> [Execute Sub-Workflow: send_notification(channel, message)]
     │
     └──> [Execute Sub-Workflow: log_event(event_type, payload)]

Sub-workflows = bibliothèque interne de "fonctions" réutilisables. Importer le JSON du sub-workflow et l'appeler avec Execute Sub-Workflow node.

5. Pattern : Error workflow + retry

[Trigger]
   │
   ▼
[HTTP Request (max 3 retries, 5s wait)]
   │
   ├── ✅ Success → [Continue]
   └── ❌ Fail → [Error Workflow: notify Slack + write to error DB]

Activer dans le node Settings → "Continue On Fail" + "Retry On Fail (max 3, wait 5s)".

Configurer un Error Workflow global dans Settings → Workflow → Error Workflow → sélectionner le workflow d'erreur.

6. Credentials management

• Toutes les credentials sont chiffrées at rest dans la DB n8n
• OAuth 2.0 flows automatiques pour Google / Microsoft / GitHub / Slack / etc.
• API keys génériques via "HTTP Header Auth" credential
• Variables d'env n8n (Settings → Variables) pour les configs partagées

Règle : ne JAMAIS hardcoder un token dans une expression {{$json.api_key}}. Toujours via un Credential node.

7. Code node — JavaScript ou Python

// JavaScript
const items = $input.all()
const enriched = items.map(item => {
  return {
    json: {
      ...item.json,
      timestamp: new Date().toISOString(),
      processed: true,
    },
  }
})
return enriched

# Python (via Code node Python mode)
import json
from datetime import datetime

items = _input.all()
enriched = []
for item in items:
    item_data = item.json
    item_data['timestamp'] = datetime.utcnow().isoformat()
    item_data['processed'] = True
    enriched.append({'json': item_data})
return enriched

8. Pattern : AI agent dans un workflow

[Webhook : user message]
   │
   ▼
[OpenAI Chat Model: classify intent]
   │
   ├── intent="support" ──> [Create Zendesk ticket]
   ├── intent="sales" ────> [Create HubSpot deal]
   └── intent="other" ────> [Send to Slack #general]

n8n a des nodes natifs OpenAI, Anthropic, Ollama (self-hosted), ainsi que LangChain agents pour des workflows agentic plus complexes.

9. Version control

n8n stocke les workflows dans sa DB. Pour Git :

# Export tous les workflows en JSON
n8n export:workflow --all --output=./workflows/

# Import depuis JSON
n8n import:workflow --separate --input=./workflows/

Workflow Git :

1. Export workflows en local
2. Commit les .json dans Git
3. PRs reviewed
4. Merge → CI lance n8n import:workflow sur l'instance prod

10. Comparaison Zapier vs Make vs n8n

Critère	Zapier	Make (Integromat)	n8n
Open source	❌	❌	✅
Self-hostable	❌	❌	✅
Prix	$$$ par task	$$ par operation	gratuit self-host / $$ cloud
Nodes / apps	6000+	1500+	1396
Custom code	Limité (JS)	Limité (JSON)	JS + Python complet
Workflows complexes	Linéaire	Visuel branching	Visuel branching avancé
AI nodes natifs	Limité	Limité	LangChain complet
Sovereignty / GDPR	US-hosted	EU possible	Self-host total
Migration ATUM	À éviter	OK	Recommandé

Verdict 2026 : pour les agences avec besoins GDPR ou cost control, n8n self-hosted est le meilleur choix. Pour les non-tech, n8n.cloud reste utilisable.

11. Anti-patterns

1. Hardcoded credentials dans expressions — toujours via Credential node
2. Webhooks publics sans auth — exposer endpoint signé HMAC
3. Pas de Error Workflow global — failures invisibles
4. Workflows monolithiques > 30 nodes — décomposer en sub-workflows
5. Code node pour tout — préférer les nodes spécialisés (HTTP, Set, IF)
6. Pas de retry on fail sur HTTP externes — flaky
7. Polling trop fréquent (every 1 min) sur APIs avec rate limit
8. Pas d'export Git — perte si DB n8n corrompue
9. Self-hosted single node sans backup — données perdues
10. Variables d'env hardcodées dans le workflow JSON exporté — fuite secrets

Checklist livraison

• n8n self-hosted ou cloud configuré
• HTTPS + auth basique activés
• Variables n8n pour configs partagées
• Credentials encrypted via UI
• Error Workflow global défini
• Workflows critiques exportés en JSON dans Git
• Tests manuels avec "Pin Data" sur les triggers
• Monitoring executions (Settings → Logs)
• Backup DB n8n régulier
• Plan de DR si n8n.cloud (export régulier)

Quand déléguer

• Make.com workflows → skill make-scenario-builder (ce plugin)
• Airtable schema → skill airtable-schema-manager (ce plugin)
• Notion automation → skill notion-automation (ce plugin)
• Agent no-code haut niveau → agent no-code-automation-expert (ce plugin)
• API REST custom → agent api-designer (atum-stack-backend)

Ressources

• https://docs.n8n.io/
• https://github.com/czlonkowski/n8n-mcp (MCP server officiel)
• https://github.com/czlonkowski/n8n-skills (skills cousins)
• https://community.n8n.io/