Configuratie Referentie

Deze pagina documenteert de omgevingsvariabelen die de axe MCP-server leest, en de aanbevolen aangepaste instructies voor uw AI-agent. Deze zijn van toepassing op zowel de Docker- en npm-distributies. Voor waar u deze waarden kunt plaatsen, zie uw handleiding voor het instellen van de client.

Configuratieopties

De axe MCP Server ondersteunt verschillende omgevingsvariabelen voor aanpassing:

AXE_SERVER_URL

De standaardwaarde (https://axe.deque.com) is correct voor de meeste gebruikers — degenen op Deque's gedeelde US SaaS-instantie. Als uw organisatie een van de volgende gebruikt, moet u AXE_SERVER_URL instellen op de basis-URL van uw instantie:

• Een regionale SaaS-instantie (EU, Australië, Frankfurt, enz.)
• Een private cloud-implementatie
• Een on-premises-installatie

Als u niet zeker weet welke instantie uw organisatie gebruikt, controleer dan de URL die u gebruikt om in te loggen bij het axe Account Portal, of vraag het uw beheerder.

Stel AXE_SERVER_URL expliciet in binnen het env-blok van uw MCP-serverconfiguratie. De handleidingen voor clientsetup omvatten voorbeelden die precies laten zien waar het moet worden toegevoegd.

AXE_CHROME_PATH

alleen npm-distributie. Dit wordt niet ondersteund in Docker, dat altijd de meegeleverde browser gebruikt — de server start niet als AXE_CHROME_PATH is ingesteld onder de Docker-distributie.

Standaard gebruikt de npm-distributie de Chromium-build die u installeert via Playwright. Stel AXE_CHROME_PATH in op het volledige pad van een bestaande Chrome/Chromium-binary om die in plaats daarvan te gebruiken en de installatie van Playwright over te slaan.

• De waarde moet een uitvoerbaar binair bestand zijn, geen .app-bundel of directory. Wijs op macOS bijvoorbeeld naar de binary binnen de bundel: /Applications/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing.
• De binary moet starten en reageren op --version. De server valideert dit bij het opstarten en faalt snel met Unable to find specified chrome instance als dat niet lukt.
• Branded Google Chrome stabiel 137 en later wordt niet ondersteund. Gebruik Chrome voor testen of een andere Chromium-compatibele binary.

De analyze en igt tools accepteren ook een per-oproep chromePath-argument, dat voorrang heeft boven AXE_CHROME_PATH voor die oproep.

Uw AI-agent configureren (Aanbevolen)

Om ervoor te zorgen dat uw AI-coderingsagent de Axe MCP Server-tools correct gebruikt en de beste toegankelijkheidspraktijken volgt, kunt u deze voorzien van aangepaste instructies. Deze instructies helpen de agent om de juiste workflow te begrijpen voor het analyseren en verhelpen van toegankelijkheidsproblemen.

Waar instructies toe te voegen

De methode verschilt per client:

• VS Code met GitHub Copilot - Voeg toe aan .github/copilot-instructions.md in de hoofdmap van uw project
• Cursor - Voeg toe aan "Cursorregels" in de instellingen
• Claude Code - Voeg toe aan een CLAUDE.md-bestand in de hoofdmap van uw project
• Claude Desktop - Voeg toe aan aangepaste instructies in de instellingen
• Andere MCP-clients - Raadpleeg de documentatie van uw klant voor configuratie van aangepaste instructies

Voorbeeldwerkstroominstructies

Hieronder staat een aanbevolen sjabloon dat u kunt aanpassen voor uw agent:

# Accessibility Testing and Remediation Workflow

## MANDATORY WORKFLOW - DO NOT DEVIATE

When working with accessibility issues, you MUST follow this exact workflow:

### 1. Analysis Phase

When asked to analyze pages for accessibility issues, you MUST:

- Use the `analyze` tool to scan the page
- Do NOT manually identify accessibility issues
- Always provide the complete URL being analyzed

### 2. Authentication & Pre-Scan Setup

When the user's request involves credentials, form input, dismissing
overlays, or waiting for content before the scan, you MUST:

- Pass an ordered `before` array to the `analyze` tool using the
  `click`, `fill`, and `waitFor` actions
- Resolve any references to env vars, `.env*` files, or local
  configuration into literal strings BEFORE calling the tool — the
  server treats `value` as a literal and will not expand `${VAR}`,
  `$VAR`, or `{{VAR}}` syntax
- Use `fill` for secret values so the server's redaction protections
  apply; never embed secrets in a `selector`, which appears in logs
  and error messages
- ASK the user when the source of a credential or value is ambiguous;
  do NOT guess or fabricate values
- Use ONLY selectors the user provided; if a step needs a selector
  the user did not name, ASK rather than guess
- Use `waitFor` after any `click`/`fill` that triggers async UI
  (route changes, late-rendered content) to deterministically gate
  the next step or the scan — pick a selector that exists ONLY in
  the post-interaction state (e.g., a logout button or dashboard
  heading), never a generic one like `body` or `#app` that already
  exists beforehand

### 3. Remediation Phase

When asked to remediate or fix accessibility issues, you MUST:

- Collect ALL violations from the analysis and pass them to the
  `remediate` tool in a SINGLE batched call — do NOT call `remediate`
  once per issue
- Give each issue a unique `id` so each result can be correlated
  back to its input
- Provide the exact HTML element, rule ID, and issue description for
  every issue in the batch
- Review the remediation guidance before making any code changes
- Apply fixes based on the remediate tool's recommendations
- Do NOT manually fix accessibility issues without first using the remediate tool

### 4. Verification Phase

After applying fixes, you MUST:

- Re-run `analyze` to verify all issues are resolved
- Confirm zero violations before considering the task complete

## Required Workflow Example:

1. analyze → Find violations
2. remediate → Pass ALL violations in one batched call to get fix guidance
3. Apply recommended fixes to code
4. analyze → Verify fixes

## Enforcement

- NEVER skip the remediate tool when fixing accessibility issues
- ALWAYS use both analyze and remediate tools as specified
- This workflow ensures proper accessibility best practices and compliance

Waarom dit belangrijk is

Deze instructies zorgen ervoor dat uw agent:

• Gebruik maakt van Deque's expertise - Maakt gebruik van AI-modellen getraind op decennia aan data over toegankelijkheidsbeoordeling in plaats van algemene LLM-kennis
• Volgt de beste praktijken - Past consistente, WCAG-conforme oplossingen toe in plaats van generieke oplossingen
• Verifieert wijzigingen - Bevestigt altijd dat de oplossingen daadwerkelijk de problemen hebben opgelost
• Vermijdt valse zekerheid - Veronderstelt niet te weten hoe toegankelijkheidsproblemen moeten worden opgelost zonder deskundige begeleiding

Hoewel optioneel, verbetert het verstrekken van deze instructies de kwaliteit en betrouwbaarheid van toegankelijkheidsoplossingen in je codebase aanzienlijk.