Setup in 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

Een Axe MCP-server kan worden toegevoegd op projectniveau of gebruikersniveau.

Kies bereik

  • Projectniveau: Maak een bestand aan bij .mcp.json in de hoofdmap van je project (het beste om instellingen te delen met een team)
  • Gebruikersniveau: Voeg de server toe aan het mcpServers object in ~/.claude.json in je home directory (geldt voor al je projecten). Je kunt ook user-level servers beheren met de claude mcp add --scope user commando — zie de Claude Code MCP-documentatie voor details.

Configuratie JSON toevoegen

Voeg de volgende configuratie JSON toe.

info

Als je al andere servers gedefinieerd hebt, voeg dan het axe-mcp-server blok toe binnen het bestaande mcpServers object.

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

De configuratie gebruikt "AXE_API_KEY": "${AXE_API_KEY}" voor veilige invoerbehandeling. De ${AXE_API_KEY} syntaxis instrueert Claude Code om de waarde uit je shell-omgeving te halen. Voor meer informatie, zie de Claude Code MCP-documentatie.

note

Gebruik je een regionale, privé-cloud of lokale axe-instantie? Werk de AXE_SERVER_URL waarde bij in het env blok met de basis-URL van je instantie:

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

Indien weggelaten, valt de server terug op https://axe.deque.com (Deques gedeelde US SaaS-instantie). Zie Configuratie-opties voor details.

Stel je API-sleutel in

Stel je API-sleutel in als een omgevingsvariabele in je shell:

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

Voor permanente instelling, voeg deze regel toe aan je shell-profiel (~/.bashrc, ~/.zshrc, enz.).

Gebruik van OAuth 2.0-authenticatie

Als je OAuth boven een API-sleutel verkiest, vervang dan de bovenstaande configuratie door de volgende. Dit gebruikt @deque/axe-auth token om een nieuwe toegangstoken te verkrijgen elke keer dat de server start.

Voordat je configureert, voltooi Stap 1: Authenticeren in de OAuth 2.0-authenticatiehandleiding.

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

Gebruik je een regionale, privé-cloud of lokale axe-instantie? Voeg AXE_SERVER_URL toe aan het Docker-commando en een env blok met de basis-URL van je instantie:

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

Indien weggelaten, valt de server terug op https://axe.deque.com (Deques gedeelde US SaaS-instantie). Zie Configuratie-opties voor details.

note

Deze configuratie gebruikt sh -c om shell-substitutie toe te staan. $(npx -y @deque/axe-auth token) draait bij het opstarten van de server en injecteert een geldige toegangstoken in de Docker-container. De -y vlag slaat de eerste-run "Ok om door te gaan?" prompt over die npx anders zou vragen in een niet-interactieve shell. Stel geen AXE_API_KEY naast AXE_ACCESS_TOKEN.

caution

Windows-gebruikers: Deze configuratie gebruikt een POSIX-shell (sh) en commando-substitutie ($(...)), wat niet standaard beschikbaar is in cmd.exe of PowerShell. Voer Claude Code uit vanaf een Git Bash of WSL-shell zodat sh zich op je PATH.

Gebruik en verificatie

Herstart Claude Code nadat je de MCP-server hebt geconfigureerd.

  1. Start Claude Code vanuit je terminal: claude
  2. Typ /mcp om MCP-serverconnecties te beheren
  3. Je zou axe-mcp-server moeten zien vermeld met de analyze en remediate tools beschikbaar

Configuratie van Claude Code (aanbevolen)

Om ervoor te zorgen dat Claude Code de axe MCP Server-tools correct gebruikt, voeg de volgende instructies toe aan een CLAUDE.md bestand in de hoofdmap van je project. Dit vertelt Claude om de juiste 'analyze-then-remediate'-workflow te volgen.

# 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

Voor meer details over agentinstructies, zie Configuratie van jouw AI-agent.

Is this page helpful?

Help us improve this page

Still need help?