Instellen in Cursor

Voordat u configureert, kies een distributie (Docker of npm) en stel authenticatie in (API-sleutel of OAuth 2.0). Voeg daarna de bijpassende configuratie hieronder toe.

Axe MCP-server kan zowel op projectniveau als globaal niveau worden toegevoegd:

• Projectniveau: Maak een bestand aan op .cursor/mcp.json in de hoofdmap van uw project
• Globaal niveau: Open Cursor-instellingen, ga naar U zou axe-mcp-server onder Geïnstalleerde MCP-servers moeten zien met de analyse- en hersteltools beschikbaar., en klik op Nieuwe MCP-server toevoegen. Dit zal uw globale configuratiebestand openen.

Docker

API-sleutel

Installatie met één klik

Klik op de onderstaande link om de axe MCP-server direct in Cursor te installeren:

Installeer axe MCP-server in Cursor

Cursor zal je vragen om de installatie te bevestigen. Alternatief kun je de handmatige set-up hieronder volgen.

Handmatige set-up

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

De configuratie maakt gebruik van "AXE_API_KEY": "${env:AXE_API_KEY}" voor veilige invoerbehandeling. De ${env:AXE_API_KEY}-syntaxis instrueert Cursor om de waarde uit uw systeemvariabelen te halen. Voor meer informatie, zie de Cursor MCP documentatie.

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

OAuth 2.0

Voordat u configureert, voltooi Stap 1: Authenticeer in de Authenticatiehandleiding.

Start de server via @deque/axe-auth run, waardoor het toegangstoken van de draaiende server ververst blijft zolang de sessie duurt.

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

npx -y @deque/axe-auth run start de container en superviseert deze gedurende de sessie, waarbij een nieuw aangemaakte toegangstoken naar de draaiende server wordt gestuurd voordat de huidige verloopt. Je vernieuwingstoken verlaat nooit je machine – alleen kortlevende toegangstokens bereiken de server. De -y-vlag slaat de eerste keer dat de "Ok om door te gaan?"-prompt die npx anders zou vragen in een niet-interactieve shell, over.

De resterende vlaggen bestaan om die push binnen de container bereikbaar te maken:

• -p 127.0.0.1:9223:9223 publiceert de vernieuwingsluisteraar van de server alleen op de host-loopback en houdt deze van de externe interfaces van je machine af.
• -e AXE_ACCESS_TOKEN, -e AXE_TOKEN_REFRESH_PORT en -e AXE_TOKEN_REFRESH_SECRET sturen de waarden door die run genereert naar de container. Geef de namen alleen door, zonder =value — run verzorgt ze.
• -e AXE_TOKEN_REFRESH_HOST=0.0.0.0 bindt de luisteraar aan de netwerkinterface van de container. Een gepubliceerde poort wordt daarheen doorgestuurd in plaats van naar de loopback van de container, zodat de standaard loopbackbinding onbereikbaar zou zijn. Het gedeelde geheim, niet de isolatie van de container, is wat het eindpunt beveiligt.

9223 is een voorbeeld — elke vrije poort op je machine werkt, zolang AXE_TOKEN_REFRESH_PORT en de -p publiceren dezelfde noemen. Zie Token vernieuwingsvariabelen voor de volledige referentie.

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

npm

De npm-distributie draait op Node.js. Gebruik een actieve Node.js LTS-release — oudere versies worden mogelijk niet ondersteund.

De npm-distributie heeft een Chromium-browser nodig — installeer er een via Playwright of wijs naar een bestaande binaire. Zie Een distributie kiezen.

API-sleutel

Maak een .cursor/mcp.json-bestand in de hoofdmap van uw project (projectniveau) of voeg de server toe via de globale MCP-instellingen van Cursor:

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

OAuth 2.0

OAuth 2.0 wordt ook ondersteund met de npm-distributie. Verpak de server in @deque/axe-auth run precies zoals hierboven — er is geen container om een poort in te publiceren, dus het commando is korter:

{
  "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 start de server en houdt toezicht zolang de sessie duurt, waarbij een nieuw aangemaakte toegangstoken naar het lopende proces wordt gestuurd voordat de huidige verloopt. Er is hier geen poortpublicatie nodig: het omhulde proces erft AXE_TOKEN_REFRESH_PORT direct en de luisteraar blijft op loopback. 9223 is een voorbeeld — elke vrije poort op je machine werkt, en de variabele is hier optioneel: laat het weg en run kiest een vrije poort voor de sessie.

Zie Authenticatie voor het volledige proces.

Na toevoeging zou de statusindicator in de Cursor-instellingen moeten aangeven dat de server draait:

Open Cursor-instellingen

1. Ga naar
2. Ga naar U zou axe-mcp-server onder Geïnstalleerde MCP-servers moeten zien met de analyse- en hersteltools beschikbaar.
3. Je zou axe-mcp-server moeten zien vermeld onder Geïnstalleerde MCP-servers met de beschikbare analyse-, herstel- en igt-tools.

Voor aanbevolen aangepaste instructies die Cursor door de analyse-dan-remedieer-workflow begeleiden, zie Je AI-agent configureren.