Utiliser le serveur MCP Axonaut avec Make¶

Introduction¶

Make.com propose un module MCP Client qui vous permet de connecter vos scénarios à des serveurs MCP externes, comme le serveur MCP Axonaut. Cette intégration vous permet d'utiliser les outils Axonaut directement dans vos workflows Make, sans configuration complexe.

Le MCP Client est disponible en version bêta pour tous les utilisateurs Make.

Qu'est-ce que le MCP Client ?¶

Le MCP Client dans Make est une application qui :

Se connecte à des serveurs MCP distants via leur URL
Charge automatiquement tous les outils disponibles sur le serveur
Permet de mapper visuellement les entrées et sorties
Supporte l'authentification par API Key / Access token
S'intègre parfaitement dans le Scenario Builder de Make

Configuration du MCP Client¶

Étape 1 : Ajouter le module MCP Client¶

Dans votre scénario Make, cliquez sur le bouton + pour ajouter un nouveau module
Recherchez "MCP Client" dans la liste des applications
Sélectionnez l'application MCP Client ensuite Call a tool

Étape 2 : Créer une connexion au serveur Axonaut¶

Une fois le module MCP Client ajouté, vous devez configurer la connexion au serveur MCP Axonaut :

Cliquez sur "Create a connection"
Remplissez les informations de connexion :
Connection name* : Donnez un nom à votre connexion (par exemple : "Axonaut MCP Server")
MCP Server : Sélectionnez "New MCP server"
URL* : Entrez https://mcp.axonaut.com/mcp (ou https://mcp-server.axonaut.com/mcp)
API Key / Access token : Entrez votre clé API Axonaut

!!! info "Obtenir votre clé API Axonaut" Pour obtenir votre clé API Axonaut, rendez-vous dans votre compte Axonaut, cliquez sur la clé à molette (en haut à droite) > API > cliquez sur "Afficher votre clé API".

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.

Cliquez sur "Save" pour enregistrer la connexion

Étape 3 : Sélectionner un outil (Tool)¶

Une fois la connexion établie, Make charge automatiquement tous les outils disponibles sur le serveur MCP Axonaut :

Dans le menu déroulant "Tool", sélectionnez l'outil que vous souhaitez utiliser
Les champs d'entrée nécessaires s'affichent automatiquement
Make indique clairement quels champs sont obligatoires et lesquels sont optionnels

Étape 4 : Configurer les paramètres de l'outil¶

Pour chaque outil sélectionné :

Remplissez les champs obligatoires (marqués d'un astérisque *)
Mappez les données depuis les modules précédents de votre scénario si nécessaire
Configurez les champs optionnels selon vos besoins

Conseil

Utilisez les descriptions d'aide affichées par Make pour comprendre ce que chaque champ attend comme données.

Étape 5 : Tester l'outil¶

Cliquez sur "Run once" pour tester votre scénario
Vérifiez que l'outil s'exécute correctement
Examinez la réponse retournée par le serveur MCP

Utilisation des outils MCP dans vos scénarios¶

Les outils MCP Client peuvent être utilisés comme n'importe quel autre module Make dans vos scénarios. Vous pouvez :

Déclencher un outil MCP suite à un webhook, un email, une mise à jour dans une base de données, etc.
Chaîner plusieurs outils MCP pour créer des workflows complexes
Combiner les outils MCP avec d'autres applications Make (Google Sheets, Slack, Gmail, etc.)
Utiliser les réponses des outils MCP dans les modules suivants de votre scénario

Créer un AI Agent avec MCP¶

Les AI Agents de Make permettent de créer des assistants intelligents qui peuvent utiliser les outils MCP de manière autonome. Un agent peut analyser les demandes des utilisateurs et choisir automatiquement les bons outils MCP à exécuter.

Étape 1 : Accéder à AI Agents¶

Dans le menu de navigation à gauche de Make, cliquez sur "AI Agents"
Cliquez sur le bouton "Create agent"

Étape 2 : Configurer l'agent¶

Une fenêtre de création s'affiche avec plusieurs champs à remplir :

Connection*¶

Attention

Ce champ "Connection" concerne la connexion au service de modèle de langage (OpenAI, Claude, etc.) et n'est pas la même chose que la connexion MCP Client créée précédemment.

Cliquez sur "Add" pour créer une nouvelle connexion vers un service d'IA
Sélectionnez le fournisseur (OpenAI, Anthropic Claude, etc.)
Entrez vos identifiants API

Agent name*¶

Donnez un nom descriptif à votre agent (par exemple : "Customer service agent")
Le nom doit clairement refléter le rôle de l'agent
Maximum 256 caractères

Suggestion

Choisissez un nom qui indique clairement ce que fait l'agent, par exemple : "Assistant Axonaut", "Agent de support client", "Agent de création de devis"

Model*¶

Sélectionnez le modèle de langage à utiliser
Disponible : modèles OpenAI (GPT-3.5, GPT-4, etc.) et autres modèles compatibles
Vous pouvez activer l'option "Map" pour mapper dynamiquement le modèle

System prompt*¶

C'est ici que vous définissez le comportement et les instructions de votre agent.

Exemple de system prompt :

JSON

Tu es un assistant qui aide les utilisateurs à gérer leurs données Axonaut.
Tu peux rechercher des clients, créer des devis, et récupérer des informations 
sur les factures en utilisant les outils disponibles. 

Sois toujours courtois et professionnel. Si tu ne peux pas effectuer une action,
explique clairement pourquoi et propose des alternatives.

Bonnes pratiques pour le system prompt

Définissez clairement le rôle et l'objectif de l'agent
Indiquez le comportement attendu (ton, style de réponse)
Mentionnez les contraintes ou limitations
Donnez des exemples de situations si nécessaire

Cliquez sur "Save" pour créer l'agent

Étape 3 : Configurer les outils MCP pour l'agent¶

Une fois l'agent créé, vous accédez à une interface de configuration pour ajouter les outils MCP que l'agent pourra utiliser.

Si vous avez déjà des connexions MCP configurées :¶

Les connexions MCP existantes s'affichent automatiquement dans la liste
Pour chaque connexion, vous pouvez sélectionner les outils spécifiques que l'agent est autorisé à utiliser
Cochez uniquement les outils pertinents pour le rôle de cet agent

Exemple

Si votre agent est spécialisé dans la gestion des clients, activez uniquement les outils liés aux clients (recherche client, création client, mise à jour client) et désactivez les outils de facturation.

Si vous n'avez pas encore de connexion MCP :¶

Cliquez sur "Add connection" dans l'interface de configuration de l'agent
Suivez la même procédure que pour créer une connexion MCP Client (voir Étape 2 ci-dessus) :
Connection name : "Axonaut MCP Server"
MCP Server : "New MCP server"
URL : https://mcp.axonaut.com/mcp (ou https://mcp-server.axonaut.com/mcp)
API Key / Access token : Votre clé API Axonaut
Une fois la connexion créée, sélectionnez les outils autorisés pour cet agent

Étape 4 : Utiliser l'agent dans un scénario¶

Pour utiliser votre AI Agent dans un workflow Make :

Créez un nouveau scénario ou ouvrez un scénario existant
Ajoutez un module "Make AI Agents" : recherchez "AI Agents" et sélectionnez "Run Agent"
Configurez le module :
Sélectionnez l'agent que vous avez créé
Mappez le message/prompt de l'utilisateur
Configurez les paramètres additionnels si nécessaire
Ajoutez des modules de sortie pour utiliser la réponse de l'agent (envoi d'email, message Slack, etc.)

Exemple de workflow complet avec AI Agent¶

Exemple de workflow complet

Pipeline :

Trigger : Slack > New Message Posted to Channel
Make AI Agents > Run Agent
- Agent : "Assistant Axonaut"
- Prompt : {{1.text}} (le message Slack)
Slack > Create a Message
- Channel : {{1.channel}}
- Thread : {{1.thread_ts}}
- Message : {{2.response}} (la réponse de l'agent)

Dans cet exemple :

Un utilisateur envoie un message dans Slack : "Recherche le client ABC et crée-lui un devis"
L'agent reçoit le message, comprend l'intention
L'agent exécute automatiquement les outils MCP nécessaires (recherche client, création de devis)
L'agent formule une réponse claire
La réponse est envoyée dans le même thread Slack

Gestion des outils pour l'agent¶

Bonnes pratiques¶

Limitez les outils : N'activez que les outils nécessaires pour le rôle de l'agent
Organisez par domaine : Créez des agents spécialisés plutôt qu'un agent universel
Testez les permissions : Vérifiez que l'agent n'a accès qu'aux outils appropriés

Exemples d'agents spécialisés¶

Agent Support Client :

Outils : Rechercher client, Consulter factures, Consulter historique
System prompt : Focus sur l'assistance et la résolution de problèmes

Agent Commercial :

Outils : Rechercher client, Créer devis, Créer opportunité
System prompt : Focus sur la vente et la qualification

Agent Comptabilité :

Outils : Consulter factures, Générer rapports, Export données
System prompt : Focus sur les données financières et le reporting

Avantages du MCP Client dans Make¶

✅ Pas de code : Configuration 100% visuelle dans le Scenario Builder

✅ Sécurisé : Authentification par API Key, sans exposer les credentials

✅ Automatique : Les outils disponibles se chargent automatiquement

✅ Flexible : Mapping visuel des données avec validation de schéma

✅ Intégrable : Fonctionne avec tous les modules Make existants

✅ Intelligent : Compatible avec les AI Agents pour des workflows autonomes

Dépannage¶

Le serveur MCP ne se connecte pas¶

Vérifiez que l'URL est correcte : https://mcp.axonaut.com/mcp (ou https://mcp-server.axonaut.com/mcp)
Assurez-vous que votre clé API Axonaut est valide et active
Vérifiez que vous avez les droits d'accès nécessaires sur votre compte Axonaut

Les outils ne s'affichent pas¶

Vérifiez que la connexion au serveur MCP est bien enregistrée
Testez la connexion en essayant de sélectionner un outil
Rechargez la page ou le module si nécessaire

L'outil retourne une erreur¶

Vérifiez que tous les champs obligatoires sont remplis
Assurez-vous que les données mappées sont au bon format
Consultez les logs de Make (clic droit sur le module > "Show execution details") pour plus de détails sur l'erreur
Vérifiez que votre clé API a les permissions nécessaires pour l'action demandée

L'agent ne répond pas correctement¶

Vérifiez que le system prompt est clair et détaillé
Assurez-vous que les bons outils MCP sont activés pour l'agent
Testez avec des prompts plus explicites
Vérifiez les logs d'exécution de l'agent

L'agent n'utilise pas les bons outils¶

Améliorez les descriptions des outils dans votre serveur MCP
Soyez plus précis dans le system prompt sur quand utiliser chaque outil
Limitez le nombre d'outils disponibles pour éviter la confusion

Bonnes pratiques¶

Nommage des connexions¶

Utilisez des noms de connexion clairs qui indiquent l'environnement :

"Axonaut Production"
"Axonaut Test"
"Axonaut - Compte Client X"

Gestion des erreurs¶

Ajoutez toujours un gestionnaire d'erreurs après vos modules MCP Client pour gérer les cas où :

Le serveur est temporairement indisponible
Les données fournies sont invalides
La limite de requêtes API est atteinte

Optimisation des scénarios¶

Limitez le nombre de requêtes : Regroupez les opérations quand c'est possible
Utilisez les filtres : Ajoutez des filtres entre les modules pour éviter les exécutions inutiles
Mettez en cache : Pour les données qui changent peu, utilisez un Data Store Make pour éviter des appels répétés

Optimisation des AI Agents¶

System prompts clairs : Plus le prompt est détaillé, meilleure sera la performance
Agents spécialisés : Créez plusieurs agents pour différents cas d'usage plutôt qu'un seul agent généraliste
Test et itération : Testez régulièrement vos agents et ajustez les prompts selon les résultats
Limitation des outils : N'activez que les outils nécessaires pour chaque agent

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.