Configuration dans Claude Code

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Avant de configurer, choisissez une distribution (Docker ou npm) et configurez l'authentification (clé API ou OAuth 2.0). Ensuite, ajoutez la configuration correspondante ci-dessous.

Le serveur Axe MCP peut être ajouté soit au niveau du projet, soit au niveau de l'utilisateur :

  • Niveau projet : Créez un fichier à .mcp.json dans le répertoire racine de votre projet (idéal pour partager les paramètres avec une équipe)
  • Niveau utilisateur : Ajoutez le serveur à l'objet mcpServers dans ~/.claude.json de votre répertoire personnel (s'applique à tous vos projets). Vous pouvez également gérer les serveurs au niveau utilisateur avec la commande claude mcp add --scope user — consultez le . pour plus de détails.
info

Si vous avez déjà d'autres serveurs définis, ajoutez le bloc axe-mcp-server à l'intérieur de l'objet mcpServers existant.

Docker

Clé API

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--add-host=host.docker.internal:host-gateway",
        "-i",
        "--rm",
        "-e",
        "AXE_SERVER_URL",
        "-e",
        "AXE_API_KEY",
        "dequesystems/axe-mcp-server:latest"
      ],
      "env": {
        "AXE_SERVER_URL": "https://axe.deque.com",
        "AXE_API_KEY": "${AXE_API_KEY}"
      }
    }
  }
}

La configuration utilise "AXE_API_KEY": "${AXE_API_KEY}" pour une gestion sécurisée des entrées. La syntaxe ${AXE_API_KEY} indique à Claude Code de récupérer la valeur depuis votre environnement shell. Pour plus d'informations, voir le ..

Pour une configuration permanente, ajoutez cette ligne à votre profil shell (

export AXE_API_KEY="your-api-key-here"

Pour une installation permanente, ajoutez cette ligne à votre profil shell (~/.bashrc, ~/.zshrc, etc.).

note

Ajoutez Mettez à jour la valeur AXE_SERVER_URL dans le bloc env avec l'URL de base de votre instance :

"env": {
  "AXE_API_KEY": "${AXE_API_KEY}",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Si omise, le serveur par défaut est https://axe.deque.com (instance SaaS partagée de Deque aux États-Unis). Voir Référence de configuration pour plus de détails.

OAuth 2.0

Avant de configurer, complétez Étape 1 : Authentification dans le guide d'authentification.

Cela utilise @deque/axe-auth token pour obtenir un nouveau jeton d'accès à chaque démarrage du serveur.

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "sh",
      "args": [
        "-c",
        "docker run --add-host=host.docker.internal:host-gateway -i --rm -e \"AXE_ACCESS_TOKEN=$(npx -y @deque/axe-auth token)\" dequesystems/axe-mcp-server:latest"
      ]
    }
  }
}
note

Utilisez-vous une instance axe régionale, privée ou sur site ? Add AXE_SERVER_URL to the Docker command and an env block with your instance's base URL:

"args": [
  "-c",
  "docker run --add-host=host.docker.internal:host-gateway -i --rm -e AXE_SERVER_URL -e \"AXE_ACCESS_TOKEN=$(npx -y @deque/axe-auth token)\" dequesystems/axe-mcp-server:latest"
],
"env": {
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Si elle est omise, le serveur utilise par défaut https://axe.deque.com (l'instance partagée SaaS de Deque aux États-Unis). Voir Référence de configuration pour plus de détails.

note

Cette configuration utilise sh -c pour permettre la substitution de shell. $(npx -y @deque/axe-auth token) s'exécute au démarrage du serveur et injecte un jeton d'accès valide dans le conteneur Docker. Le drapeau -y saute la demande "D'accord pour continuer ?" que npx poserait autrement dans un shell non interactif. Ne pas régler AXE_API_KEY avec AXE_ACCESS_TOKEN.

caution

Utilisateurs de Windows : Cette configuration utilise un shell POSIX (sh) et la substitution de commandes ($(...)), qui ne sont pas disponibles par défaut dans cmd.exe ou PowerShell. Exécutez votre éditeur depuis un shell Git Bash ou WSL afin que sh soit sur votre PATH.

npm

La distribution npm fonctionne sur Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes pourraient ne pas être prises en charge.

La distribution npm nécessite un navigateur Chromium — installez-en un via Playwright ou pointez vers un binaire existant. Voir Choisir une distribution.

Clé API

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_API_KEY": "${AXE_API_KEY}"
      }
    }
  }
}

Définissez AXE_API_KEY dans votre shell comme montré ci-dessus afin que Claude Code puisse le récupérer de l'environnement.

OAuth 2.0

OAuth 2.0 est également pris en charge avec la distribution npm — définissez AXE_ACCESS_TOKEN au lieu de AXE_API_KEY, en injectant un nouveau jeton depuis @deque/axe-auth token au démarrage. Voir Authentification pour le flux complet.

note

Définissez soit AXE_API_KEY soit AXE_ACCESS_TOKEN — mais pas les deux. Le serveur échouera au démarrage si les deux variables sont définies.

Utilisation et vérification

Une fois configuré, redémarrez Claude Code pour charger le serveur MCP.

  1. Lancez Claude Code depuis votre terminal : claude
  2. Tapez /mcp pour gérer les connexions au serveur MCP
  3. Vous devriez voir axe-mcp-server listé avec les outils analyze, remediate et igt disponibles

Configuration de Claude Code (recommandé)

Pour garantir que Claude Code utilise correctement les outils serveur axe MCP, ajoutez les instructions de workflow recommandées pour l'analyse, puis remédiez à un fichier CLAUDE.md dans la racine de votre projet. Consultez Configurer votre agent IA pour le modèle complet.

Is this page helpful?

Help us improve this page

Still need help?