Configuración en Cursor
El servidor Axe MCP se puede agregar a nivel de proyecto o global.
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 los pasos de configuración manual a continuación.
Elegir el ámbito
- 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.
Agregar configuración JSON
Agregue el siguiente JSON de configuración.
Si ya tiene otros servidores definidos, agregue el bloque axe-mcp-server dentro del objeto existente mcpServers .
{
"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 Opciones de configuración para más detalles.
Uso de autenticación OAuth 2.0
Si prefiere OAuth en lugar de una clave API, reemplace la configuración anterior con la siguiente. Esto utiliza @deque/axe-auth token para obtener un token de acceso nuevo cada vez que se inicia el servidor.
Antes de configurar, complete Paso 1: Autenticar en la guía de autenticación OAuth 2.0.
{
"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"
]
}
}
}¿Está utilizando una instancia regional, nube privada o local de axe? Agregue AXE_SERVER_URL al comando de Docker y un bloque 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 por defecto se conectará a https://axe.deque.com (instancia SaaS compartida de EE. UU. de Deque). Vea Opciones de configuración para más detalles.
Esta configuración utiliza sh -c para permitir la sustitución en el 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 aviso de "¿Ok para continuar?" que npx de otro modo pediría en una shell no interactiva. No configures AXE_API_KEY junto con AXE_ACCESS_TOKEN.
Usuarios de Windows: Esta configuración utiliza una shell POSIX (sh) y sustitución de comandos ($(...)), que no están disponibles en cmd.exe ni en PowerShell de forma predeterminada. Ejecuta Cursor desde un Git Bash o una shell WSL para que sh esté en tu PATH.
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ías ver axe-mcp-server listado bajo Servidores MCP Instalados con las herramientas de análisis y remediación disponibles.