Axe MCP-server
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:
analyzescant een webpagina en kan Intelligente Begeleide Tests ertegen uitvoeren in dezelfde oproep.analyze_mobilescant het scherm dat wordt weergegeven op een iOS- of Android-apparaat, simulator, of emulator, met behulp van Axe DevTools Mobile.remediatezet de dooranalyzegevonden 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
analyzescans 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
remediatetool 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_KEYin, of meld u aan met OAuth 2.0. - Alleen mobiel: stel
AXE_MOBILE_API_KEYin, 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_KEYalsAXE_MOBILE_API_KEYin, of meld u één keer aan met OAuth 2.0 met een account dat recht heeft op beide.
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.
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:
- Kies een distributie — Docker of npm
- Stel authenticatie in — een API-sleutel of OAuth 2.0
- Configureer uw client — VS Code met Copilot, Cursor of **Claude Code**
Om mobiele apps te scannen, voegt u een vierde stap toe:
- Mobiele scanning instellen — voeg de scanner-pakketten toe aan uw serveropdracht, installeer
adbof Xcode, en sluit een apparaat aan of start een simulator of emulator
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 foundAnalyse van een localhost-URL voor toegankelijkheidsproblemen:
Analyze http://localhost:3000 for accessibility issuesAnalyse met remediëring:
Analyze https://example.com for accessibility issues and fix any issues foundAnalyseer 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.Verwijder een cookiebanner voordat je scant:
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 pageScan een pagina met een geïnjecteerde sessiecookie:
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-dialogMobiel
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 issuesScan 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-001A2B3C4D5E6F70Scan 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 emulatorOndersteuning
Voor vragen, problemen of feedback met betrekking tot de Axe MCP-server:
- Technische Ondersteuning (Premium): helpdesk@deque.com
- Algemene vragen: helpdesk@deque.com
- Verkoopvragen: sales@deque.com
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.
