Setup in VS Code met Copilot
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.
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.
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"
]
}
}
}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.
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.
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
- Open VS Code met je geconfigureerde instellingen
- Vind de
"axe-mcp-server"vermelding in jemcp.jsonbestand staat - Klik op de Start knop die boven de serverconfiguratie verschijnt
- 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:
- Open Copilot-chat in VS Code
- Zorg ervoor dat je in agentmodus bent om gebruik van hulpmiddelen toe te staan
- Dien prompts in om websites te analyseren en toegankelijkheidsproblemen te verhelpen
