Setup in VS Code met Copilot

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

De volgende configuratie kan zowel op projectniveau als op gebruikersinstellingsniveau (over alle projecten heen) worden gebruikt. Voor configuratie op projectniveau maak je een .vscode/mcp.json bestand aan in je werkruimte. Voor een gebruikersinstellingsniveau-configuratie voeg je een MCP-server toe aan je bestaande gebruikersconfiguratiebestand.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "axe-api-key",
      "description": "axe MCP Server API Key",
      "password": true
    }
  ],
  "servers": {
    "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": "${input:axe-api-key}"
      }
    }
  }
}

Opmerking: De configuratie maakt gebruik van "AXE_API_KEY": "${input:axe-api-key}" voor veilige invoerbehandeling. Dit zal je om je API-sleutel vragen wanneer de server voor de eerste keer start. Voor meer informatie over VS Code MCP-configuratie, zie de VS Code MCP-documentatie.

note

Gebruik je een regionale, private cloud of lokale axe-instantie? Voeg AXE_SERVER_URL toe aan het env blok met de basis-URL van je instantie:

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

Als dit wordt weggelaten, is de standaardinstelling van de server https://axe.deque.com (Deque's gedeelde Amerikaanse SaaS-instantie). Zie Configuratie-opties voor details.

info

Voor een volledige lijst van configureerbare opties, raadpleeg het Configuratie-opties gedeelte.

OAuth 2.0-authenticatie gebruiken

Als je de voorkeur geeft aan OAuth boven een API-sleutel, vervang dan de configuratie hierboven door de volgende. Dit gebruikt @deque/axe-auth token om bij elke start van de server een nieuwe toegangstoken te verkrijgen. Geen inputs blok is nodig — de token wordt automatisch uit je systeem-sleutelhanger opgehaald.

Voordat je configureert, voltooi Stap 1: Verifiëren in de OAuth 2.0 Authentication-gids.

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

Gebruik je een regionale, private cloud of lokale axe-instantie? Voeg AXE_SERVER_URL 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 dit wordt weggelaten, is de standaardinstelling van de server https://axe.deque.com (Deque's gedeelde Amerikaanse SaaS-instantie). Zie Configuratie-opties voor details.

note

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

caution

Windows-gebruikers: Deze configuratie gebruikt een POSIX-shell (sh) en opdrachtenubstitutie ($(...)), wat niet standaard beschikbaar is in cmd.exe of PowerShell. Voer VS Code uit vanuit een Git Bash of WSL-shell zodat sh op je PATH.

Start de MCP-server

  1. Open VS Code met je geconfigureerde instellingen
  2. Vind de "axe-mcp-server" vermelding in je mcp.json bestand staat
  3. Klik op de Start knop die boven de serverconfiguratie verschijnt
  4. Als je API-sleutelauthenticatie hebt geconfigureerd, voer dan je API-sleutel in wanneer hierom wordt gevraagd. Als je OAuth hebt geconfigureerd, start de server zonder prompt en haalt een token op uit je systeem-sleutelhanger.

Prompts indienen bij Copilot

Zodra de axe MCP-server draait, kun je deze gebruiken via de chatinterface van Copilot in VS Code:

  1. Open Copilot-chat in VS Code
  2. Zorg ervoor dat je in agentmodus bent om gebruik van hulpmiddelen toe te staan
  3. Dien prompts in om websites te analyseren en toegankelijkheidsproblemen te verhelpen