Instellen 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

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.
info

Als u al andere servers gedefinieerd heeft, voeg dan het axe-mcp-server-blok binnen het bestaande mcpServers-object toe.

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.

note

Gebruikt u een regionale, privé cloud, of on-premises axe-instantie? Voeg AXE_SERVER_URL toe aan het env-blok met de basis-URL van uw instantie:

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

Als het weggelaten wordt, standaardiseert de server naar https://axe.deque.com (De gedeelde US SaaS-instantie van Deque). Zie Configuratiereferentie voor meer details.

OAuth 2.0

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

Dit maakt gebruik van @deque/axe-auth token om bij elke start van de server een nieuwe toegangstoken te verkrijgen.

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

Gebruikt u een regionale, privécloud- of on-premises axe-instantie? Voeg AXE_SERVER_URL toe aan het Docker-commando en een env-blok met de basis-URL van je instantie:

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

Als het wordt weggelaten, gebruikt de server standaard https://axe.deque.com (Deque's gedeelde US SaaS-instantie). Zie Configuratiereferentie voor details.

note

Deze configuratie gebruikt sh -c om shell-substitutie toe te staan. $(npx -y @deque/axe-auth token) draait bij het opstarten van de server en injecteert een geldig toegangstoken in de Docker-container. De -y-vlag slaat de "Ok om door te gaan?"-prompt die npx anders zou vragen in een niet-interactieve shell over. Stel AXE_API_KEY niet in samen met AXE_ACCESS_TOKEN.

caution

Windows-gebruikers: Deze configuratie maakt gebruik van een POSIX-shell (sh) en commando-substitutie ($(...)), wat standaard niet beschikbaar is in cmd.exe of PowerShell. Voer je editor uit vanuit een Git Bash- of WSL-shell zodat sh op je PATH staat.

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

Uw configuratie bevat een referentie in zijn env-blok. Bestanden op projectniveau zoals .cursor/mcp.json bevinden zich in uw repository — voeg ze toe aan .gitignore, of bewaar referenties in plaats daarvan in uw globale configuratie.

OAuth 2.0

OAuth 2.0 wordt ook ondersteund met de npm-distributie — stel AXE_ACCESS_TOKEN in in plaats van AXE_API_KEY, waarbij een nieuw token uit @deque/axe-auth token bij het opstarten wordt geïnjecteerd. Zie Authenticatie voor de volledige stroom.

note

Stel ofwel AXE_API_KEY of AXE_ACCESS_TOKEN in — niet beide. De server zal bij het opstarten falen als beide variabelen zijn ingesteld.

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.

Is this page helpful?

Help us improve this page

Still need help?