Setup in Cursor
Bevor Sie die Konfiguration vornehmen, wählen Sie eine Distribution (Docker oder npm) aus 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.jsonim 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.
Wenn Sie bereits andere Server definiert haben, fügen Sie den axe-mcp-server Block innerhalb des vorhandenen mcpServers Objekts 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}" , 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-Dokumentationbefindet.
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 Konfigurationsreferenz für Details.
OAuth 2.0
Bevor Sie die Konfiguration vornehmen, führen Sie Schritt 1: Authentifizieren im Authentifizierungsleitfaden durch.
Dies verwendet @deque/axe-auth token , um jedes Mal, wenn der Server startet, 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"
]
}
}
}Verwenden Sie eine regionale, private Cloud- oder eine lokale Axe-Instanz? Fügen Sie AXE_SERVER_URL zum Docker-Befehl hinzu und einen env Block mit der Basis-URL Ihrer Instanz:
"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 ausgelassen, verwendet der Server standardmäßig https://axe.deque.com (Deque's gemeinsamer US-SaaS-Instanz). Siehe Konfigurationsreferenz für Details.
Diese Konfiguration verwendet sh -c , um Shell-Substitution zu ermöglichen. $(npx -y @deque/axe-auth token) wird beim Serverstart ausgeführt und injiziert ein gültiges Zugriffstoken in den Docker-Container. Das -y -Flag überspringt die Erstaufruf-Aufforderung „Ok fortfahren?“, die npx andernfalls in einer nicht-interaktiven Shell stellen würde. Setzen Sie nicht AXE_API_KEY zusammen mit AXE_ACCESS_TOKEN.
Windows-Nutzer: Diese Konfiguration verwendet eine POSIX-Shell (sh) und die Befehlsersetzung ($(...)), die in cmd.exe oder PowerShell standardmäßig nicht verfügbar ist. Starten Sie Ihren Editor von einer Git Bash oder WSL-Shell, damit sh in Ihrem PATHist.
npm
Die npm-Verteilung läuft auf Node.js. Verwenden Sie eine 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 eine bestehende Binärdatei. Siehe Auswahl einer Distributionbefindet.
API-Schlüssel
Erstellen Sie eine .cursor/mcp.json -Datei im Stammverzeichnis Ihres Projekts (Projektebene) oder fügen Sie den Server über Cursors globale MCP-Einstellungen hinzu:
{
"mcpServers": {
"axe-mcp-server": {
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "your-api-key-here"
}
}
}
}Ihre Konfiguration enthält ein Berechtigungsnachweis in ihrem env -Block. Dateien auf Projektebene wie .cursor/mcp.json befinden sich in Ihrem Repository – fügen Sie sie zu .gitignore, oder behalten Sie die Berechtigungsnachweise 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, indem Sie bei Start ein frisches Token von @deque/axe-auth token injizieren. Siehe Authentifizierung für den gesamten Ablauf.
Legen Sie entweder AXE_API_KEY oder AXE_ACCESS_TOKEN fest — 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:
- Öffne die Cursor-Einstellungen
- Gehe zu Funktionen > MCP
- 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-dann-Behebungs-Workflow führen, siehe Konfiguration Ihres KI-Agentenbefindet.