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.

Starten Sie den Server über @deque/axe-auth run, um das Zugriffstoken des laufenden Servers so lange frisch zu halten, wie die Sitzung dauert.

{
  "mcpServers": {
    "axe-mcp-server": {
      "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 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 ebenfalls mit der npm-Distribution unterstützt. Umhüllen Sie den Server in @deque/axe-auth run genau wie oben — es gibt keinen Container, um einen Port zu veröffentlichen, daher ist der Befehl kürzer:

{
  "mcpServers": {
    "axe-mcp-server": {
      "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.

Sehen Sie sich Authentifizierung für den vollständigen Ablauf an.

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?