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

Voordat u configureert, kies een distributie (Docker of npm) en stel authenticatie in (API-sleutel of OAuth 2.0). Voeg vervolgens de bijpassende configuratie hieronder toe.

Axe MCP-server kan worden toegevoegd op project- of gebruikersniveau:

  • Projectniveau: Maak een bestand aan op .mcp.json in de hoofdmap van uw project (het beste voor het delen van instellingen met een team)
  • Gebruikersniveau: Voeg de server toe aan het mcpServers-object in ~/.claude.json in uw persoonlijke map (van toepassing op al uw projecten). U kunt ook servers op gebruikersniveau beheren met het claude mcp add --scope user-commando — bekijk de Claude Code MCP-documentatie voor details.
info

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

Docker

API-sleutel

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

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

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

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

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

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 uw instantie:

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

Als weggelaten, wordt de server standaard ingesteld op https://axe.deque.com (Deque's gedeelde US SaaS-instantie). Zie Configuratiereferentie voor details.

OAuth 2.0

Voordat u configureert, voltooi Stap 1: Authenticeer in de Authenticatiehandleiding.

Dit gebruikt @deque/axe-auth token om elke keer dat de server start een nieuwe toegangstoken te verkrijgen.

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

Gebruikt u een regionale, privécloud- of on-premises 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"
}

Als het wordt weggelaten, gebruikt de server standaard https://axe.deque.com (Deque's gedeelde US SaaS-instantie). Zie Configuratiereferentie 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 geldig toegangstoken in de Docker-container. De -y-vlag slaat de "Ok om door te gaan?"-prompt die npx anders zou vragen in een niet-interactieve shell over. Stel AXE_API_KEY niet in samen met AXE_ACCESS_TOKEN.

caution

Windows-gebruikers: Deze configuratie maakt gebruik van een POSIX-shell (sh) en commando-substitutie ($(...)), wat standaard niet beschikbaar is in cmd.exe of PowerShell. Voer je editor uit vanuit een Git Bash- of WSL-shell zodat sh op je PATH staat.

npm

De npm-distributie draait op Node.js. Gebruik een actieve Node.js LTS-release — oudere versies worden mogelijk niet ondersteund.

De npm-distributie heeft een Chromium-browser nodig — installeer er een via Playwright of wijs naar een bestaande binaire. Zie Een distributie kiezen.

API-sleutel

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

Stel AXE_API_KEY in uw shell in zoals hierboven getoond zodat Claude Code het uit de omgeving kan halen.

OAuth 2.0

OAuth 2.0 wordt ook ondersteund met de npm-distributie — stel AXE_ACCESS_TOKEN in plaats van AXE_API_KEY in, waarbij een nieuw token van @deque/axe-auth token bij het opstarten wordt geïnjecteerd. Zie Authenticatie voor de volledige flow.

note

Stel ofwel AXE_API_KEY of AXE_ACCESS_TOKEN in — niet beide. De server zal bij het opstarten falen als beide variabelen zijn ingesteld.

Gebruik en verificatie

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

  1. Start Claude Code vanuit uw terminal: claude
  2. Typ /mcp om MCP-serververbindingen te beheren
  3. U zou axe-mcp-server moeten zien vermeld met de beschikbare analyze-, remediate- en igt-tools

Configuratie van Claude Code (aanbevolen)

Om ervoor te zorgen dat Claude Code de axe MCP Server-tools correct gebruikt, voegt u de aanbevolen workflowinstructies voor analyseren-en-verbeteren toe aan een CLAUDE.md-bestand in de hoofdmap van uw project. Zie Configuratie van jouw AI-agent voor het volledige sjabloon.

Is this page helpful?

Help us improve this page

Still need help?