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
tip

Bevorzugst du eine Einrichtung mit nur einem Befehl? Die axe Accessibility Plugin registriert den Server für dich und fügt Fähigkeiten und Slash-Befehle hinzu, die den Analyse → Beheben → Überprüfen-Workflow steuern. Diese Seite beschreibt die manuelle Konfiguration des Servers.

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.

Starte den Server über @deque/axe-auth run, das das Zugriffstoken des laufenden Servers so lange erneuert, wie die Sitzung dauert.

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

Token-Aktualisierung erreichte den axe MCP Server in v1.5.0. npx -y @deque/axe-auth ruft immer das aktuelle CLI ab, aber ein Docker-Image, das vor dieser Version gezogen wurde, hat keinen Aktualisierungslistener für run, um es zu pushen — ziehen Sie es erneut mit docker pull dequesystems/axe-mcp-server:latest.

npx -y @deque/axe-auth run startet den Container und überwacht ihn während der gesamten Sitzung, indem es dem laufenden Server ein frisch erstelltes Zugriffstoken zusendet, bevor das aktuelle abläuft. Ihr Refresh-Token verlässt niemals Ihren Rechner – nur kurzlebige Zugriffstokens erreichen den Server. Das -y-Flag überspringt die Ersteinführungsaufforderung „In Ordnung, fortzufahren?“, die npx ansonsten in einer nicht-interaktiven Shell stellen würde.

Die verbleibenden Flags dienen dazu, das Pushen innerhalb des Containers erreichbar zu machen:

  • -p 127.0.0.1:9223:9223 veröffentlicht den Refresh-Listener des Servers ausschließlich auf dem Host-Loopback und hält ihn von den externen Schnittstellen Ihres Rechners fern.
  • -e AXE_ACCESS_TOKEN, -e AXE_TOKEN_REFRESH_PORT und -e AXE_TOKEN_REFRESH_SECRET leiten die von run generierten Werte in den Container weiter. Geben Sie nur die Namen an, ohne =value — run liefert sie.
  • -e AXE_TOKEN_REFRESH_HOST=0.0.0.0 bindet den Listener an die Netzwerkschnittstelle des Containers. Ein veröffentlichter Port leitet dorthin weiter, anstatt zum Loopback des Containers, sodass die Standard-Loopback-Bindung nicht erreichbar wäre. Das geteilte Geheimnis, nicht die Isolierung des Containers, schützt den Endpunkt.

9223 ist ein Beispiel – jeder freie Port auf Ihrem Rechner funktioniert, solange AXE_TOKEN_REFRESH_PORT und der -p-Veröffentlichungsname denselben benennen. Siehe Token-Refresh-Variablen für die vollständige Referenz.

note

Verwenden Sie eine regionale, private Cloud- oder eine lokale Axe-Instanz? Add AXE_SERVER_URL to the Docker command and to the env block, alongside the refresh port:

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

Verwenden Sie die gleiche URL, die Sie bei der Anmeldung an --server übergeben haben, damit die Tokens, die axe-auth erstellt, von der Instanz kommen, die der Server aufruft. Wenn diese weggelassen wird, verwendet der Server standardmäßig https://axe.deque.com (Deque's geteilte US SaaS-Instanz). Siehe Konfigurationsreferenz für weitere Details.

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 auch mit der npm-Distribution unterstützt. Binde den Server in @deque/axe-auth run ein, genau wie oben — es gibt keinen Container, um einen Port zu veröffentlichen, daher ist der Befehl kürzer:

{
  "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 startet den Server und überwacht ihn während der gesamten Sitzung, indem er ein neu ausgestelltes Zugriffstoken an den laufenden Prozess übermittelt, bevor das aktuelle abläuft. Hier ist kein Port-Publish erforderlich: Der umwickelte Prozess erbt AXE_TOKEN_REFRESH_PORT direkt und der Listener bleibt auf Loopback. 9223 ist ein Beispiel – jeder freie Port auf Ihrem Rechner funktioniert, und die Variable ist hier optional: Lassen Sie sie weg und run wählt einen freien Port für die Sitzung aus.

caution

Im Gegensatz zu einem Container erbt die npm-Distribution Ihre gesamte Shell-Umgebung. Wenn AXE_API_KEY dort exportiert wird, erreicht es den Server zusammen mit dem OAuth-Token und der Server verweigert den Start. Entfernen Sie es in der Shell, von der aus Sie Ihren Editor starten, oder verwenden Sie die obenstehende Docker-Konfiguration, die nur die explizit mit -e-Flags übergebenen Variablen erhält.

Siehe Authentifizierung für den vollständigen Ablauf.

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?