Instalación desde el Agora de Deque

Si la red de su organización restringe el acceso a registros públicos como npmjs.org y Docker Hub, puede obtener el servidor MCP de axe desde Agora en su lugar. Ambas distribuciones están disponibles allí: los paquetes npm y la imagen de Docker.

Agora es el propio repositorio de artefactos de Deque, alojado en agora.dequecloud.com, donde Deque publica los paquetes e imágenes que sus clientes instalan. Funciona sobre Artifactory, por lo que se comporta como cualquier otro registro npm o fuente de artefactos que su herramienta ya entiende, y su organización puede hacerle proxy desde su propio gestor de repositorios.

Esta guía cubre específicamente el servidor MCP de axe. Para otros paquetes de Axe DevTools, vea Instalación de Axe DevTools para Web para Node.js desde el Agora de Deque.

Requisitos previos

• Credenciales de inicio de sesión de Agora. Si no las tiene, contacte a su representante de Deque o a la mesa de ayuda.
• Una distribución elegida — vea Elegir una Distribución.
• Para la distribución npm, Node.js 22.19.0 o posterior.
• Para la distribución de Docker, Docker instalado y en funcionamiento.

Creación de un Token de Identidad

Agora no autentica las descargas de paquetes con la contraseña de su cuenta. En su lugar, usted genera un Token de Identidad — una credencial de larga duración vinculada a su cuenta — y lo usa como contraseña donde estas instrucciones lo soliciten, incluyendo en su .npmrc y en los comandos de curl. Solo necesita crearlo una vez.

La forma más sencilla de crear un Token de Identidad es a través de la aplicación web de Agora. Una vez conectado, créelo haciendo clic en el botón etiquetado Bienvenido su-dirección-de-correo en la barra superior junto al botón de ayuda.

Los Tokens de Identidad caducan anualmente y solo se pueden ver una vez, al momento de la creación. Guarde el suyo en un lugar seguro.

Lo que Aloja Agora

Agora lleva los mismos artefactos publicados en los registros públicos, para lanzamientos estables:

Solo se publican lanzamientos estables en Agora. Las versiones Canary (next) y las candidatas a lanzamiento (rc) permanecen solo en npmjs.org.

Distribución npm

Añadiendo Autenticación

Para acceder a los paquetes de Deque a través de npm o Yarn, añada su información de autenticación de Agora a su archivo ~/.npmrc. La herramienta Configuración de Acceso a los paquetes de Agora puede generar este contenido por usted a partir de su correo electrónico de Agora y su Token de Identidad. De lo contrario, genérelo con un comando curl:

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

Reemplace <your-email> con su correo de inicio de sesión de Agora. curl le pedirá una contraseña — pegue el Token de Identidad que creó anteriormente. El comando devuelve:

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

Abra su ~/.npmrc para editarlo y agregue el mapeo del registro seguido del resultado del comando 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 no puede ejecutar comandos curl, genere usted mismo la cadena de autenticación codificándola en base-64 <your-email>:<your-identity-token>.

Verificando su Acceso

Antes de instalar nada, confirme que sus credenciales funcionan y que su cuenta de Agora puede ver ambos paquetes:

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

Cada comando debería imprimir una lista de versiones publicadas. Si alguno falla, vea Solución de problemas abajo — resolverlo ahora es más fácil que diagnosticarlo a mitad de una instalación.

Instalación de @deque/axe-auth

@deque/axe-auth — el CLI utilizado para autenticación OAuth 2.0 — es un paquete con ámbito, por lo que la línea @deque:registry anterior es todo lo que necesita. Cada comando documentado de axe-auth funciona sin cambios, resolviendo desde Agora en lugar de npmjs.org:

npx @deque/axe-auth login

Esto también significa que las configuraciones de cliente MCP que envuelven el servidor en npx -y @deque/axe-auth run no necesitan modificaciones.

Instalación de axe-mcp-server

axe-mcp-server es un paquete sin ámbito, y npm solo puede mapear registros por ámbito. No hay una línea .npmrc que dirija un único paquete sin ámbito a Agora, así que instálelo desde su tarball en su lugar.

Descargue el tarball para la versión que desea, reemplazando <version> con una versión liberada como 1.4.0 — vea Notas de la versión. npm pack se autentica con las credenciales ya en su .npmrc, por lo que no se necesita una herramienta de descarga o manejo de token por separado:

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

Luego instálelo globalmente, lo que pone un comando axe-mcp-server en su PATH:

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

La dependencia playwright se obtiene de su registro predeterminado durante este segundo paso. Separar la descarga de la instalación es lo que mantiene funcionando dicha resolución.

La distribución de npm se ejecuta en Node.js. Use un versión activa LTS de Node.js — es posible que las versiones anteriores no sean compatibles.

Recuerde que la distribución de npm también necesita un navegador Chromium. Vea Instalar Chromium, y tenga en cuenta que el comando ahí deriva la versión de Playwright de npmjs.org. Para leerla desde Agora en su lugar, añada la anulación de registro — npm view obtiene un solo paquete, por lo que la anulación es segura aquí por la misma razón que lo es en npm pack:

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

Configuración de su cliente MCP

Debido a que el servidor está instalado globalmente en lugar de obtenerlo a demanda, llame al comando instalado directamente en lugar de pasar por npx. Usando VS Code con Copilot y una clave API como ejemplo:

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

Para OAuth 2.0, inicie el servidor a través de @deque/axe-auth run de la misma manera que lo hacen las otras guías, reemplazando la npx -y axe-mcp-server invocación con el comando instalado:

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

Todo lo demás en el guías de configuración del cliente se aplica tal como está escrito, solo command y args difieren. La misma sustitución funciona para Cursor y Claude Code.

Actualización

Repita la descarga e instalación global con el nuevo número de versión. Consulte Notas de la versión para ver qué está disponible.

Distribución de Docker

Agora aloja la imagen de Docker como archivos tar guardados, uno por arquitectura, en devtools-bin/axe-mcp-server/v<version>/.

Reemplace <version> con una versión liberada como 1.4.0, y <arch> con la arquitectura que coincida con su máquina — amd64 para Intel y AMD, arm64 para silicio de Apple y 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 pide una contraseña — pegue su Token de Identidad. Proporcionarlo en línea, como -u "<your-email>:<your-identity-token>", también funciona pero deja el token en el historial de su terminal.

Cárguelo en Docker:

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

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

Con la imagen cargada, las configuraciones de Docker en el guías de configuración del cliente funcionan sin cambios. docker run usa la imagen local y no contacta Docker Hub.

Para actualizar, descargue y cargue el tar para la versión más reciente.

Instalación a través de su propio repositorio de artefactos

Si su organización ya opera un repositorio de artefactos como Artifactory o Nexus, normalmente la mejor opción es proxyar Agora a través de él. Los desarrolladores entonces no necesitarán credenciales de Agora propias, los paquetes se resuelven normalmente, y — a diferencia del enfoque del tarball descrito anteriormente — npx -y axe-mcp-server funciona tal como se documenta en otros lugares.

Esta es la misma conexión de Agora utilizada para los otros paquetes de Axe DevTools, por lo que las guías de configuración existentes se aplican — siga la que corresponda a su gestor de repositorios, eligiendo el tipo de paquete npm y la URL del registro npm https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/:

• Configurar su Artifactory
• Configurar su Nexus

Una adición específica para el servidor axe MCP: dado que axe-mcp-server depende de playwright, agregue el repositorio remoto de Agora y su existente remoto de npmjs.org en un solo repositorio virtual, luego apunte el registry= de los desarrolladores a ese. Luego, los paquetes de Deque se resuelven desde Agora y sus dependencias públicas desde npmjs.org a través de una sola URL, y npx -y axe-mcp-server funciona exactamente como lo hace en el guías de configuración del cliente.

Disponibilidad de versiones

Agora lleva las versiones estables de ambos paquetes npm, y la etiqueta latest se resuelve a la versión estable más reciente, tal como ocurre en npmjs.org. Las etiquetas next y rc no se llevan; las compilaciones previas al lanzamiento solo permanecen disponibles en npmjs.org.

Si necesita una versión específica, instálela por versión exacta.

Solución de problemas

Para problemas al ejecutar el servidor una vez instalado, consulta la guía axe MCP Server Solución de problemas.

Próximos pasos

1. Configurar autenticación: una clave API o OAuth 2.0
2. Configura tu cliente: VS Code con Copilot, Cursor o Claude Code

Si tienes problemas para instalar desde Agora, contacta directamente a tu representante Deque, pregúntanos a través de nuestra mesa de ayuda, o envíanos un correo electrónico.