Démarrage rapide avec Claude¶
Le chemin le plus rapide pour piloter Axonaut en langage naturel. Comptez 3 à 5 minutes.
Ce que vous allez obtenir¶
À la fin de ce guide, vous pourrez ouvrir une conversation Claude et taper :
« Liste-moi les 5 dernières factures impayées de mon compte Axonaut. »
… et Claude vous répondra avec les vraies données de votre compte, sans que vous ayez à coller de clé API ou à ouvrir un tableur.
Prérequis¶
- Un compte Axonaut actif (axonaut.com)
- Votre clé API Axonaut — comment la récupérer (30 secondes)
- Un compte Claude — Free suffit pour tester, mais Pro/Team recommandés pour un usage réel (claude.ai)
Étape 1 — Ajouter le connecteur Axonaut à Claude¶
- Ouvrez claude.ai et connectez-vous.
- Cliquez sur votre avatar en bas à gauche → Settings → Connectors (Connecteurs).
- Cliquez sur Add custom connector (Ajouter un connecteur personnalisé).
- Renseignez :
| Champ | Valeur |
|---|---|
| Name | Axonaut |
| Remote MCP server URL | https://mcp.axonaut.com/mcp |
| Advanced settings | laissez vide |
- Cliquez sur Add.
Étape 2 — Autoriser la connexion (OAuth)¶
Une pop-up s'ouvre et vous redirige vers Auth0, le fournisseur d'identité d'Axonaut.
- Créez un compte Auth0 avec votre email pro Axonaut (ou connectez-vous via Google).
- Auth0 vous demande votre clé API Axonaut — c'est le pont entre votre identité et votre compte. Collez-la et validez.
- Cliquez sur Autoriser. La pop-up se ferme, le connecteur Axonaut apparaît avec le statut Connected.
Étape critique : cette étape ne se répète pas
Une fois votre clé API enregistrée dans Auth0, toutes vos futures connexions Claude/ChatGPT retrouveront automatiquement votre clé. Vous n'aurez plus à la coller.
Étape 3 — Utiliser le connecteur dans une conversation¶
- Créez une nouvelle conversation Claude.
- Sous la zone de saisie, cliquez sur 📎 (paperclip) → cochez Axonaut.
- Tapez votre première question, par exemple :
« Combien de factures ai-je créées ce mois-ci ? »
Claude va :
- Détecter le tool
list_invoicespertinent. - Vous demander confirmation (avec les arguments qu'il va envoyer).
- Appeler l'API Axonaut avec votre clé.
- Vous répondre avec les vraies données.
Vous êtes en production.
Exemples pour votre première session¶
Une fois connecté, testez ces prompts :
Lecture (aucun risque, aucune modification) :
- « Trouve les 10 dernières entreprises créées dans Axonaut. »
- « Quelles sont mes opportunités ouvertes de plus de 5 000 € ? »
- « Résume-moi les tickets ouverts avec priorité haute ou urgente. »
- « Liste les factures impayées émises il y a plus de 30 jours. »
Écriture (avec confirmation demandée par Claude) :
- « Crée un ticket de priorité "normale" sur l'entreprise Acme SA : "Test intégration MCP". »
- « Ajoute un événement de type "meeting" sur l'opportunité Migration Cloud pour vendredi à 14h. »
- « Marque l'opportunité #4521 comme gagnée. »
Claude vous montre systématiquement les arguments avant d'appeler un outil d'écriture. Vous pouvez toujours refuser ou modifier.
Aller plus loin¶
- Guide complet Claude (Web + Desktop) — modes stdio, création de projets, filtres avancés.
- Connecter ChatGPT — même expérience, sur ChatGPT Plus/Team/Enterprise.
- Catalogue des 74 outils — la liste exhaustive de ce que Claude peut faire dans votre compte.
- Récupération de la clé API — si vous ne l'avez pas encore.
Vous préférez l'automatisation no-code ?¶
Si votre besoin n'est pas conversationnel — vous voulez déclencher des actions Axonaut depuis un formulaire web, une réception d'email, un webhook Slack — utilisez plutôt :
L'authentification est différente : vous collez directement votre clé API en Bearer token dans le module MCP, sans passer par OAuth.
Dépannage express¶
« Impossible de s'inscrire auprès du service de connexion »
Votre navigateur bloque la pop-up OAuth. Autorisez les pop-ups pour claude.ai, désactivez temporairement AdBlock/uBlock, et retentez.
Le connecteur est actif mais aucun outil n'apparaît
Vous avez oublié de le cocher dans la conversation : icône 📎 sous la zone de texte → cocher Axonaut → renvoyer votre message.
« 401 Unauthorized » sur les appels
Votre session OAuth a expiré ou votre clé API a été régénérée. Retournez dans Settings → Connectors → Axonaut → Reconnect.
Plus de solutions : voir la section « Dépannage » du guide complet Claude.
Besoin d'aide ?
📧 Support : support@axonaut.com 📚 Documentation MCP : modelcontextprotocol.io