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 dans l'objet mcpServers dans votre répertoire personnel (s'applique à tous vos projets). Vous pouvez également gérer les serveurs au niveau utilisateur avec la commande ~/.claude.json . Consultez la documentation de claude mcp add --scope user Claude Code MCP . Définir votre clé API
info

à l'intérieur de l'objet existant axe-mcp-server . mcpServers La configuration utilise

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}"
      }
    }
  }
}

pour gérer les entrées de manière sécurisée. La syntaxe "AXE_API_KEY": "${AXE_API_KEY}" indique à Claude Code de récupérer la valeur depuis votre environnement shell. Pour plus d'informations, consultez la documentation de ${AXE_API_KEY} Claude Code MCP ..

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

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

,~/.bashrc, etc.). ~/.zshrcUtilisation de l'authentification OAuth 2.0

note

Ajoutez dans le bloc AXE_SERVER_URL avec l'URL de base de votre instance : env Si elle est omise, le serveur utilise par défaut

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

(instance SaaS partagée aux États-Unis de Deque). Consultez les https://axe.deque.com Options de Configuration Référence de configuration Définir votre clé API

OAuth 2.0

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

Cela utilise @deque/axe-auth token Avant de configurer, terminez

{
  "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 ? Ajoutez AXE_SERVER_URL à la commande Docker et un env bloc avec l'URL de base de votre instance :

"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 omis, le serveur utilise par défaut https://axe.deque.com (l'instance SaaS partagée 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 -y drapeau saute l'invite "D'accord pour continuer ?" du premier démarrage que npx demanderait autrement dans un shell non interactif. Ne pas définir 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 dans cmd.exe ou PowerShell par défaut. Lancez votre éditeur depuis un shell Git Bash ou WSL afin que sh soit sur votre PATH.

npm

La distribution npm fonctionne avec Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes peuvent 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 indiqué ci-dessus afin que Claude Code puisse le récupérer depuis 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 token frais depuis @deque/axe-auth token au démarrage. Voir Authentification pour le flux complet.

note

Définissez soit AXE_API_KEY ou AXE_ACCESS_TOKEN — 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 du serveur MCP
  3. Vous devriez voir axe-mcp-server listé avec les outils analyze, etc.). remediate, et igt disponibles

Configuration de Claude Code (recommandé)

Pour assurer que Claude Code utilise correctement les outils du serveur axe MCP, ajoutez les instructions de workflow de type analyser-puis-remédier recommandées à un CLAUDE.md fichier dans la racine de votre projet. Voir Configurer votre agent IA pour le modèle complet.

Is this page helpful?

Help us improve this page

Still need help?