Aller au contenu

Récupérer sa clé API Axonaut

Votre clé API Axonaut est le pass qui autorise le serveur MCP (et donc Claude, ChatGPT, ou tout autre client IA connecté) à agir en votre nom sur votre compte Axonaut : lire vos entreprises, créer un devis, ouvrir un ticket, etc.

Chaque utilisateur Axonaut a sa propre clé. Elle est nominative — les actions faites via MCP apparaîtront dans les logs d'audit d'Axonaut comme si vous les aviez faites vous-même.

Où trouver la clé

  1. Connectez-vous à axonaut.com.
  2. En haut à droite, cliquez sur l'icône clé à molette (⚙️).
  3. Dans le menu de gauche, cliquez sur API.
  4. Cliquez sur « Afficher votre clé API ».
  5. Copiez la clé qui s'affiche — c'est une chaîne du type xxxx_xxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Traitez cette clé comme un mot de passe

Elle donne un accès complet à votre compte Axonaut (dans les limites de vos permissions utilisateur). Ne la partagez pas, ne la commitez pas dans Git, ne la collez pas dans un chat public. Si elle fuite, régénérez-la immédiatement depuis la même page.

Deux façons d'utiliser la clé avec MCP

1. Directement en Bearer token (Make, n8n, Zapier, scripts)

Vous fournissez la clé au client d'automatisation. Chaque appel MCP transporte la clé dans un header Authorization: Bearer <clé>. C'est la méthode la plus rapide à mettre en place.

Voir : Zapier, Make, n8n.

2. Via OAuth (Claude Web, ChatGPT Web)

Vous ne collez jamais la clé dans le client. À la place, vous vous authentifiez via Auth0 (le fournisseur d'identité d'Axonaut) qui, à la première connexion, associe votre clé API à votre identité. Ensuite, le serveur MCP retrouve automatiquement votre clé à chaque appel de tool.

Prérequis : votre clé API doit être stockée dans votre profil Auth0 sous user_metadata.axonaut_api_key. C'est fait automatiquement à la première connexion OAuth.

Voir : Claude, ChatGPT.

Régénérer la clé

Si vous suspectez que votre clé est compromise :

  1. Retournez sur la même page API dans Axonaut.
  2. Cliquez sur « Régénérer » — la nouvelle clé remplace immédiatement l'ancienne.
  3. Réinjectez la nouvelle clé dans vos intégrations Make / n8n / Zapier (les intégrations OAuth Claude / ChatGPT vont ré-appairer automatiquement au prochain refresh).

Que faire si je ne trouve pas le menu API ?

L'accès au menu API dépend de vos permissions Axonaut. Si le menu n'apparaît pas :

  • Vérifiez avec l'administrateur de votre compte Axonaut qu'il vous a bien accordé la permission « API ».
  • Ou demandez-lui de générer une clé au nom d'un compte utilisateur dédié « intégrations », que plusieurs équipes peuvent partager.