Configuración en Cursor
Antes de configurar, elija una distribución (Docker o npm) y configure la autenticación (clave API o OAuth 2.0). Luego agrega la configuración correspondiente abajo.
El servidor Axe MCP se puede agregar a nivel de proyecto o global:
- A nivel de proyecto: Crea un archivo en
.cursor/mcp.jsonen el directorio raíz de tu proyecto - A nivel global: Abre la configuración de Cursor, ve a Características > MCP y haz clic en Agregar nuevo servidor MCP. Esto abrirá tu archivo de configuración global.
Si ya tienes otros servidores definidos, añade el bloque axe-mcp-server dentro del objeto mcpServers existente.
Docker
Clave API
Instalación con un clic
Haga clic en el siguiente enlace para instalar el servidor axe MCP directamente en Cursor:
Instalar el servidor axe MCP en Cursor
Cursor le pedirá que confirme la instalación. Alternativamente, siga la configuración manual a continuación.
Configuración manual
{
"mcpServers": {
"axe-mcp-server": {
"command": "docker",
"args": [
"run",
"--add-host=host.docker.internal:host-gateway",
"-i",
"--rm",
"-e",
"AXE_SERVER_URL",
"-e",
"AXE_API_KEY",
"dequesystems/axe-mcp-server:latest"
],
"env": {
"AXE_API_KEY": "${env:AXE_API_KEY}"
}
}
}
}La configuración utiliza "AXE_API_KEY": "${env:AXE_API_KEY}" para un manejo seguro de entradas. La sintaxis ${env:AXE_API_KEY} instruye a Cursor a extraer el valor de tus variables del sistema. Para más información, consulta documentación de Cursor MCP.
¿Está utilizando una instancia regional, nube privada o local de axe? Añade AXE_SERVER_URL al bloque env con la URL base de tu instancia:
"env": {
"AXE_API_KEY": "${env:AXE_API_KEY}",
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}Si se omite, el servidor por defecto es https://axe.deque.com (instancia SaaS compartida de Deque en EE.UU.). Consulta Referencia de Configuración para más detalles.
OAuth 2.0
Antes de configurar, complete Paso 1: Autenticar en la guía de Autenticación.
Esto utiliza @deque/axe-auth token para obtener un token de acceso nuevo cada vez que el servidor se inicia.
{
"mcpServers": {
"axe-mcp-server": {
"command": "sh",
"args": [
"-c",
"docker run --add-host=host.docker.internal:host-gateway -i --rm -e \"AXE_ACCESS_TOKEN=$(npx -y @deque/axe-auth token)\" dequesystems/axe-mcp-server:latest"
]
}
}
}¿Utiliza una instancia de axe en una nube regional, privada o local? Agregue AXE_SERVER_URL al comando de Docker y un bloque de env con la URL base de su instancia:
"args": [
"-c",
"docker run --add-host=host.docker.internal:host-gateway -i --rm -e AXE_SERVER_URL -e \"AXE_ACCESS_TOKEN=$(npx -y @deque/axe-auth token)\" dequesystems/axe-mcp-server:latest"
],
"env": {
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}Si se omite, el servidor usa por defecto https://axe.deque.com (la instancia compartida de SaaS de Deque en EE.UU.). Consulte Referencia de Configuración para más detalles.
Esta configuración usa sh -c para permitir la sustitución de shell. $(npx -y @deque/axe-auth token) se ejecuta al iniciar el servidor e inyecta un token de acceso válido en el contenedor Docker. El indicador -y omite el mensaje de "¿Está bien continuar?" que npx preguntaría de otro modo en una shell no interactiva. No configure AXE_API_KEY junto con AXE_ACCESS_TOKEN.
Usuarios de Windows: Esta configuración utiliza un shell POSIX (sh) y sustitución de comandos ($(...)), lo cual no está disponible en cmd.exe o PowerShell por defecto. Ejecute su editor desde un shell de Git Bash o WSL para que sh esté en su PATH.
npm
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.
La distribución de npm necesita un navegador Chromium — ya sea instala uno a través de Playwright o apunta a un binario existente. Consulta Elegir una Distribución.
Clave API
Crea un archivo .cursor/mcp.json en el directorio raíz de tu proyecto (a nivel de proyecto) o añade el servidor a través de la configuración MCP global de Cursor:
{
"mcpServers": {
"axe-mcp-server": {
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "your-api-key-here"
}
}
}
}Tu configuración contiene una credencial en su bloque env. Los archivos a nivel de proyecto como .cursor/mcp.json se encuentran en tu repositorio — agrégales a .gitignore, o guarda las credenciales en tu configuración global en su lugar.
OAuth 2.0
OAuth 2.0 también es compatible con la distribución de npm — configura AXE_ACCESS_TOKEN en lugar de AXE_API_KEY, inyectando un token nuevo desde @deque/axe-auth token al iniciar. Consulta Autenticación para el flujo completo.
Configura ya sea AXE_API_KEY o AXE_ACCESS_TOKEN — no ambos. El servidor fallará al iniciarse si ambas variables están configuradas.
Uso y verificación
Una vez añadido, el indicador de estado en las Configuraciones de Cursor debería mostrar que el servidor está ejecutándose:
- Abre las Configuraciones de Cursor
- Ve a Características > MCP
- Debería ver axe-mcp-server listado bajo MCP Servers Instalados con las herramientas analyze, remediate e igt disponibles.
Para obtener instrucciones personalizadas recomendadas que guíen a Cursor a través del flujo de trabajo analizar-luego-remediar, consulta Configuración de su Agente AI.