Connecter Claude à Axonaut¶

Claude (Anthropic) est le client IA le plus populaire pour utiliser le serveur MCP Axonaut. Claude Web (claude.ai) et Claude Desktop (macOS/Windows) utilisent exactement le même flow de connexion OAuth via l'UI Connectors — aucune configuration locale à faire, dans un cas comme dans l'autre.

Les deux exposent les mêmes 74 outils MCP (42 de lecture, 32 d'écriture).

Prérequis¶

Un compte Axonaut actif avec une clé API (comment la récupérer)
Un compte Anthropic (Claude Free, Pro, Team ou Enterprise)
Claude Web ou Claude Desktop installé et connecté

L'URL du serveur MCP Axonaut est :

Text Only

https://mcp.axonaut.com/mcp

Connexion (Claude Web & Claude Desktop)¶

Mêmes étapes dans les deux cas — seule l'app change (navigateur vs application native).

Étape 1 — Ouvrir les paramètres de connecteurs¶

Claude Web : connectez-vous à claude.ai. Claude Desktop : ouvrez l'application.
Cliquez sur votre avatar → Settings (ou Paramètres).
Dans le menu de gauche, cliquez sur Connectors (ou Connecteurs).
Cliquez sur Ajouter → Add custom connector (ou Ajouter un connecteur personnalisé).

Étape 2 — Renseigner l'URL du serveur MCP¶

Dans le formulaire :

Name : Axonaut
Remote MCP server URL : https://mcp.axonaut.com/mcp
Advanced settings : laissez vide (Claude découvre automatiquement le flow OAuth via /.well-known/oauth-authorization-server).
Cliquez sur Add (ou Ajouter).
Dans la nouvelle fenêtre, cliquez sur Connecter.

Étape 3 — Autoriser la connexion¶

Claude ouvre une pop-up qui redirige vers la page d'authentification au MCP Axonaut.

Créer votre compte sur le MCP Axonaut ou vous connecter avec Google.
À la première connexion, le MCP vous demandera de saisir votre clé API Axonaut — c'est le pont entre votre identité MCP et votre compte Axonaut. Cette étape ne se répète pas.
Cliquez sur Autoriser — la fenêtre se ferme et le connecteur Axonaut apparaît comme actif dans Claude.

Sur Claude Desktop, les tokens OAuth sont stockés localement dans le keychain système — aucun fichier de config à éditer, aucune clé en clair sur le disque.

Vous êtes prêt

Dans n'importe quelle conversation Claude, vous pouvez maintenant demander par exemple : « Liste-moi les 5 dernières factures impayées de mon compte Axonaut. » Claude va détecter le tool list_invoices et l'appeler avec votre clé.

Étape 4 — Activer le connecteur par conversation¶

Dans une conversation Claude :

Cliquez sur l'icône 📎 (attach / paperclip) sous la zone de texte.
Sélectionnez le connecteur Axonaut dans la liste des connectors actifs.
Envoyez votre message. Claude aura accès à tous les 74 outils MCP d'Axonaut.

Utilisation quotidienne¶

Exemples de prompts qui fonctionnent bien¶

Lecture : « Combien de tickets support ouverts ai-je aujourd'hui ? » « Trouve la dernière facture émise à l'entreprise Acme SA. » « Résume les événements de la semaine sur l'opportunité "Migration Cloud X". »
Écriture (avec confirmation) : « Crée un ticket de priorité normale sur l'entreprise Acme SA : "Panne serveur de mail". » « Envoie un email à Claire Rousseau depuis Axonaut pour proposer un rendez-vous vendredi. »

Claude vous demande toujours confirmation avant d'appeler un outil d'écriture (create/update/mark/send). Vous pouvez inspecter les arguments exacts avant validation.

Filtres avancés¶

Les outils qui listent des ressources supportent des filtres. Exemples :

« Liste-moi les devis créés entre le 1er et le 30 juin 2026. » → Claude passe creation_date_after: "2026-06-01" + creation_date_before: "2026-06-30" à list_quotations.
« Trouve toutes les opportunités B2B non closes. » → Claude filtre côté serveur via list_opportunities avec les bonnes options.

Dépannage¶

« Impossible de s'inscrire auprès du service de connexion » — Claude n'a pas pu terminer l'enregistrement dynamique auprès d'Auth0. Vérifiez que votre navigateur autorise les pop-ups pour claude.ai, désactivez temporairement les extensions bloquantes (AdBlock, uBlock) et retentez.

« Callback URL mismatch » sur l'écran Auth0 — l'URL du connecteur (https://mcp.axonaut.com/mcp) n'est pas dans les callbacks whitelistés de l'app Auth0. Contactez le support Axonaut.

Le connecteur est actif mais aucun outil n'apparaît — cliquez sur l'icône 📎 et activez explicitement le connecteur Axonaut dans la conversation. Sans ça, Claude ne voit pas les tools même s'ils sont enregistrés.

« 401 Unauthorized » sur les appels de tool — votre clé API Axonaut n'est plus valide ou n'a pas été enregistrée dans Auth0. Reconnectez-vous au connecteur : Settings → Connectors → Axonaut → Reconnect.

Autres erreurs — consultez le catalogue des outils pour les paramètres attendus, ou contactez le support.