Installation aus Deques Agora

Wenn das Netzwerk Ihrer Organisation den Zugriff auf öffentliche Register wie npmjs.org und Docker Hub einschränkt, können Sie den axe MCP Server stattdessen über Agora beziehen. Beide Distributionen sind dort verfügbar: die npm-Pakete und das Docker-Image.

Agora ist Deques eigenes Artefakt-Repository, gehostet unter agora.dequecloud.com, wo Deque die Pakete und Images veröffentlicht, die seine Kunden installieren. Es läuft auf Artifactory und verhält sich daher wie jedes andere npm-Register oder Artefaktquelle, die Ihr Tooling bereits versteht, und Ihre Organisation kann es von ihrem eigenen Repository-Manager aus proxyen.

Dieser Leitfaden behandelt speziell den axe MCP Server. Für andere Axe DevTools-Pakete siehe Installation von Axe DevTools für Web für Node.js aus Deques Agora.

Voraussetzungen

• Agora-Anmeldeinformationen. Wenn Sie diese nicht haben, kontaktieren Sie Ihren Deque-Ansprechpartner oder den Helpdesk.
• Eine gewählte Distribution – siehe Auswahl einer Distribution.
• Für die npm-Distribution, Node.js Version 22.19.0 oder später.
• Für die Docker-Distribution, Docker installiert und läuft.

Erstellen eines Identity Tokens

Agora authentifiziert Paket-Downloads nicht mit Ihrem Account-Passwort. Stattdessen generieren Sie ein Identity Token – ein langlebiges Anmeldeinformationselement, das mit Ihrem Konto verknüpft ist – und verwenden es als Passwort, wann immer diese Anleitung eines anfordert, einschließlich in Ihrem .npmrc und in curl Befehlen. Sie müssen es nur einmal erstellen.

Der einfachste Weg, ein Identity Token zu erstellen, ist über die Agora-Webanwendung. Nach dem Anmelden erstellen Sie eines, indem Sie auf die Schaltfläche mit der Beschriftung Willkommen Ihre-E-Mail-Adresse in der obersten Leiste neben der Hilfsschaltfläche klicken.

Identity Tokens laufen jährlich ab und können nur einmal bei der Erstellung eingesehen werden. Bewahren Sie Ihres an einem sicheren Ort auf.

Was Agora beherbergt

Agora führt die gleichen Artefakte, die in die öffentlichen Register veröffentlicht werden, für stabile Versionen:

Nur stabile Versionen werden auf Agora veröffentlicht. Canary- (next) und Release-Kandidat- (rc) Builds bleiben nur auf npmjs.org.

npm-Distribution

Authentifizierung hinzufügen

Um über npm oder Yarn auf Deque-Pakete zuzugreifen, fügen Sie Ihre Agora-Authentifizierungsinformationen in Ihre ~/.npmrc Datei ein. Das Konfigurieren des Zugriffs auf Agora-Pakete Tool kann diesen Inhalt für Sie aus Ihrer Agora-E-Mail und Ihrem Identity Token generieren. Andernfalls generieren Sie ihn mit einem curl-Befehl:

curl -u "<your-email>" "https://agora.dequecloud.com/artifactory/api/npm/auth"

Ersetzen Sie <your-email> durch Ihre Agora-Login-E-Mail. curl fragt nach einem Passwort – fügen Sie das oben erstellte Identity Token ein. Der Befehl gibt zurück:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Öffnen Sie Ihre ~/.npmrc zur Bearbeitung und fügen Sie die Registry-Zuordnung gefolgt von der Ausgabe des curl-Befehls hinzu:

@deque:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth=<generated-auth-string>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Wenn Sie keine curl-Befehle ausführen können, generieren Sie die Authentifizierungszeichenkette selbst, indem Sie <your-email>:<your-identity-token> base-64 codieren.

Überprüfen Ihres Zugangs

Bevor Sie etwas installieren, bestätigen Sie, dass Ihre Zugangsdaten funktionieren und dass Ihr Agora-Konto beide Pakete sehen kann:

npm view @deque/axe-auth versions
npm view axe-mcp-server versions --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

Jeder Befehl sollte eine Liste der veröffentlichten Versionen ausgeben. Wenn einer von beiden fehlschlägt, siehe Fehlerbehebung unten – es ist einfacher, das jetzt zu lösen, als es mitten in einer Installation zu diagnostizieren.

Installation von @deque/axe-auth

@deque/axe-auth — das CLI, das für OAuth 2.0-Authentifizierung verwendet wird — ist ein Scoped-Package, daher reicht die oben stehende @deque:registry-Zeile aus. Jeder dokumentierte axe-auth-Befehl funktioniert unverändert und wird von Agora anstelle von npmjs.org bezogen:

npx @deque/axe-auth login

Dies bedeutet auch, dass MCP-Client-Konfigurationen, die den Server in npx -y @deque/axe-auth run einbinden, nicht geändert werden müssen.

Installation von axe-mcp-server

axe-mcp-server ist ein ungescoptes Paket, und npm kann Registries nur nach Scope zuordnen. Es gibt keine .npmrc-Zeile, die ein einzelnes ungescoptes Paket zu Agora leitet, daher installieren Sie es stattdessen von seinem Tarball.

Laden Sie den Tarball für die gewünschte Version herunter und ersetzen Sie <version> durch eine veröffentlichte Version wie 1.4.0 — siehe Versionshinweise. npm pack authentifiziert sich mit den bereits in Ihrem .npmrc vorhandenen Anmeldeinformationen, sodass kein separates Download-Tool oder Token-Handling erforderlich ist:

npm pack axe-mcp-server@<version> --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

Installieren Sie es dann global, was einen axe-mcp-server-Befehl auf Ihrem PATH erstellt:

npm install -g ./axe-mcp-server-<version>.tgz

Die playwright-Abhängigkeit wird während dieses zweiten Schritts von Ihrem Standard-Registry bezogen. Die Trennung des Downloads von der Installation hält diese Auflösung intakt.

Die npm-Distribution läuft auf Node.js. Verwenden Sie ein aktive LTS-Version von Node.js – ältere Versionen werden möglicherweise nicht unterstützt.

Denken Sie daran, dass die npm-Verteilung auch einen Chromium-Browser benötigt. Siehe Chromium installieren, und beachten Sie, dass der Befehl dort die Playwright-Version von npmjs.org ableitet. Um sie stattdessen aus Agora zu lesen, fügen Sie das Registry-Override hinzu — npm view ruft ein einzelnes Paket ab, daher ist das Override hier aus dem gleichen Grund sicher wie bei npm pack:

npm view axe-mcp-server@<version> dependencies.playwright --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

Konfiguration Ihres MCP-Clients

Da der Server global installiert ist und nicht bei Bedarf abgerufen wird, rufen Sie den installierten Befehl direkt auf, anstatt über npx zu gehen. Verwenden Sie VS Code mit Copilot und einem API-Schlüssel als Beispiel:

{
  "servers": {
    "axe-mcp-server": {
      "command": "axe-mcp-server",
      "args": [],
      "env": {
        "AXE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Für OAuth 2.0 starten Sie den Server durch @deque/axe-auth run auf die gleiche Weise, wie es die anderen Anleitungen tun, und ersetzen Sie die npx -y axe-mcp-server-Aufruf mit dem installierten Befehl:

{
  "servers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "@deque/axe-auth", "run", "--", "axe-mcp-server"],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}

Alles andere im Client-Einrichtungsanleitungen gilt wie geschrieben — nur command und args unterscheiden sich. Die gleiche Ersetzung funktioniert für Cursor und Claude Code.

Upgrade

Wiederholen Sie den Download und die globale Installation mit der neuen Versionsnummer. Prüfen Sie Versionshinweise, um zu sehen, was verfügbar ist.

Docker-Verteilung

Agora hostet das Docker-Image als gespeicherte Tar-Dateien, eine pro Architektur, unter devtools-bin/axe-mcp-server/v<version>/.

Ersetzen Sie <version> durch eine veröffentlichte Version wie 1.4.0, und <arch> durch die zu Ihrer Maschine passende Architektur — amd64 für Intel und AMD, arm64 für Apple Silicon und ARM:

curl -u "<your-email>" \
  -O "https://agora.dequecloud.com/artifactory/devtools-bin/axe-mcp-server/v<version>/axe-mcp-server-<version>-<arch>.tar"

curl fordert nach einem Passwort — geben Sie Ihr Identity Token ein. Es stattdessen inline anzugeben, wie -u "<your-email>:<your-identity-token>", funktioniert auch, hinterlässt das Token jedoch in Ihrem Shell-Verlauf.

Laden Sie es in Docker:

docker load -i axe-mcp-server-<version>-<arch>.tar

docker tag dequesystems/axe-mcp-server:v<version> dequesystems/axe-mcp-server:latest

Mit dem geladenen Image funktionieren die Docker-Konfigurationen im Client-Einrichtungsanleitungen unverändert. docker run verwendet das lokale Image und kontaktiert nicht den Docker-Hub.

Um ein Upgrade durchzuführen, laden Sie das Tar für die neuere Version herunter und laden es.

Installation über Ihr eigenes Artefakt-Repository

Wenn Ihre Organisation bereits ein Artefakt-Repository wie Artifactory oder Nexus betreibt, ist das Proxying von Agora dadurch normalerweise die bessere Option. Entwickler benötigen dann keine eigenen Agora-Zugangsdaten, beide Pakete werden normal aufgelöst, und — im Gegensatz zur oben beschriebenen Tarball-Methode — funktioniert npx -y axe-mcp-server wie überall sonst dokumentiert.

Dies ist die gleiche Agora-Verbindung wie für die anderen Axe DevTools-Pakete, sodass die bestehenden Einrichtungshinweise gelten — folgen Sie der für Ihren Repository-Manager und wählen Sie den npm-Pakettyp und die npm-Registry-URL https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/:

• Richten Sie Ihr Artifactory ein
• Richten Sie Ihr Nexus ein

Eine Ergänzung, die speziell für den axe MCP Server gilt: da axe-mcp-server von playwright abhängt, aggregieren Sie das Agora-Remote-Repository und Ihr bestehendes npmjs.org-Remote zu einem einzigen virtuelles-Repository und weisen Sie die registry=-Entwickler darauf hin. Pakete von Deque werden dann von Agora und deren öffentliche Abhängigkeiten über npmjs.org über eine URL aufgelöst, und npx -y axe-mcp-server funktioniert genauso wie im Client-Einrichtungsanleitungen.

Verfügbarkeit von Versionen

Agora führt stabile Versionen von beiden npm-Paketen, und das latest-Tag wird auf die neueste stabile Version aufgelöst, wie es auf npmjs.org der Fall ist. Die Tags next und rc werden nicht mitgeführt; Vorab-Versionen sind nur auf npmjs.org verfügbar.

Wenn Sie eine bestimmte Version benötigen, installieren Sie sie per exakter Versionsangabe.

Fehlerbehebung

Bei Problemen beim Ausführen des Servers, nachdem er installiert wurde, siehe den axe MCP-Server-Fehlerbehebung-Guide.

Nächste Schritte

1. Authentifizierung einrichten — ein API-Schlüssel oder OAuth 2.0
2. Konfigurieren Sie Ihren Client — VS Code mit Copilot, Cursor oder Claude Code

Wenn Sie Probleme bei der Installation über Agora haben, wenden Sie sich direkt an Ihren Deque-Ansprechpartner, fragen Sie uns über unseren Helpdesk oder senden Sie uns eine E-Mail.