Einrichtung 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

Vor der Konfiguration, wählen Sie eine Distribution (Docker oder npm) und richten Sie die Authentifizierung ein (API-Schlüssel oder OAuth 2.0). Fügen Sie dann die passende Konfiguration unten hinzu.

Der Axe MCP Server kann entweder auf Projektebene oder Benutzerebene hinzugefügt werden:

  • Projektebene: Erstellen Sie eine Datei im .mcp.json Ihres Projektstammverzeichnisses (am besten zum Teilen von Einstellungen mit einem Team)
  • Benutzerebene: Fügen Sie den Server zum mcpServers Objekt in ~/.claude.json Ihrem Home-Verzeichnis hinzu (gilt für alle Ihre Projekte). Sie können benutzerebene Server auch mit dem claude mcp add --scope user Befehl verwalten — siehe die Claude Code MCP-Dokumentation für weitere Details.
info

Wenn Sie bereits andere Server definiert haben, fügen Sie den axe-mcp-server Block innerhalb des vorhandenen mcpServers Objekts hinzu.

Docker

API-Schlüssel

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

Die Konfiguration verwendet "AXE_API_KEY": "${AXE_API_KEY}" für die sichere Eingabeverarbeitung. Die ${AXE_API_KEY} Syntax weist Claude Code an, den Wert aus Ihrer Shell-Umgebung zu holen. Für weitere Informationen siehe die Claude Code MCP-Dokumentation.

Legen Sie Ihren API-Schlüssel als Umgebungsvariable in Ihrer Shell fest:

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

Für eine dauerhafte Einrichtung fügen Sie diese Zeile zu Ihrem Shell-Profil hinzu (~/.bashrc, ~/.zshrc, etc.).

note

Verwenden Sie eine regionale, private Cloud oder eine lokale Axe-Instanz? Aktualisieren Sie den AXE_SERVER_URL Wert im env Block mit der Basis-URL Ihrer Instanz:

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

Wenn nicht angegeben, wird der Server auf https://axe.deque.com (Deque's gemeinsame US SaaS-Instanz) standardmäßig gesetzt. Siehe Konfigurationsreferenz für weitere Details.

OAuth 2.0

Bevor Sie die Konfiguration vornehmen, führen Sie Schritt 1: Authentifizieren im Authentifizierungsleitfaden durch.

Dies verwendet @deque/axe-auth token , um bei jedem Start des Servers ein neues Zugriffstoken zu erhalten.

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

Verwenden Sie eine regionale, private Cloud- oder eine lokale Axe-Instanz? Fügen Sie AXE_SERVER_URL zum Docker-Befehl hinzu und einen env Block mit der Basis-URL Ihrer Instanz:

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

Wenn ausgelassen, verwendet der Server standardmäßig https://axe.deque.com (Deque's gemeinsamer US-SaaS-Instanz). Siehe Konfigurationsreferenz für Details.

note

Diese Konfiguration verwendet sh -c , um Shell-Substitution zu ermöglichen. $(npx -y @deque/axe-auth token) wird beim Serverstart ausgeführt und injiziert ein gültiges Zugriffstoken in den Docker-Container. Das -y -Flag überspringt die Erstaufruf-Aufforderung „Ok fortfahren?“, die npx andernfalls in einer nicht-interaktiven Shell stellen würde. Setzen Sie nicht AXE_API_KEY zusammen mit AXE_ACCESS_TOKEN.

caution

Windows-Nutzer: Diese Konfiguration verwendet eine POSIX-Shell (sh) und die Befehlsersetzung ($(...)), die in cmd.exe oder PowerShell standardmäßig nicht verfügbar ist. Starten Sie Ihren Editor von einer Git Bash oder WSL-Shell, damit sh in Ihrem PATHist.

npm

Die npm-Verteilung läuft auf Node.js. Verwenden Sie eine aktive LTS-Version von Node.js – ältere Versionen werden möglicherweise nicht unterstützt.

Die npm-Distribution benötigt einen Chromium-Browser — entweder installieren Sie einen über Playwright oder verweisen auf ein vorhandenes Binary. Siehe Distribution wählen.

API-Schlüssel

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

Setzen Sie AXE_API_KEY in Ihrer Shell wie oben gezeigt, damit Claude Code ihn aus der Umgebung abrufen kann.

OAuth 2.0

OAuth 2.0 wird auch mit der npm-Distribution unterstützt — setzen Sie AXE_ACCESS_TOKEN anstelle von AXE_API_KEY, indem Sie ein neues Token von @deque/axe-auth token beim Start einfügen. Siehe Authentifizierung für den vollständigen Ablauf.

note

Legen Sie entweder AXE_API_KEY oder AXE_ACCESS_TOKEN fest — nicht beide. Der Server wird beim Start fehlschlagen, wenn beide Variablen gesetzt sind.

Verwendung und Überprüfung

Nach der Konfiguration starten Sie Claude Code neu, um den MCP-Server zu laden.

  1. Starten Sie Claude Code von Ihrem Terminal: claude
  2. Geben Sie /mcp ein, um MCP-Serververbindungen zu verwalten
  3. Sie sollten sehen, dass axe-mcp-server gelistet ist mit den analyze, remediate, und igt verfügbaren Werkzeugen

Konfiguration von Claude Code (empfohlen)

Um sicherzustellen, dass Claude Code die Axe MCP Server-Tools korrekt verwendet, fügen Sie die empfohlenen Anweisungen zum Analyse-dann-Sanieren-Workflow in eine CLAUDE.md Datei im Stammverzeichnis Ihres Projekts hinzu. Siehe Konfiguration Ihres KI-Agenten für das vollständige Template.

Is this page helpful?

Help us improve this page

Still need help?