Accéder au serveur MCP de n8n

Grâce au serveur MCP intégré à n8n, connectez des clients MCP compatibles à vos workflows n8n.

Ce serveur permet à des clients tels que Lovable ou Claude Desktop de se connecter en toute sécurité à votre instance n8n. Une fois connectés, ces clients peuvent :

• Rechercher parmi les workflows marqués comme disponibles via MCP
• Récupérer les métadonnées et les informations de déclenchement des workflows
• Déclencher et exécuter les workflows exposés

Différence entre l’accès MCP au niveau de l’instance et le nœud MCP Server Trigger

L’accès MCP au niveau de l’instance vous permet de créer une seule connexion par instance n8n, avec une authentification centralisée, et de choisir quels workflows sont accessibles. Les workflows activés peuvent être facilement découverts et exécutés sans configuration individuelle pour chaque workflow.

En revanche, le nœud MCP Server Trigger est configuré à l’intérieur d’un workflow spécifique. Ce nœud expose uniquement les outils de ce workflow au protocole MCP, ce qui est utile lorsque vous souhaitez personnaliser le comportement du serveur MCP pour un workflow donné.

Points importants à retenir lors de l’utilisation de l’accès MCP au niveau de l’instance

• Il ne s’agit pas d’un moyen de créer ou modifier des workflows via un client IA ; la conception des workflows reste effectuée dans n8n.
• Tous les workflows de l’instance ne sont pas automatiquement exposés : vous devez d’abord activer l’accès MCP au niveau de l’instance, puis activer l’accès pour chaque workflow souhaité.
• L’accès n’est pas restreint par client MCP : tout client connecté peut voir l’ensemble des workflows que vous avez exposés via MCP.

Activer l’accès MCP

Pour les instances Cloud et auto-hébergées

1. Allez dans Paramètres > MCP au niveau de l’instance
2. Activez Activer l’accès MCP (nécessite les droits de propriétaire ou d’administrateur de l’instance).

Une fois activé, vous verrez :

1. La liste des workflows exposés aux clients MCP
2. La liste des clients OAuth connectés
3. L’interrupteur principal permettant d’activer ou de désactiver l’accès MCP au niveau de l’instance
4. Un bouton Détails de connexion, qui affiche des instructions détaillées pour connecter un client MCP

Désactiver : Il suffit de désactiver l’interrupteur principal MCP.

Pour les utilisateurs auto-hébergés : désactiver complètement

Pour supprimer entièrement cette fonctionnalité, définissez la variable d’environnement suivante :

N8N_DISABLED_MODULES=mcp

Cela supprimera les endpoints MCP et masquera tous les éléments d’interface utilisateur associés.

Configurer l’authentification MCP

Le menu contextuel Détails de connexion propose deux options d’authentification pour les clients MCP :

• OAuth2
• Jeton d’accès (Access Token)

Utiliser OAuth2

Depuis l’onglet OAuth, copiez l’URL de votre serveur n8n et utilisez-la pour configurer votre client MCP. Une fois la connexion établie, le client vous redirigera vers n8n pour autorisation.

Révoquer l’accès d’un client

Pour révoquer l’accès d’un client MCP déjà connecté :

1. Allez dans Paramètres > MCP au niveau de l’instance.
2. Basculez sur l’onglet Clients connectés pour voir la liste des clients OAuth.
3. Utilisez le menu d’actions de chaque ligne pour révoquer l’accès d’un client spécifique.

Utiliser un jeton d’accès

Utilisez l’URL de votre serveur n8n ainsi que le jeton d’accès personnel MCP fourni dans l’onglet Jeton d’accès du menu Détails de connexion.

À la première visite de la page d’accès MCP, n8n génère automatiquement un jeton d’accès personnel lié à votre compte utilisateur.

Attention
Copiez immédiatement votre jeton. Lors des visites ultérieures, seule une version masquée sera affichée, et le bouton de copie sera désactivé.

Renouveler le jeton

Si vous perdez votre jeton ou souhaitez le renouveler :

1. Allez dans Paramètres > MCP au niveau de l’instance.
2. Cliquez sur le bouton en haut à droite pour ouvrir le menu Détails de connexion.
3. Basculez sur l’onglet Jeton d’accès.
4. Cliquez sur le bouton à côté de la valeur masquée pour générer un nouveau jeton.

Lors de la génération d’un nouveau jeton, n8n révoque automatiquement l’ancien.

5. Mettez à jour tous vos clients MCP avec la nouvelle valeur.

Exposer un workflow aux clients MCP

Conditions requises pour un workflow

Pour être accessible à un client MCP, un workflow doit :

1. Être publié
2. Contenir l’un des déclencheurs suivants :
   • Webhook
   • Schedule (planifié)
   • Chat
   • Form (formulaire)

Par défaut, aucun workflow n’est visible par les clients MCP. Vous devez explicitement activer l’accès pour chaque workflow éligible que vous souhaitez exposer.

n8n évalue l’éligibilité uniquement sur la version publiée du workflow. Si vous ajoutez un déclencheur pris en charge dans le brouillon d’un workflow, celui-ci ne sera considéré comme éligible qu’après sa publication.

Remarque
Si vous annulez la publication d’un workflow, n8n supprime automatiquement son accès MCP. Lors d’une nouvelle publication, vous devrez réactiver manuellement l’accès.

Activer l’accès

Méthode 1 : Depuis la page des paramètres MCP (disponible à partir de n8n v2.2.0)

1. Cliquez sur le bouton Activer un workflow (affiché en haut du tableau ou à l’état vide)
2. Recherchez le workflow cible (par nom ou description) et sélectionnez-le dans la liste
3. Cliquez sur Activer pour confirmer

Méthode 2 : Depuis l’éditeur de workflow

1. Ouvrez le workflow.
2. Cliquez sur le menu principal du workflow en haut à droite (...).
3. Sélectionnez Paramètres.
4. Activez Disponible dans MCP.

Méthode 3 : Depuis la liste des workflows

1. Allez dans Workflows.
2. Ouvrez le menu de la carte du workflow.
3. Sélectionnez Activer l’accès MCP.

Gérer les accès

La page MCP au niveau de l’instance affiche tous les workflows accessibles aux clients MCP. Depuis cette liste, vous pouvez :

• Ouvrir directement le workflow, son projet ou son dossier parent
• Révoquer l’accès via le menu d’actions (ou via Désactiver l’accès MCP dans le menu de la carte)
• Mettre à jour la description du workflow via le menu d’actions (ou via l’éditeur)
• Activer l’accès pour d’autres workflows via le bouton Activer un workflow (n8n v2.2.0+)

Description des workflows

Pour aider les clients MCP à identifier les workflows, vous pouvez ajouter une description en texte libre :

1. Méthode 1 : Depuis la page MCP au niveau de l’instance
   1. Allez dans Paramètres > MCP au niveau de l’instance.
   2. Assurez-vous d’être sur l’onglet Workflows.
   3. Dans la ligne du workflow cible, utilisez le menu d’actions et choisissez Modifier la description.
   4. Ou cliquez directement sur le texte de la description pour ouvrir la boîte de dialogue d’édition.
2. Méthode 2 : Depuis l’éditeur de workflow
   1. Ouvrez le workflow.
   2. Cliquez sur le menu principal en haut à droite (...).
   3. Sélectionnez Modifier la description.

Exécuter un workflow via un client MCP

Les clients MCP peuvent exécuter des workflows éligibles selon vos demandes. Lorsqu’un client déclenche un workflow, celui-ci s’exécute normalement dans n8n, et vous pouvez surveiller son exécution dans la liste Exécutions. Une fois terminé, le client MCP reçoit le résultat.

Fournir des données d’entrée

Les clients MCP peuvent généralement déterminer les entrées nécessaires. Si vous utilisez un déclencheur Webhook et que le client a du mal à identifier les bonnes entrées, il est recommandé d’inclure ces informations dans la description du workflow.

Délai d’expiration

n8n applique un délai d’expiration de 5 minutes pour les exécutions déclenchées par un client MCP. Si le workflow ne se termine pas à temps, n8n l’arrête et renvoie une erreur au client, ignorant tout délai personnalisé défini dans les paramètres du workflow pour les déclenchements MCP.

Limitations

• Si un workflow contient plusieurs déclencheurs pris en charge, le client MCP ne pourra peut-être en utiliser qu’un seul (généralement le premier).
• Les workflows impliquant des formulaires multi-étapes ou toute interaction humaine ne sont pas pris en charge.
• Les données binaires en entrée ne sont pas prises en charge : les clients MCP ne peuvent fournir que des entrées textuelles.

Exemples

Connecter Lovable au serveur MCP de n8n

1. Configurez le serveur MCP dans Lovable (OAuth) :
   • Allez dans Paramètres de votre espace de travail > Intégrations.
   • Dans la section MCP Servers, trouvez n8n et cliquez sur Connect.
   • Saisissez l’URL de votre serveur n8n (affichée sur la page Accès MCP).
   • Enregistrez la connexion. En cas de succès, n8n vous redirigera pour autoriser Lovable.
2. Vérifiez la connexion :
   • Une fois connecté, Lovable peut interroger les workflows avec accès MCP activé.
   • Exemple : Demandez à Lovable de créer une interface utilisateur permettant de lister et supprimer des utilisateurs via un workflow n8n.

Connecter Claude Desktop au serveur MCP de n8n

Avec OAuth2

1. Dans Claude Desktop, allez dans Paramètres > Connecteurs.
2. Cliquez sur Ajouter un connecteur personnalisé.
3. Saisissez les informations suivantes :
   • Nom : n8n MCP
   • URL du serveur MCP distant : votre URL de base n8n (affichée sur la page MCP au niveau de l’instance)
4. Enregistrez le connecteur.
5. À l’invite, autorisez Claude Desktop à accéder à votre instance n8n.

Avec un jeton d’accès

Remarque
Cette méthode nécessite la dernière version de Node.js.

Ajoutez l’entrée suivante à votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://<YOUR_N8N_HOST>/mcp-server/http",
        "--header",
        "authorization: Bearer <YOUR_TOKEN>"
      ]
    }
  }
}

Remplacez :

• <YOUR_N8N_HOST> par votre URL de base n8n (affichée sur la page MCP au niveau de l’instance)
• <YOUR_TOKEN> par votre jeton généré

Connecter Claude Code au serveur MCP de n8n

Utilisez la commande CLI suivante :

claude mcp add --transport http n8n-mcp https://<YOUR_N8N_HOST>/mcp-server/http \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Ou ajoutez l’entrée suivante à votre fichier claude.json (en remplaçant les mêmes valeurs que ci-dessus).

Connecter Codex CLI au serveur MCP de n8n

Ajoutez l’entrée suivante à votre fichier ~/.codex/config.toml :

[mcp_servers.n8n_mcp]
command = "npx"
args = [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<YOUR_N8N_HOST>/mcp-server/http",
    "--header",
    "authorization:Bearer <YOUR_TOKEN>"
]

(Remplacez les espaces réservés par votre URL de base n8n et votre jeton.)

Connecter un agent Google ADK au serveur MCP de n8n

Voici un exemple de code pour créer un agent connecté à un serveur MCP n8n distant :

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://localhost:5678"
N8N_MCP_TOKEN = "YOUR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={"Authorization": f"Bearer {N8N_MCP_TOKEN}"},
            ),
        )
    ],
)

Pour plus de détails, consultez Connect ADK agent to n8n.

Dépannage

Si vous rencontrez des problèmes lors de la connexion d’un client MCP à votre instance n8n, vérifiez les points suivants :

• Si vous utilisez un client MCP basé sur le cloud, assurez-vous que votre instance n8n est accessible publiquement.
• Vérifiez que l’accès MCP est activé dans les paramètres de n8n.
• Confirmez que le workflow cible est marqué comme disponible dans MCP.
• Assurez-vous que le mode d’authentification (OAuth2 ou jeton d’accès) est correctement configuré dans le client MCP.
• Consultez les journaux du serveur n8n pour détecter d’éventuelles erreurs liées aux connexions MCP.
• Si vous utilisez un client MCP de bureau, assurez-vous d’avoir installé la dernière version de Node.js.