Setup in Cursor

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

Der Axe-MCP-Server kann entweder auf Projektebene oder global hinzugefügt werden.

Ein-Klick-Installation

Klicken Sie auf den untenstehenden Link, um den Axe-MCP-Server direkt in Cursor zu installieren:

Axe-MCP-Server in Cursor installieren

Cursor wird Sie auffordern, die Installation zu bestätigen. Alternativ folgen Sie den untenstehenden manuellen Einrichtungsschritten.

Bereich wählen

  • Projektebene: Erstellen Sie eine Datei unter .cursor/mcp.json im Stammverzeichnis Ihres Projekts
  • Globale Ebene: Öffnen Sie die Cursor-Einstellungen, gehen Sie zu Funktionen > MCP, und klicken Sie auf Neuen MCP-Server hinzufügen. Dadurch wird Ihre globale Konfigurationsdatei geöffnet.

Hinzufügen der Konfigurations-JSON

Fügen Sie die folgende Konfigurations-JSON hinzu.

info

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

{
  "mcpServers": {
    "axe-mcp-server": {
      "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_API_KEY": "${env:AXE_API_KEY}"
      }
    }
  }
}
note

Die Konfiguration verwendet "AXE_API_KEY": "${env:AXE_API_KEY}" , um eine sichere Eingabeverarbeitung zu gewährleisten. Die ${env:AXE_API_KEY} -Syntax weist Cursor an, den Wert aus Ihren Systemvariablen zu beziehen. Weitere Informationen finden Sie in der Cursor-MCP-Dokumentation.

note

Verwenden Sie eine regionale, private Cloud- oder eine lokal gehostete Axe-Instanz? Fügen Sie AXE_SERVER_URL in den env Block mit der Basis-URL Ihrer Instanz hinzu:

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

Wenn dies weggelassen wird, standardisiert der Server auf https://axe.deque.com (Deques gemeinsamer US-SaaS-Instanz). Siehe Konfigurationsoptionen für Details.

Verwendung der OAuth 2.0-Authentifizierung

Wenn Sie OAuth einem API-Schlüssel vorziehen, ersetzen Sie die obige Konfiguration durch folgende. Dies verwendet @deque/axe-auth token , um jedes Mal, wenn der Server startet, ein neues Zugriffstoken zu erhalten.

Vor der Konfiguration, vervollständigen Sie Schritt 1: Authentifizieren im OAuth 2.0-Authentifizierungsleitfaden.

{
  "mcpServers": {
    "axe-mcp-server": {
      "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 lokal gehostete Axe-Instanz? Fügen Sie AXE_SERVER_URL zum Docker-Befehl und ein 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 dies weggelassen wird, standardisiert der Server auf https://axe.deque.com (Deques gemeinsamer US-SaaS-Instanz). Siehe Konfigurationsoptionen für Details.

note

Diese Konfiguration verwendet 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. Der -y Schalter überspringt die erste „Ok, um fortzufahren?“ Eingabeaufforderung, die npx andernfalls in einer nicht-interaktiven Shell abgefragt würde. Nicht zusammen mit AXE_API_KEY festlegen AXE_ACCESS_TOKEN.

caution

Windows-Benutzer: Diese Konfiguration nutzt eine POSIX-Shell (sh) und Kommandoersetzung ($(...)), die standardmäßig nicht in cmd.exe oder PowerShell verfügbar sind. Führen Sie Cursor von einer Git Bash oder WSL-Shell aus, damit sh sich in Ihrem PATHbefindet.

Verwendung und Überprüfung

Sobald hinzugefügt, sollte der Statusanzeiger in den Cursor-Einstellungen anzeigen, dass der Server läuft:

  1. Öffne die Cursor-Einstellungen
  2. Gehe zu Funktionen > MCP
  3. Sie sollten axe-mcp-server unter Installierte MCP-Server aufgelistet sehen, mit den verfügbaren Analyse- und Behebungstools.

Is this page helpful?

Help us improve this page

Still need help?