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 agregue la configuración correspondiente a continuación.
El servidor Axe MCP se puede agregar a nivel de proyecto o global:
- A nivel de proyecto: Cree un archivo en
.cursor/mcp.jsonen el directorio raíz de su proyecto - A nivel global: Abra la configuración de Cursor, vaya a Características > MCP, y haga clic en Agregar nuevo servidor MCP. Esto abrirá su archivo de configuración global.
Si ya tiene otros servidores definidos, agregue el bloque axe-mcp-server dentro del objeto existente mcpServers .
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 manejar entradas de manera segura. La sintaxis ${env:AXE_API_KEY} instruye a Cursor a extraer el valor de sus variables del sistema. Para más información, vea la documentación de Cursor MCP.
¿Está utilizando una instancia regional, nube privada o local de axe? Agregue AXE_SERVER_URL al bloque env con la URL base de su 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 se conectará a https://axe.deque.com (instancia SaaS compartida de EE. UU. de Deque). Vea 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 se inicia el servidor.
{
"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? Añada AXE_SERVER_URL al comando de Docker y un env bloque 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 por defecto usa https://axe.deque.com (la instancia compartida de Deque en EE. UU. SaaS). Consulte Referencia de Configuración para más detalles.
Esta configuración utiliza 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 de Docker. El -y flag omite el mensaje "¿Está bien continuar?" que npx de otro modo preguntaría en una shell no interactiva. No establezca 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 ni en 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 una versión activa LTS de Node.js — es posible que las versiones anteriores no sean compatibles.
La distribución npm necesita un navegador Chromium — ya sea instalar uno a través de Playwright o apuntar a un binario existente. Ver Elegir una Distribución.
Clave API
Cree un .cursor/mcp.json archivo en el directorio raíz de su proyecto (a nivel de proyecto) o agregue el servidor a través de la configuración global de MCP de Cursor:
{
"mcpServers": {
"axe-mcp-server": {
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "your-api-key-here"
}
}
}
}Su configuración contiene una credencial en su env bloque. Los archivos a nivel de proyecto, como .cursor/mcp.json residen en su repositorio — agréguelos a .gitignore, o mantenga las credenciales en su configuración global en su lugar.
OAuth 2.0
OAuth 2.0 es compatible con la distribución npm también — configure AXE_ACCESS_TOKEN en lugar de AXE_API_KEY, inyectando un token nuevo desde @deque/axe-auth token al inicio. Ver Autenticación para el flujo completo.
Configure ya sea AXE_API_KEY o AXE_ACCESS_TOKEN — no ambos. El servidor fallará al iniciar 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
- Dirígete a Características > MCP
- Debería ver axe-mcp-server listado bajo MCP Servers Instalados con las herramientas analyze, remediate e igt disponibles.
Para instrucciones personalizadas recomendadas que guían a Cursor a través del flujo de trabajo analizar-luego-remediar, ver Configuración de su Agente AI.