Installeren vanuit Deque's Agora

Als het netwerk van uw organisatie de toegang tot openbare registers zoals npmjs.org en Docker Hub beperkt, kunt u de axe MCP Server in plaats daarvan verkrijgen van Agora. Beide distributies zijn daar beschikbaar: de npm-pakketten en de Docker-image.

Agora is Deque's eigen artifactrepository, gehost op agora.dequecloud.com, waar Deque de pakketten en afbeeldingen publiceert die haar klanten installeren. Het draait op Artifactory, dus het gedraagt zich als elk ander npm-register of artifactbron die uw tooling al begrijpt, en uw organisatie kan het via zijn eigen repositorymanager doorgeven.

Deze handleiding behandelt specifiek de axe MCP Server. Voor andere Axe DevTools-pakketten, zie Axe DevTools for Web voor Node.js installeren vanuit Deque's Agora.

Vereisten

• Agora-aanmeldingsgegevens. Als u deze niet heeft, neem dan contact op met uw Deque-vertegenwoordiger of de supportdesk.
• Een gekozen distributie — zie Een distributie kiezen.
• Voor de npm-distributie, Node.js 22.19.0 of later.
• Voor de Docker-distributie, Docker geïnstalleerd en draaiend.

Een Identiteitstoken maken

Agora authenticatieert pakketdownloads niet met uw accountwachtwoord. In plaats daarvan genereert u een Identiteitstoken — een langlopende referentie gekoppeld aan uw account — en gebruikt u deze als wachtwoord waar deze instructies erom vragen, inclusief in uw .npmrc en in curl-opdrachten. U hoeft het maar één keer aan te maken.

De eenvoudigste manier om een Identiteitstoken te maken is via de Agora-webapp. Nadat u bent ingelogd, maakt u er een aan door op de knop met het label Welkom uw-e-mailadres te klikken in de bovenbalk naast de helpknop.

Identiteitstokens verlopen jaarlijks en kunnen alleen bij aanmaak worden bekeken. Bewaar deze ergens veilig.

Wat Agora Host

Agora bevat dezelfde artifacts die naar de openbare registers worden gepubliceerd, voor stabiele releases:

Alleen stabiele releases worden gepubliceerd naar Agora. Canary (next) en release candidate (rc) builds blijven alleen op npmjs.org.

npm-distributie

Authenticatie toevoegen

Om toegang te krijgen tot Deque-pakketten via npm of Yarn, voegt u uw Agora-authenticatiegegevens toe aan uw ~/.npmrc-bestand. De Toegang tot Agora-pakketten configureren-tool kan deze inhoud voor u genereren met uw Agora-email en Identiteitstoken. Anders genereert u het met een curl-opdracht:

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

Vervang <your-email> door uw Agora-aanmeldingsmail. curl vraagt om een wachtwoord — plak het Identiteitstoken dat u hierboven heeft aangemaakt. De opdracht geeft het volgende terug:

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

Open uw ~/.npmrc voor bewerking en voeg de registry-mapping toe gevolgd door de uitvoer van de curl-opdracht:

@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

Als u geen curl-opdrachten kunt uitvoeren, genereer de auth-string dan zelf door <your-email>:<your-identity-token> te basis-64 coderen.

Uw toegang verifiëren

Bevestig voordat u iets installeert of uw referenties werken en of uw Agora-account beide pakketten kan zien:

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

Elke opdracht zou een lijst met gepubliceerde versies moeten afdrukken. Als een van beide mislukt, zie Probleemoplossing hieronder — het nu oplossen is eenvoudiger dan diagnostiek halverwege een installatie.

Installeren van @deque/axe-auth

@deque/axe-auth — de CLI die wordt gebruikt voor OAuth 2.0-authenticatie — is een beperkt pakket, dus de @deque:registry regel hierboven is alles wat het nodig heeft. Elke gedocumenteerde axe-auth-opdracht werkt ongewijzigd en wordt opgelost vanuit Agora in plaats van npmjs.org:

npx @deque/axe-auth login

Dit betekent ook dat MCP-clientconfiguraties die de server omsluiten in npx -y @deque/axe-auth run geen aanpassing nodig hebben.

axe-mcp-server installeren

axe-mcp-server is een niet-beperkt pakket en npm kan alleen registers per scope toewijzen. Er is geen .npmrc regel die een enkel niet-beperkt pakket naar Agora stuurt, dus installeer het in plaats daarvan vanuit de tarball.

Download de tarball voor de versie die je wilt, vervang <version> door een vrijgegeven versie zoals 1.4.0 — zie Release-opmerkingen. npm pack authenticeert met de reeds in je .npmrc aanwezige inloggegevens, dus geen aparte downloadtool of tokenverwerking is nodig:

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

Installeer het vervolgens wereldwijd, waardoor een axe-mcp-server-opdracht op je PATH wordt geplaatst:

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

De playwright-afhankelijkheid wordt tijdens deze tweede stap van je standaardregister gehaald. Het scheiden van de download en de installatie zorgt ervoor dat die oplossing blijft werken.

De npm-distributie draait op Node.js. Gebruik een actieve Node.js LTS-release — oudere versies worden mogelijk niet ondersteund.

Vergeet niet dat de npm-distributie ook een Chromium-browser nodig heeft. Zie Chromium installeren, en merk op dat het commando daar de Playwright-versie van npmjs.org afleidt. Om het in plaats daarvan van Agora te lezen, voeg de register-override toe — npm view haalt een enkel pakket op, dus de override is hier veilig om dezelfde reden als op npm pack:

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

Je MCP-client configureren

Omdat de server wereldwijd wordt geïnstalleerd in plaats van op aanvraag opgehaald, roep je het geïnstalleerde commando direct aan in plaats van via npx te gaan. Gebruik VS Code met Copilot en een API-sleutel als voorbeeld:

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

Voor OAuth 2.0, start de server via @deque/axe-auth run op dezelfde manier als de andere gidsen dat doen, en vervang de npx -y axe-mcp-server aanroep door de geïnstalleerde opdracht:

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

Al het andere in de client installatiehandleidingen is van toepassing zoals geschreven — alleen command en args verschillen. Dezelfde vervanging werkt voor Cursor en Claude Code.

Upgraden

Herhaal de download en globale installatie met het nieuwe versienummer. Controleer Release-opmerkingen voor wat beschikbaar is.

Docker-distributie

Agora host de Docker-afbeelding als opgeslagen tars, één per architectuur, bij devtools-bin/axe-mcp-server/v<version>/.

Vervang <version> door een vrijgegeven versie zoals 1.4.0, en <arch> door de architectuur die bij je machine past — amd64 voor Intel en AMD, arm64 voor Apple Silicon en 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 vraagt om een wachtwoord — plak je Identity Token. Het in plaats daarvan inline aanleveren, als -u "<your-email>:<your-identity-token>", werkt ook maar laat het token in je shellgeschiedenis achter.

Laad het in Docker:

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

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

Met de afbeelding geladen werken de Docker-configuraties in de client installatiehandleidingen ongewijzigd. docker run gebruikt de lokale afbeelding en neemt geen contact op met Docker Hub.

Om te upgraden download en laad je de tar voor de nieuwere versie.

Installeren via je eigen artefactrepository

Als je organisatie al een artefactrepository zoals Artifactory of Nexus heeft, is het doorgaans beter om Agora via die weg te proxyen. Ontwikkelaars hebben dan geen eigen Agora-inloggegevens nodig, beide pakketten worden normaal opgelost, en — in tegenstelling tot de hierboven genoemde tarball-methode — werkt npx -y axe-mcp-server zoals gedocumenteerd overal anders.

Dit is dezelfde Agora-verbinding die wordt gebruikt voor de andere Axe DevTools-pakketten, dus de bestaande installatiehandleidingen zijn van toepassing — volg de handleiding voor je repositorymanager, kies het npm pakkettetype en de npm-register-URL https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/:

• Je Artifactory instellen
• Je Nexus instellen

Eén toevoeging specifiek voor de axe MCP Server: omdat axe-mcp-server afhankelijk is van playwright, aggregeer je de Agora-remote repository en je bestaande npmjs.org-remote in een enkele virtueel repository, en wijs je de registry= van ontwikkelaars daarop. Deque's pakketten worden dan opgelost vanuit Agora en hun publieke afhankelijkheden via npmjs.org via één URL, en npx -y axe-mcp-server werkt precies zoals in de client installatiehandleidingen.

Versiebeschikbaarheid

Agora bevat stabiele releases van beide npm-pakketten, en de latest-tag lost op naar de nieuwste stabiele release, net als op npmjs.org. De next- en rc-tags worden niet gedragen; prerelease builds blijven alleen beschikbaar van npmjs.org.

Als je een specifieke release nodig hebt, installeer het dan op exacte versie.

Probleemoplossing

Voor problemen met het draaien van de server zodra deze is geïnstalleerd, zie de axe MCP Server Probleemoplossing gids.

Volgende stappen

1. Authenticatie instellen — een API-sleutel of OAuth 2.0
2. Configureer je client — VS Code met Copilot, Cursor, of Claude Code

Als je problemen hebt met installeren vanuit Agora, neem direct contact op met je Deque-vertegenwoordiger, vraag ons via onze supportdesk, of stuur ons een e-mail.