Setup in Claude Code

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.

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.).

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

OAuth 2.0

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

Start de server via @deque/axe-auth run, wat ervoor zorgt dat het toegangstoken van de draaiende server vers blijft zolang de sessie duurt.

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@deque/axe-auth",
        "run",
        "--",
        "docker",
        "run",
        "--add-host=host.docker.internal:host-gateway",
        "-i",
        "--rm",
        "-p",
        "127.0.0.1:9223:9223",
        "-e",
        "AXE_ACCESS_TOKEN",
        "-e",
        "AXE_TOKEN_REFRESH_PORT",
        "-e",
        "AXE_TOKEN_REFRESH_SECRET",
        "-e",
        "AXE_TOKEN_REFRESH_HOST=0.0.0.0",
        "dequesystems/axe-mcp-server:latest"
      ],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}

npx -y @deque/axe-auth run start de container en superviseert deze gedurende de sessie, waarbij een nieuw aangemaakte toegangstoken naar de draaiende server wordt gestuurd voordat de huidige verloopt. Je vernieuwingstoken verlaat nooit je machine – alleen kortlevende toegangstokens bereiken de server. De -y-vlag slaat de eerste keer dat de "Ok om door te gaan?"-prompt die npx anders zou vragen in een niet-interactieve shell, over.

De resterende vlaggen bestaan om die push binnen de container bereikbaar te maken:

• -p 127.0.0.1:9223:9223 publiceert de vernieuwingsluisteraar van de server alleen op de host-loopback en houdt deze van de externe interfaces van je machine af.
• -e AXE_ACCESS_TOKEN, -e AXE_TOKEN_REFRESH_PORT en -e AXE_TOKEN_REFRESH_SECRET sturen de waarden door die run genereert naar de container. Geef de namen alleen door, zonder =value — run verzorgt ze.
• -e AXE_TOKEN_REFRESH_HOST=0.0.0.0 bindt de luisteraar aan de netwerkinterface van de container. Een gepubliceerde poort wordt daarheen doorgestuurd in plaats van naar de loopback van de container, zodat de standaard loopbackbinding onbereikbaar zou zijn. Het gedeelde geheim, niet de isolatie van de container, is wat het eindpunt beveiligt.

9223 is een voorbeeld — elke vrije poort op je machine werkt, zolang AXE_TOKEN_REFRESH_PORT en de -p publiceren dezelfde noemen. Zie Token vernieuwingsvariabelen voor de volledige referentie.

"args": [
  "-y",
  "@deque/axe-auth",
  "run",
  "--",
  "docker",
  "run",
  "--add-host=host.docker.internal:host-gateway",
  "-i",
  "--rm",
  "-p",
  "127.0.0.1:9223:9223",
  "-e",
  "AXE_SERVER_URL",
  "-e",
  "AXE_ACCESS_TOKEN",
  "-e",
  "AXE_TOKEN_REFRESH_PORT",
  "-e",
  "AXE_TOKEN_REFRESH_SECRET",
  "-e",
  "AXE_TOKEN_REFRESH_HOST=0.0.0.0",
  "dequesystems/axe-mcp-server:latest"
],
"env": {
  "AXE_TOKEN_REFRESH_PORT": "9223",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

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. Omhul de server in @deque/axe-auth run precies zoals hierboven — er is geen container om een poort in te publiceren, dus het commando is korter:

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@deque/axe-auth",
        "run",
        "--",
        "npx",
        "-y",
        "axe-mcp-server"
      ],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}

npx -y @deque/axe-auth run start de server en houdt toezicht zolang de sessie duurt, waarbij een nieuw aangemaakte toegangstoken naar het lopende proces wordt gestuurd voordat de huidige verloopt. Er is hier geen poortpublicatie nodig: het omhulde proces erft AXE_TOKEN_REFRESH_PORT direct en de luisteraar blijft op loopback. 9223 is een voorbeeld — elke vrije poort op je machine werkt, en de variabele is hier optioneel: laat het weg en run kiest een vrije poort voor de sessie.

Zie Authenticatie voor de volledige doorloop.

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.