Aller au contenu

Utiliser le serveur MCP Axonaut avec n8n

Introduction

n8n est une plateforme d'automatisation open-source qui propose un node AI Agent intégré. Ce node permet de créer des agents intelligents capables d'utiliser des outils externes via le protocole MCP (Model Context Protocol).

Cette documentation vous guide pour connecter votre agent n8n au serveur MCP Axonaut.

Prérequis

  • Un compte n8n (cloud ou auto-hébergé)
  • Une clé API Axonaut
  • Un modèle LLM compatible avec les Tool Calls (recommandé : GPT-4 Turbo Mini ou similaire)

Configuration de l'AI Agent

Étape 1 : Créer un workflow

  1. Connectez-vous à votre compte n8n
  2. Créez un nouveau workflow
  3. Dans la palette de nodes, recherchez "AI Agent"
  4. Ajoutez le node AI Agent à votre canvas

Étape 2 : Configurer l'AI Agent

  1. Cliquez sur le node AI Agent pour ouvrir sa configuration
  2. Configurez les paramètres de base et cliquez sur "Validate"

Une fois validé, le node AI Agent affiche visuellement trois sections principales :

  • Model : Le modèle de langage à utiliser
  • Memory : La mémoire conversationnelle de l'agent
  • Tool : Les outils que l'agent peut utiliser

Étape 3 : Configurer le modèle (Model)

  1. Cliquez sur la section "Model"
  2. Sélectionnez un modèle de langage compatible avec les Tool Calls

Compatibilité des modèles

Tous les modèles ne supportent pas les Tool Calls. Pour vos tests, utilisez de préférence :

  • GPT-4 Turbo Mini (gpt-4-1106-preview)
  • GPT-4o Mini
  • GPT-3.5 Turbo (version récente)

Ces modèles ont été testés et fonctionnent correctement avec les outils MCP.

Étape 4 : Configurer la mémoire (Memory)

  1. Cliquez sur la section "Memory"
  2. Pour les tests, la "Built-in Memory" (mémoire intégrée) est suffisante
  3. Vous pouvez ajuster la configuration selon vos besoins

Étape 5 : Ajouter l'outil MCP Client

  1. Cliquez sur la section "Tool"
  2. Cliquez sur le bouton "+" pour ajouter un nouvel outil
  3. Une nouvelle page s'affiche avec la liste des outils pré-construits
  4. Sélectionnez "MCP Client" dans la liste

Configuration du MCP Client

Une fois le MCP Client sélectionné, vous accédez à la page de configuration avec l'onglet "Settings".

Paramètres requis

Endpoint*

Entrez l'URL du serveur MCP Axonaut :

JSON
https://mcp.axonaut.com/mcp
ou

JSON
https://mcp-server.axonaut.com/mcp

Important : le suffixe /mcp

L'URL doit obligatoirement se terminer par /mcp. C'est une spécificité de n8n pour le protocole MCP. Sans ce suffixe, la connexion ne fonctionnera pas.

Server Transport*

Sélectionnez : HTTP Streamable

Authentication*

Sélectionnez : Bearer Auth

Credential for Bearer Auth*

Vous devez créer une nouvelle credential pour l'authentification :

  1. Cliquez sur "Create New Credential" ou le bouton "+"
  2. Une fenêtre s'ouvre pour créer les credentials
  3. Entrez votre clé API Axonaut dans le champ dédié

Obtenir votre clé API Axonaut

Pour obtenir votre clé API Axonaut :

  1. Connectez-vous à votre compte Axonaut
  2. Cliquez sur la clé à molette (en haut à droite)
  3. Allez dans API
  4. Cliquez sur "Afficher votre clé API"
  5. Copiez la clé affichée
  1. Donnez un nom à vos credentials (par exemple : "Axonaut API")
  2. Cliquez sur "Save" pour enregistrer
  3. Vous êtes automatiquement redirigé vers la page Settings
  4. Sélectionnez les credentials que vous venez de créer dans le menu déroulant

Tools to Include

Une fois que vous avez fourni l'endpoint et les credentials, cette section se remplit automatiquement avec la liste des outils disponibles sur le serveur MCP Axonaut.

Vous pouvez :

  • All : Autoriser tous les outils (par défaut)
  • Selected : Sélectionner uniquement certains outils spécifiques

Conseil

Pour un agent spécialisé, limitez les outils disponibles aux fonctions nécessaires. Cela améliore la précision de l'agent et réduit les risques d'erreur.

Options

Cette section permet de configurer des options avancées si nécessaire. Pour la plupart des cas d'usage, les options par défaut sont suffisantes.

Étape 6 : Tester la configuration

  1. Fermez la fenêtre de configuration du MCP Client
  2. Vous revenez sur le node AI Agent
  3. Ajoutez un trigger (par exemple : Webhook, Schedule, Chat Trigger)
  4. Ajoutez un node de sortie pour visualiser les réponses de l'agent
  5. Cliquez sur "Execute Node" ou "Test Workflow"

Exemple de workflow complet

Voici un exemple de workflow n8n avec l'AI Agent et MCP :

  1. Chat Trigger : Démarre le workflow avec un message utilisateur

  2. AI Agent

    • Model : GPT-4 Turbo Mini
    • Memory : Built-in Memory
    • Tool : MCP Client (Axonaut)

  3. Respond to Webhook : Retourne la réponse de l'agent à l'utilisateur

Utilisation des outils MCP

Une fois configuré, votre agent peut utiliser automatiquement les outils Axonaut. Par exemple :

Utilisateur : "Recherche le client ABC dans Axonaut"

Agent : 1. Comprend l'intention (recherche de client) 2. Utilise automatiquement l'outil MCP "Rechercher un client" 3. Récupère les informations depuis Axonaut 4. Formule une réponse claire avec les données obtenues

Dépannage

Le serveur MCP ne se connecte pas

  • Vérifiez que l'URL se termine bien par /mcp
  • Assurez-vous que votre clé API Axonaut est valide
  • Vérifiez que le Server Transport est bien "HTTP Streamable"

Les outils ne s'affichent pas

  • Vérifiez que les credentials sont correctement configurés
  • Testez la connexion en cliquant sur "Test Connection" si disponible
  • Vérifiez que votre clé API a les permissions nécessaires

L'agent n'utilise pas les outils

  • Vérifiez que vous utilisez un modèle compatible avec les Tool Calls
  • Essayez avec GPT-4 Turbo Mini ou GPT-4o Mini
  • Assurez-vous que les outils sont bien activés dans "Tools to Include"

Erreur d'authentification

  • Régénérez une nouvelle clé API Axonaut si nécessaire
  • Vérifiez qu'il n'y a pas d'espaces avant ou après la clé API
  • Testez la clé API directement dans l'interface Axonaut

Modèles recommandés

Les modèles suivants ont été testés et fonctionnent correctement avec les Tool Calls :

Modèle Provider Tool Calls Recommandation
GPT-4 Turbo Mini OpenAI ✅ Oui ⭐ Recommandé pour les tests
GPT-4o Mini OpenAI ✅ Oui ⭐ Recommandé (économique)
GPT-4 Turbo OpenAI ✅ Oui Pour la production
GPT-3.5 Turbo OpenAI ✅ Oui (récent) Tests basiques
Claude 3.5 Sonnet Anthropic ✅ Oui Alternative à GPT-4

Attention

Les modèles plus anciens ou certains modèles open-source peuvent ne pas supporter les Tool Calls. Vérifiez toujours la compatibilité avant de configurer votre agent.

Bonnes pratiques

Sécurité

  • Ne partagez jamais votre clé API Axonaut
  • Utilisez des credentials séparées pour chaque environnement (dev, staging, production)
  • Limitez les permissions de la clé API au strict nécessaire

Performance

  • Limitez les outils : N'activez que les outils nécessaires pour votre cas d'usage
  • Choisissez le bon modèle : Utilisez GPT-4o Mini pour un bon équilibre coût/performance
  • Configurez la mémoire : Ajustez la taille de la mémoire selon vos besoins

Organisation

  • Nommez clairement vos workflows et credentials
  • Documentez vos prompts système pour faciliter la maintenance
  • Testez régulièrement après chaque modification

Ressources supplémentaires

Cette documentation fait partie du projet de documentation du serveur MCP Axonaut. Pour toute question, consultez les autres sections de la documentation.