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

Bevor Sie die Konfiguration vornehmen, 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 global hinzugefügt werden:

  • 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. Dies öffnet Ihre globale Konfigurationsdatei.
info

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

Docker

API-Schlüssel

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 der untenstehenden manuellen Einrichtung.

Manuelle Einrichtung

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

Die Konfiguration verwendet "AXE_API_KEY": "${env:AXE_API_KEY}" für die sichere Eingabeverarbeitung. Die ${env:AXE_API_KEY}-Syntax weist Cursor an, den Wert aus Ihren Systemvariablen zu ziehen. Für weitere Informationen siehe Cursor-MCP-Dokumentation.

note

Verwenden Sie eine regionale, private Cloud- oder eine lokal gehostete Axe-Instanz? Fügen Sie AXE_SERVER_URL dem 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"
}

Wird sie weggelassen, wird der Server standardmäßig auf https://axe.deque.com (Deque's gemeinsames US SaaS-Instant) gesetzt. Siehe Konfigurationsreferenz für Details.

OAuth 2.0

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

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

{
  "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 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 Sie auf ein vorhandenes Binär. Siehe Auswahl einer Distribution.

API-Schlüssel

Erstellen Sie eine .cursor/mcp.json-Datei im Stammverzeichnis Ihres Projekts (Projektebene) oder fügen Sie den Server über die globalen MCP-Einstellungen von Cursor hinzu:

{
  "mcpServers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_API_KEY": "your-api-key-here"
      }
    }
  }
}
caution

Ihre Konfiguration enthält eine Anmeldeinformation in ihrem env-Block. Projektbezogene Dateien wie .cursor/mcp.json befinden sich in Ihrem Repository — fügen Sie sie zu .gitignore hinzu, oder halten Sie Anmeldeinformationen stattdessen in Ihrer globalen Konfiguration.

OAuth 2.0

OAuth 2.0 wird auch 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. 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

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 mit den verfügbaren Analyse-, Behebungs- und igt-Tools aufgelistet sehen.

Für empfohlene benutzerdefinierte Anweisungen, die Cursor durch den Analyse- und Behebungs-Workflow führen, siehe Konfiguration Ihres KI-Agenten.

Is this page helpful?

Help us improve this page

Still need help?