Configuración en Claude Code

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Antes de configurar, elige una distribución (Docker o npm) y configura 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 tanto a nivel de proyecto como de usuario:

  • A nivel de proyecto: Cree un archivo en .mcp.json en el directorio raíz de su proyecto (mejor para compartir configuraciones con un equipo)
  • A nivel de usuario: Añada el servidor al objeto mcpServers en ~/.claude.json en su directorio personal (aplica a todos sus proyectos). También puede gestionar servidores a nivel de usuario con el comando claude mcp add --scope user — vea el documentación de Claude Code MCP para más detalles.
info

Si ya tiene otros servidores definidos, añada el bloque axe-mcp-server dentro del objeto mcpServers existente.

Docker

Clave API

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "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_SERVER_URL": "https://axe.deque.com",
        "AXE_API_KEY": "${AXE_API_KEY}"
      }
    }
  }
}

La configuración utiliza "AXE_API_KEY": "${AXE_API_KEY}" para un manejo seguro de entradas. La sintaxis ${AXE_API_KEY} instruye a Claude Code a extraer el valor del entorno de su shell. Para más información, vea el documentación de Claude Code MCP.

Configure su clave API como una variable de entorno en su shell:

export AXE_API_KEY="your-api-key-here"

Para una configuración permanente, añada esta línea a su perfil de shell (~/.bashrc, ~/.zshrc, etcétera).

note

¿Está utilizando una instancia de axe regional, en nube privada o en locales propios? Actualice el valor AXE_SERVER_URL en el bloque env con la URL base de su instancia:

"env": {
  "AXE_API_KEY": "${AXE_API_KEY}",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Si se omite, el servidor predeterminado es https://axe.deque.com (instancia SaaS compartida de Deque en EE.UU.). 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": {
      "type": "stdio",
      "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"
      ]
    }
  }
}
note

¿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.

note

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.

caution

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 npm requiere un navegador Chromium — o bien instale uno a través de Playwright o apunte a un binario existente. Vea Elegir una Distribución.

Clave API

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_API_KEY": "${AXE_API_KEY}"
      }
    }
  }
}

Configure AXE_API_KEY en su shell como se muestra arriba para que Claude Code pueda extraerlo del entorno.

OAuth 2.0

OAuth 2.0 también es compatible con la distribución npm — configure AXE_ACCESS_TOKEN en lugar de AXE_API_KEY, inyectando un token nuevo desde @deque/axe-auth token al iniciar. Vea Autenticación para el flujo completo.

note

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 configurado, reinicie Claude Code para cargar el servidor MCP.

  1. Inicie Claude Code desde su terminal: claude
  2. Escriba /mcp para gestionar las conexiones del servidor MCP
  3. Debería ver axe-mcp-server listado con las herramientas analyze, remediate y igt disponibles

Configuración de Claude Code (recomendado)

Para asegurar que Claude Code usa correctamente las herramientas del servidor axe MCP, añada las instrucciones del flujo de trabajo recomendado de analizar-luego-remediar a un archivo CLAUDE.md en la raíz de su proyecto. Vea Configuración de Su Agente de IA para la plantilla completa.

Is this page helpful?

Help us improve this page

Still need help?