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

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

Choisir la portée

  • 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 pour plus de détails. Ajout de la configuration JSON

Ajoutez le JSON de configuration suivant.

Si vous avez déjà d'autres serveurs définis, ajoutez le bloc

info

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

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

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 .Utiliser une instance axe régionale, dans un cloud privé ou sur site ?

note

Mettez à jour la valeur 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 pour plus de détails. Définir votre clé API

Définissez votre clé API comme une variable d'environnement dans votre shell :

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

Si vous préférez OAuth à une clé API, remplacez la configuration ci-dessus par la suivante. Cela utilise

pour obtenir un nouveau jeton d'accès à chaque démarrage du serveur. @deque/axe-auth token Avant de configurer, terminez

l'Étape 1 : Authentification dans le guide d'authentification OAuth 2.0. Utiliser une instance axe régionale, dans un cloud privé ou sur site ?

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

Ajoutez à la commande Docker et un bloc AXE_SERVER_URL avec l'URL de base de votre instance : env Si elle est omise, le serveur utilise par défaut

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

(instance SaaS partagée aux États-Unis de Deque). Consultez les https://axe.deque.com Options de Configuration pour plus de détails. for details.

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 "Ok pour continuer ?" qui npx poserait autrement dans un shell non interactif. Ne pas définir AXE_API_KEY en même temps que AXE_ACCESS_TOKEN.

caution

Utilisateurs Windows : Cette configuration utilise un shell POSIX (sh) et la substitution de commande ($(...)), qui ne sont pas disponibles dans cmd.exe ou PowerShell par défaut. Exécutez Claude Code à partir d'un shell Git Bash ou WSL pour que sh soit sur votre PATH.

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 et remediate disponibles

Configuration de Claude Code (recommandé)

Pour vous assurer que Claude Code utilise correctement les outils du serveur MCP axe, ajoutez les instructions suivantes à un fichier CLAUDE.md dans la racine de votre projet. Cela indique à Claude de suivre le bon flux de travail analyse-puis-remédiation.

# Accessibility Testing and Remediation Workflow

## MANDATORY WORKFLOW - DO NOT DEVIATE

When working with accessibility issues, you MUST follow this exact workflow:

### 1. Analysis Phase

When asked to analyze pages for accessibility issues, you MUST:

- Use the `analyze` tool to scan the page
- Do NOT manually identify accessibility issues
- Always provide the complete URL being analyzed

### 2. Remediation Phase

When asked to remediate or fix accessibility issues, you MUST:

- First use `remediate` tool for EACH violation found
- Provide the exact HTML element, rule ID, and issue description
- Review the remediation guidance before making any code changes
- Apply fixes based on the remediate tool's recommendations
- Do NOT manually fix accessibility issues without first using the remediate tool

### 3. Verification Phase

After applying fixes, you MUST:

- Re-run `analyze` to verify all issues are resolved
- Confirm zero violations before considering the task complete

Pour plus de détails sur les instructions de l'agent, voir Configurer votre agent IA.

Is this page helpful?

Help us improve this page

Still need help?