Installation depuis Agora de Deque

Si le réseau de votre organisation restreint l'accès aux registres publics tels que npmjs.org et Docker Hub, vous pouvez obtenir le serveur axe MCP depuis Agora à la place. Les deux distributions y sont disponibles : les packages npm et l'image Docker.

Agora est le dépôt de packages de Deque, hébergé à agora.dequecloud.com, où Deque publie les packages et images que ses clients installent. Il fonctionne sur Artifactory, donc il opère comme n'importe quel autre registre npm ou source d'artefacts que vos outils comprennent déjà, et votre organisation peut le proxifier depuis son propre gestionnaire de dépôt.

Ce guide couvre spécifiquement le serveur axe MCP. Pour d'autres packages Axe DevTools, voir Installation des Axe DevTools pour le Web pour Node.js depuis Agora de Deque.

Prérequis

• Identifiants de connexion Agora. Si vous ne les avez pas, contactez votre représentant Deque ou le bureau d'assistance.
• Une distribution choisie — voir Choisir une distribution.
• Pour la distribution npm, Node.js 22.19.0 ou plus récente.
• Pour la distribution Docker, Docker installé et en fonctionnement.

Créer un jeton d'identité

Agora n'authentifie pas les téléchargements de packages avec le mot de passe de votre compte. À la place, vous générez un jeton d'identité — un identifiant de longue durée lié à votre compte — et l'utilisez comme mot de passe partout où ces instructions le demandent, y compris dans vos .npmrc et dans les commandes curl. Vous n'avez besoin de le créer qu'une seule fois.

La manière la plus simple de créer un jeton d'identité est via l'application web Agora. Une fois connecté, créez-en un en cliquant sur le bouton intitulé Bienvenue votre-adresse-email dans la barre supérieure à côté du bouton d'aide.

Les jetons d'identité expirent chaque année et ne peuvent être vus qu'une fois, lors de leur création. Conservez le vôtre en lieu sûr.

Ce qu'Agora héberge

Agora contient les mêmes artefacts publiés sur les registres publics, pour les versions stables :

Seules les versions stables sont publiées sur Agora. Les builds Canary (next) et release candidate (rc) restent uniquement sur npmjs.org.

Distribution npm

Ajouter l'authentification

Pour accéder aux packages de Deque via npm ou Yarn, ajoutez vos informations d'authentification Agora à votre fichier ~/.npmrc. L'outil Configurer l'accès aux packages Agora peut générer ce contenu pour vous à partir de votre email Agora et du jeton d'identité. Sinon, générez-le avec une commande curl :

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

Remplacez <your-email> par votre email de connexion Agora. curl demande un mot de passe — collez le jeton d'identité que vous avez créé plus haut. La commande renvoie :

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

Ouvrez votre ~/.npmrc pour édition et ajoutez la cartographie du registre suivie de la sortie de la commande curl :

@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

Si vous ne pouvez pas exécuter les commandes curl, générez la chaîne d'authentification vous-même en encodant en base-64 <your-email>:<your-identity-token>.

Vérification de votre accès

Avant d'installer quoi que ce soit, confirmez que vos informations d'identification fonctionnent et que votre compte Agora peut voir les deux packages :

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

Chaque commande devrait imprimer une liste des versions publiées. Si l'une d'elles échoue, consultez Dépannage ci-dessous — le résoudre maintenant est plus facile que de diagnostiquer cela en cours d'installation.

Installation de @deque/axe-auth

@deque/axe-auth — le CLI utilisé pour authentification OAuth 2.0 — est un package limité à un domaine, donc la ligne @deque:registry ci-dessus est tout ce dont il a besoin. Toutes les commandes axe-auth documentées fonctionnent inchangées, résolvant depuis Agora plutôt que npmjs.org :

npx @deque/axe-auth login

Cela signifie également que les configurations clientes MCP qui encapsulent le serveur dans npx -y @deque/axe-auth run n'ont besoin d'aucune modification.

Installation de axe-mcp-server

axe-mcp-server est un package non limité à un domaine, et npm ne peut mapper les registres qu'en fonction du domaine. Il n'y a pas de ligne .npmrc qui redirige un seul package non limité vers Agora, alors installez-le à partir de son tarball à la place.

Téléchargez le tarball pour la version souhaitée, en remplaçant <version> par une version publiée telle que 1.4.0 — voir Notes de version. npm pack s'authentifie avec les identifiants déjà présents dans votre .npmrc, donc aucun outil de téléchargement séparé ou gestion de jeton n'est nécessaire :

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

Installez-le ensuite globalement, ce qui met une commande axe-mcp-server sur votre PATH :

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

La dépendance playwright est récupérée depuis votre registre par défaut lors de cette deuxième étape. Séparer le téléchargement de l'installation est ce qui permet à cette résolution de fonctionner.

La distribution npm fonctionne sur Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes pourraient ne pas être prises en charge.

Rappelez-vous que la distribution npm nécessite également un navigateur Chromium. Voir Installer Chromium, et notez que la commande y dérive la version de Playwright de npmjs.org. Pour la lire depuis Agora à la place, ajoutez le remplacement du registre — npm view récupère un seul package, donc le remplacement est sûr ici pour la même raison qu'il l'est sur npm pack :

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

Configurer votre client MCP

Étant donné que le serveur est installé globalement plutôt que récupéré à la demande, appelez la commande installée directement au lieu de passer par npx. En utilisant VS Code avec Copilot et une clé API comme exemple :

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

Pour OAuth 2.0, lancez le serveur à travers @deque/axe-auth run de la même manière que les autres guides, en remplaçant l'npx -y axe-mcp-server invocation par la commande installée :

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

Tout le reste dans le guides de configuration du client s'applique tel quel — seuls command et args diffèrent. La même substitution fonctionne pour Curseur et Claude Code.

Mise à niveau

Répétez le téléchargement et l'installation globale avec le nouveau numéro de version. Vérifiez Notes de version pour ce qui est disponible.

Distribution Docker

Agora héberge l'image Docker sous forme de tars sauvegardés, un par architecture, à devtools-bin/axe-mcp-server/v<version>/.

Remplacez <version> par une version publiée telle que 1.4.0, et <arch> par l'architecture correspondant à votre machine — amd64 pour Intel et AMD, arm64 pour le silicium d'Apple et 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 demande un mot de passe — collez votre jeton d'identité. Le fournir en ligne à la place, comme -u "<your-email>:<your-identity-token>", fonctionne aussi mais laisse le jeton dans l'historique de votre shell.

Chargez-le dans Docker :

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

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

Avec l'image chargée, les configurations Docker dans guides de configuration du client fonctionnent sans changement. docker run utilise l'image locale et ne contacte pas Docker Hub.

Pour mettre à jour, téléchargez et chargez le tar pour la nouvelle version.

Installation via votre propre dépôt d'artefacts

Si votre organisation gère déjà un dépôt d'artefacts tel qu'Artifactory ou Nexus, le proxy Agora à travers celui-ci est généralement la meilleure option. Les développeurs n'ont alors pas besoin d'identifiants Agora, les deux packages se résolvent normalement, et — contrairement à l'approche du tarball ci-dessus — npx -y axe-mcp-server fonctionne comme documenté partout ailleurs.

C'est la même connexion Agora utilisée pour les autres packages Axe DevTools, donc les guides de configuration existants s'appliquent — suivez celui de votre gestionnaire de dépôts, en choisissant le type de package npm et l'URL du registre npm https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/ :

• Configurez votre Artifactory
• Configurez votre Nexus

Une addition spécifique au serveur axe MCP : parce que axe-mcp-server dépend de playwright, agrégez le dépôt distant Agora et votre dépôt distant npmjs.org existant en un seul dépôt virtuel, puis dirigez les registry= des développeurs vers celui-ci. Les packages de Deque se résolvent alors depuis Agora et leurs dépendances publiques depuis npmjs.org via une seule URL, et npx -y axe-mcp-server fonctionne exactement comme dans le guides de configuration du client.

Disponibilité des versions

Agora propose des versions stables de deux packages npm, et le tag latest se résout à la dernière version stable, comme sur npmjs.org. Les tags next et rc ne sont pas proposés ; les versions préliminaires restent disponibles uniquement sur npmjs.org.

Si vous avez besoin d'une version spécifique, installez-la par version exacte.

Dépannage

Pour les problèmes d'exécution du serveur une fois installé, consultez le guide axe MCP Server Dépannage.

Étapes suivantes

1. Configurer l'authentification — une clé API ou OAuth 2.0
2. Configurez votre client — VS Code avec Copilot, Curseur, ou Claude Code

Si vous rencontrez des difficultés lors de l'installation depuis Agora, contactez directement votre représentant Deque, posez-nous une question via notre bureau d'assistance, ou envoyez-nous un e-mail.