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

Bevor Sie konfigurieren, 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 in .mcp.json im Stammverzeichnis Ihres Projekts (am besten, um Einstellungen mit einem Team zu teilen)
  • Benutzerebene: Fügen Sie den Server zum mcpServers-Objekt in ~/.claude.json in Ihrem Home-Verzeichnis hinzu (gilt für all Ihre Projekte). Sie können auch serverseitige Benutzereinstellungen mit dem claude mcp add --scope user-Befehl verwalten — Details finden Sie in der Claude Code MCP-Dokumentation.
info

Wenn Sie bereits andere Server definiert haben, fügen Sie den axe-mcp-server-Block in das vorhandene mcpServers-Objekt ein.

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 nutzt "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 übernehmen. Weitere Informationen finden Sie in der 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 die permanente 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 weggelassen, verwendet der Server standardmäßig https://axe.deque.com (Deque’s geteilte US-SaaS-Instanz). Details finden Sie in Konfigurationsreferenz.

OAuth 2.0

Bevor Sie konfigurieren, vervollständigen Sie Schritt 1: Authentifizieren im Authentifizierungsleitfaden.

Dies verwendet @deque/axe-auth token, um jedes Mal, wenn der Server startet, 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 und einen env-Block mit der Basis-URL Ihrer Instanz hinzu:

"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 weggelassen, nutzt der Server standardmäßig https://axe.deque.com (Deque's gemeinsam genutzte US-SaaS-Instanz). Siehe Konfigurationsreferenz für Details.

note

Diese Konfiguration nutzt sh -c, um Shell-Substitution zu ermöglichen. $(npx -y @deque/axe-auth token) wird beim Start des Servers ausgeführt und injiziert ein gültiges Zugriffstoken in den Docker-Container. Das -y-Flag überspringt die Erstanfrage „In Ordnung, um fortzufahren?“, die npx in einer nicht-interaktiven Shell sonst stellen würde. Setzen Sie AXE_API_KEY nicht zusammen mit AXE_ACCESS_TOKEN.

caution

Windows-Nutzer: Diese Konfiguration verwendet eine POSIX-Shell (sh) und Kommandoersetzung ($(...)), die standardmäßig nicht in cmd.exe oder PowerShell verfügbar sind. Starten Sie Ihren Editor aus einem Git Bash oder WSL-Shell, sodass sh auf Ihrem PATH ist.

npm

Die npm-Distribution läuft auf Node.js. Verwenden Sie ein 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 es aus der Umgebung ziehen kann.

OAuth 2.0

OAuth 2.0 wird ebenfalls mit der npm-Distribution unterstützt — setzen Sie AXE_ACCESS_TOKEN anstelle von AXE_API_KEY und injizieren Sie bei Start ein neues Token von @deque/axe-auth token. Für den vollständigen Ablauf siehe Authentifizierung.

note

Setzen Sie entweder AXE_API_KEY oder AXE_ACCESS_TOKEN — 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 mit den Werkzeugen analyze, remediate und igt verfügbar ist

Konfiguration von Claude Code (empfohlen)

Um sicherzustellen, dass Claude Code die Werkzeuge des axe MCP Servers korrekt verwendet, fügen Sie die empfohlenen Anweisungen für den Analyse-Reparatur-Workflow in einer CLAUDE.md-Datei im Stammverzeichnis Ihres Projekts hinzu. Das komplette Template finden Sie in Konfiguration Ihres KI-Agenten.

Is this page helpful?

Help us improve this page

Still need help?