Axe MCP-server

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

Overzicht

De Axe MCP-server is een Model Context Protocol (MCP) server die toegankelijkheidstests op ondernemingsniveau direct integreert in uw ontwikkelworkflow. Gebouwd op het vertrouwde Axe-platform, stelt het ontwikkelaars in staat om uitgebreide toegankelijkheidsscans uit te voeren en deskundige begeleiding voor oplossingen te ontvangen zonder hun IDE te verlaten.

De server biedt drie tools aan:

  • analyze scant een webpagina en kan Intelligente Begeleide Tests ertegen uitvoeren in dezelfde oproep.
  • analyze_mobile scant het scherm dat wordt weergegeven op een iOS- of Android-apparaat, simulator, of emulator, met behulp van Axe DevTools Mobile.
  • remediate zet de door analyze gevonden problemen om in code-reparaties. Het dekt alleen webproblemen.

Een vierde tool, igt, is verouderd.

Deze tools integreren naadloos met MCP-compatibele clients (zoals Claude Desktop, VS Code met Copilot, of Cursor) en respecteren de web Axe Configuration-instellingen van uw organisatie. analyze_mobile voert de standaard Axe DevTools Mobile regels uit.

Toegang Krijgen

De Axe MCP Server is beschikbaar via twee plannen:

  • Gratis — onbeperkte analyze scans met de standaard axe-core regels. Aanmelden met slechts een e-mailadres.
  • Premium — inclusief bij Axe DevTools for Web. Voegt geavanceerde regels, intelligent geleide tests en de remediate tool toe. Vraag een demo aan om te beginnen.

Zie Gratis en premium plannen voor een volledige vergelijking.

Mobiele scanning

Mobiele scanning met analyze_mobile valt niet onder de Free of Premium-plannen. Het vereist een Axe DevTools Mobile-abonnement, dat een eigen API-sleutel heeft in het Axe Account Portal. Mobiele scanning is beschikbaar vanaf versie 1.8.0.

U kunt elk product afzonderlijk gebruiken, of beide samen:

  • Alleen web: stel AXE_API_KEY in, of meld u aan met OAuth 2.0.
  • Alleen mobiel: stel AXE_MOBILE_API_KEY in, of meld u aan met OAuth 2.0 met een account dat recht heeft op Axe DevTools Mobile. De webtools worden nog steeds vermeld, maar niet uitgevoerd. Met de sleutel wordt er gezegd dat een webreferentie nodig is. Met OAuth staat er dat het account geen webabonnement heeft.
  • Web en mobiel: stel zowel AXE_API_KEY als AXE_MOBILE_API_KEY in, of meld u één keer aan met OAuth 2.0 met een account dat recht heeft op beide.

Zie Referentiecombinaties.

Tools & Mogelijkheden

De analyzeTool

Scant een webpagina op toegankelijkheidsproblemen in een echte browser, met de Axe DevTools Browser Extension, en geeft de resultaten terug aan uw agent. Het werkt met lokale ontwikkel-URL's zoals localhost:3000 en met externe URL's, en respecteert de Axe Configuration van uw organisatie.

Opties laten je scannen op een specifieke venstergrootte, de scan beperken naar een deel van de pagina, inloggen of banners sluiten voor het scannen, cookies injecteren, een screenshot maken, en, bij Premium, Geavanceerde regels uitvoeren.

Zie Analysetool.

De analyze_mobileTool

Axe DevTools Mobile. Scant het scherm dat momenteel wordt weergegeven op een mobiel apparaat met Axe DevTools Mobile regels, en retourneert de schendingen, elk geplaatst in de zichtbare hiërarchie van de app, zodat uw agent de weergave in de bron kan vinden. Het werkt met een Android-apparaat of emulator, en met een iOS-simulator of via USB verbonden iPhone. Het heeft de npm-distributie nodig, twee scanner-pakketten die naast de server zijn geïnstalleerd en adb voor Android of macOS met Xcode voor iOS.

Zie Analyse Mobile Tool.

Intelligente Begeleide Tests

Premium. De analyze tool kan ook Deque's Automatische Intelligent Guided Tests (IGTs) uitvoeren tegen dezelfde pagina, in dezelfde oproep: de Toetsenbord, Interactieve elementen, en Modale dialoogvenster IGTs. IGTs zijn AI-aangedreven en verbruiken AI-credits. IGTs zijn alleen voor web; analyze_mobile voert ze niet uit.

Zie Intelligente Begeleide Tests.

De remediateTool

Premium. Neemt de problemen analyze gevonden en retourneert AI-aangedreven reparatierichtlijnen, inclusief een concrete codefix, die je codeagent kan toepassen. Dien elk probleem uit een run in één gebundelde oproep in. Elk probleem verbruikt AI-credits.

note

remediate accepteert alleen webproblemen. Het ondersteunt geen analyze_mobile bevindingen.

Zie Hersteltool.

De igtTool

Verouderd. Gebruik analyze met de igtTools-parameter in plaats daarvan. Zie De igt Tool.

Aan de slag

Voordat u begint, heeft u een Axe-account nodig: meld je aan voor het Gratis plan, of gebruik uw Axe DevTools voor Web of Axe DevTools Mobile account. Het opzetten van de Axe MCP Server omvat vervolgens drie onafhankelijke keuzes:

  1. Kies een distributie — Docker of npm
  2. Stel authenticatie in — een API-sleutel of OAuth 2.0
  3. Configureer uw client — VS Code met Copilot, Cursor of **Claude Code**

Om mobiele apps te scannen, voegt u een vierde stap toe:

  1. Mobiele scanning instellen — voeg de scanner-pakketten toe aan uw serveropdracht, installeer adb of Xcode, en sluit een apparaat aan of start een simulator of emulator
note

Mobiele scanning verandert twee van de bovenstaande keuzes. Het heeft de npm distributie nodig; Docker ondersteunt het niet. En het heeft een Axe DevTools Mobile-referentie nodig: AXE_MOBILE_API_KEY, of een OAuth 2.0 aanmelding voor een account dat recht heeft op Axe DevTools Mobile.

Claude Code-gebruikers kunnen deze stappen overslaan met de Axe Toegankelijkheidsplugin, die de server registreert en schuine streep-commando's toevoegt voor instelling, agentinstructies en het uitvoeren van de volledige remediatielus.

Voor omgevingsvariabelen en aanbevolen AI-agentinstructies, zie de Configuratiereferentie. Als er iets misgaat, zie Probleemoplossing.

Voorbeeldprompten

Prompts die problemen verhelpen of begeleide tests uitvoeren, hebben de Premium plan nodig. Mobiele prompts hebben Axe DevTools Mobile nodig.

Zorgen dat verwachte tools worden aangeroepen

In veel IDE's zorgt het gebruik van de volgende syntax ("#" voorvoegsel) ervoor dat de tools van de Axe MCP-server worden aangeroepen zoals verwacht:

#analyze the http://localhost:3033/ web page for accessibility issues and #remediate any violations found

Analyse van een localhost-URL voor toegankelijkheidsproblemen:

Analyze http://localhost:3000 for accessibility issues

Analyse met remediëring:

Analyze https://example.com for accessibility issues and fix any issues found

Analyseer een pagina achter een login:

Analyze http://localhost:3000 for accessibility issues. Before running the
analysis, fill in the #username and #password fields with USERNAME and
PASSWORD from ./.env.local, click the button[type=submit] button, and
wait for #main-content to appear.
Analyze https://example.com for accessibility issues, but first click the
#cookie-dismiss button to dismiss the cookie consent banner.

Maak een screenshot van de pagina:

Analyze http://localhost:3000 for accessibility issues and capture a screenshot of the page
Analyze https://app.example.com for accessibility issues. Set the session
cookie for app.example.com from ./.env.local so the scan starts already
logged in.

Voer elke begeleide test in één oproep uit:

Analyze http://localhost:3000 for accessibility issues with thorough
advanced rules. Also run the keyboard, interactive elements, and modal
guided tests (test the modal triggered by button#open-dialog).

Kies welke interactieve elementen getest moeten worden:

Analyze http://localhost:3000 and run the interactive elements guided test.
Show me the interactive elements it finds first and let me choose which
ones to test.

Test een modaal dialoogvenster:

Analyze http://localhost:3000 and run the modal guided test on the dialog
opened by #open-dialog

Mobiel

analyze_mobile scant het scherm dat open is op het apparaat wanneer het wordt aangeroepen.

Scan het scherm op een Android-emulator:
Scan the screen on my Android emulator for accessibility issues
Scan een app op een iOS-simulator:
Scan the app on my iPhone simulator for accessibility issues. The bundle ID
is in ios/MyApp.xcodeproj.
Scan een specifieke simulator of iPhone:
Scan com.example.myapp on the iOS device with UDID 00008110-001A2B3C4D5E6F70
Scan meerdere schermen:
I'll open each screen of the checkout flow on my Android device. Scan each
one when I say "next", then summarize the issues across all screens.
Scan, dan in bron repareren:
Scan the screen on my Android emulator. For each violation, find the view
in this project using its identifier or view path and suggest a fix.
Zorgen dat de mobiele tool wordt aangeroepen:
#analyze_mobile the screen on my Android emulator

Ondersteuning

Voor vragen, problemen of feedback met betrekking tot de Axe MCP-server:

Veiligheid & Privacy

Voor wat de server naar Deque verzendt, wat het opslaat en welke toegang uw AI-agent nodig heeft, zie de Veiligheid & privacy FAQ.