Axe MCP-Server
Überblick
Der Axe MCP-Server ist ein Model Context Protocol (MCP)-Server, der umfassende Accessibility-Tests in Ihre Entwicklungsumgebung integriert. Auf der bewährten Axe-Plattform aufgebaut, ermöglicht er es Entwicklern, umfassende Accessibility-Scans durchzuführen und Expertenempfehlungen zur Behebung der Probleme direkt in ihrer IDE zu erhalten.
Der Server bietet zwei Werkzeuge: analyze, das eine Seite scannt und in demselben Aufruf Intelligente Geführte Tests darauf ausführen kann, und remediate, das die gefundenen Probleme in Codefixes umwandelt. Ein drittes Werkzeug, igt, ist veraltet.
Diese Werkzeuge integrieren sich nahtlos mit MCP-kompatiblen Clients (wie Claude Desktop, VS Code mit Copilot oder Cursor) und berücksichtigen die Axe-Konfigurationseinstellungen Ihrer Organisation.
Zugang erhalten
Der Axe MCP-Server ist im Axe DevTools für Web-Paket enthalten. Ein Abonnement, das den Zugriff auf den Axe MCP-Server ermöglicht, wird durch ein Gespräch mit einem Vertriebsmitarbeiter von Deque eingerichtet.
Tools & Funktionen
Das analyze-Tool
Scannt eine Webseite auf Barrierefreiheitsprobleme in einem echten Browser mit der Axe DevTools Browser-Erweiterung und sendet die Ergebnisse an Ihren Agenten. Er funktioniert mit lokalen Entwicklungs-URLs wie localhost:3000 sowie mit entfernten URLs und beachtet die Axe-Konfiguration Ihrer Organisation.
Optionen ermöglichen es Ihnen, bei einer bestimmten Viewport-Größe zu scannen, den Scan-Bereich abgrenzen auf einen Teil der Seite zu fokussieren, anmelden oder Banner schließen vor dem Scan auszuführen, Cookies injizieren, ein Bildschirmfoto aufnehmen und Erweiterte Regeln auszuführen.
Siehe Analyse-Tool.
Intelligente Geführte Tests
Das analyze-Tool kann auch Deques Automatisierte Intelligente Geführte Tests (IGTs) gegen dieselbe Seite im selben Aufruf ausführen: die Tastatur-, Interaktive Elemente- und Modales Dialogfenster-IGTs. IGTs sind KI-gesteuert und verbrauchen AI-Credits.
Siehe Intelligente Geführte Tests.
Das remediate-Tool
Nimmt die analyze gefundenen Probleme auf und gibt KI-gesteuerte Korrekturanleitungen zurück, einschließlich eines konkreten Codefixes, den Ihr Programmieragent anwenden kann. Reichen Sie jedes Problem eines Durchlaufs in einem gebündelten Aufruf ein. Jedes Problem verbraucht AI-Credits.
Siehe Behebungs-Tool.
Das igt-Tool
Veraltet. Verwenden Sie stattdessen analyze mit dem igtTools-Parameter. Siehe Das igt-Tool.
Erste Schritte
Die Einrichtung des Axe MCP-Servers umfasst drei unabhängige Entscheidungen:
- Wählen Sie eine Distribution — Docker oder npm
- Richten Sie die Authentifizierung ein — ein API-Schlüssel oder OAuth 2.0
- Konfigurieren Sie Ihren Client — VS Code mit Copilot, Cursor oder **Claude Code**
Claude-Code-Nutzer können diese Schritte mit dem Axe Accessibility-Plugin überspringen, das den Server registriert und Slash-Befehle für Einrichtung, Agentenanweisungen und den vollständigen Behebungslauf hinzufügt.
Für Umgebungsvariablen und empfohlene Anweisungen für den KI-Agenten siehe Konfigurationsreferenz. Wenn etwas schiefgeht, siehe Fehlerbehebung.
Beispielaufforderungen
Sicherstellen, dass die erwarteten Werkzeuge aufgerufen werden
In vielen IDEs wird durch die Verwendung der folgenden Syntax ("#"-Präfix) sichergestellt, dass die Werkzeuge des Axe MCP-Servers wie erwartet aufgerufen werden:
#analyze the http://localhost:3033/ web page for accessibility issues and #remediate any violations foundEine localhost-URL auf Barrierefreiheitsprobleme analysieren:
Analyze http://localhost:3000 for accessibility issuesAnalyse mit Behebung:
Analyze https://example.com for accessibility issues and fix any issues foundEine Seite hinter einer Login-Schranke analysieren:
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.Ein Cookie-Banner vor dem Scannen schließen:
Analyze https://example.com for accessibility issues, but first click the
#cookie-dismiss button to dismiss the cookie consent banner.Einen Screenshot der Seite aufnehmen:
Analyze http://localhost:3000 for accessibility issues and capture a screenshot of the pageScannen einer Seite mit einem eingesetzten Sitzungscookie:
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.Führen Sie jeden geführten Test in einem Aufruf aus:
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).Wählen Sie, welche interaktiven Elemente getestet werden sollen:
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.Testen Sie ein modales Dialogfenster:
Analyze http://localhost:3000 and run the modal guided test on the dialog
opened by #open-dialogSupport
Für Fragen, Probleme oder Rückmeldungen bezüglich des Axe MCP-Servers:
- Technischer Support: helpdesk@deque.com
- Allgemeine Anfragen: helpdesk@deque.com
- Vertriebsfragen: sales@deque.com
Sicherheit & Datenschutz
Für Informationen darüber, was der Server an Deque sendet, was er speichert und welchen Zugriff Ihr KI-Agent benötigt, siehe Sicherheit & Datenschutz FAQ.
