Connecteur n8n
n8n est un outil d'automatisation de workflows. Le connecteur appelle l'API publique REST de n8n pour lister, créer, activer et supprimer des workflows, et pour lire les exécutions.
Mesuré le 2026-10-03 dans connectors/n8n.yaml : 49 outils.
| Méthode HTTP | Outils |
|---|---|
| GET | 20 |
| POST | 12 |
| DELETE | 8 |
| PUT | 7 |
| PATCH | 2 |
Ce que déclare le fichier
| Propriété | Valeur |
|---|---|
| Fichier | connectors/n8n.yaml |
| Protocole | API REST, chemins sous /api/v1/ |
| Authentification | clé d'API en en-tête X-N8N-API-KEY, lue dans N8N_API_KEY |
| Adresse de l'instance | variable N8N_URL |
| Licence déclarée | Sustainable-Use (fair-code, source disponible) |
Le catalogue métier la libelle « Sustainable-Use (fair-code, source-available) ».
Outils
Les noms n'ont pas de préfixe de connecteur. Répartition par ressource, mesurée sur les 49 outils :
| Ressource | Outils | Exemples réels |
|---|---|---|
workflows | 12 | workflows_list, workflows_get, workflows_create, workflows_activate, workflows_deactivate, workflows_delete |
projects | 8 | projects_list, projects_create, projects_users_create |
executions | 7 | executions_list, executions_get, executions_retry, executions_list_failed |
tags | 6 | tags_list, tags_create |
users | 5 | users_list, users_change_role |
variables | 5 | variables_list, variables_create |
credentials | 4 | credentials_create, credentials_get_schema |
sourcecontrol, audit | 1 chacune | sourcecontrol_pull, audit_create |
Il n'existe pas d'outil qui lance un workflow à la demande : ni n8n_execute_workflow, ni équivalent. Le connecteur sait activer ou désactiver un workflow, relancer une exécution (executions_retry) et lire l'historique.
Le connecteur crée et supprime aussi des utilisateurs, des identifiants et des variables d'une instance n8n. Donnez à la clé d'API les seuls droits nécessaires.
Huit chemins de confort qui n'existent pas
Un avertissement du 2026-09-05, en tête du fichier, rapporte une mesure sur une instance vivante. Huit outils de commodité (comptage des exécutions, statistiques, workflows actifs, utilisateur courant) visaient des chemins absents de la spécification que sert n8n lui-même. Vérifié le 2026-10-03 : aucun de ces huit noms ne figure parmi les 49 outils actuels. La capacité existe en passant par les chemins réels (par exemple la liste des exécutions avec un filtre de statut) ; elle est à reprendre, pas à supposer.
Configuration
| Variable | Rôle |
|---|---|
N8N_URL | Adresse de l'instance n8n |
N8N_API_KEY | Clé d'API n8n |
Dans l'application : page Identifiants (/credentials), fiche n8n Automation, champs « URL du serveur » et « API Key ».
Le connecteur envoie le User-Agent mgaas-connector/1.0. Un User-Agent contenant « bot » fait répondre n8n par un corps vide (mesure du 2026-07-03 consignée dans le fichier).
Déploiement
podman-compose.vps2.yml déploie un service n8n (image officielle, base Postgres partagée, volume qui conserve la clé de chiffrement de n8n). L'entrée du catalogue métier a le statut available.
Exemple
Active le workflow « Synchronisation clients ».
L'agent retrouve le workflow avec workflows_list, puis appelle workflows_activate.
Fichier source
connectors/n8n.yaml
Voir aussi
- Vue d'ensemble — chiffres mesurés, chargement et règles communes aux douze connecteurs
- Créer votre premier connecteur MCP — forme d'un fichier YAML et ajout d'un connecteur à la passerelle
- Routes MCP — ouvrir une session et appeler un outil par JSON-RPC
- Tarification — nombre de connecteurs métier inclus dans chaque offre
- Migration depuis d'autres outils — coexister avec une instance n8n existante pendant la migration