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

El servidor Axe MCP se puede añadir a nivel de proyecto o de usuario.

Elegir ámbito

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

Añadiendo JSON de configuración

Añada el siguiente JSON de configuración.

info

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

{
  "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}"
      }
    }
  }
}
note

La configuración utiliza "AXE_API_KEY": "${AXE_API_KEY}" para manejo seguro de la entrada. La ${AXE_API_KEY} sintaxis instruye a Claude Code a obtener el valor de su entorno de shell. Para más información, consulte la documentación de Claude Code MCP.

note

¿Está utilizando una instancia de axe regional, en nube privada o en locales propios? Actualice el AXE_SERVER_URL valor en el env bloque 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 utiliza por defecto https://axe.deque.com (instancia SaaS compartida de Deque en EE.UU.). Vea Opciones de Configuración para más detalles.

Configurar su clave API

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

Uso de autenticación OAuth 2.0

Si prefiere OAuth sobre una clave API, reemplace la configuración anterior por la siguiente. Esto utiliza @deque/axe-auth token para obtener un nuevo token de acceso cada vez que el servidor se inicia.

Antes de configurar, complete el Paso 1: Autenticar en la guía de Autenticación OAuth 2.0.

{
  "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

¿Está utilizando una instancia de axe regional, en nube privada o en locales propios? Añada AXE_SERVER_URL al comando 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 utiliza por defecto https://axe.deque.com (instancia SaaS compartida de Deque en EE.UU.). Vea Opciones de Configuración para más detalles.

note

Esta configuración utiliza sh -c para permitir la sustitución de shell. $(npx -y @deque/axe-auth token) se ejecuta al inicio del servidor e inyecta un token de acceso válido en el contenedor Docker. La -y bandera omite el aviso "¿Está bien continuar?" en la primera ejecución que npx de otro modo solicitaría en un shell no interactivo. No establezca AXE_API_KEY junto con AXE_ACCESS_TOKEN.

caution

**Usuarios de Windows:** Esta configuración utiliza una shell POSIX (sh) y sustitución de comandos ($(...)), que no está disponible en cmd.exe o PowerShell de forma predeterminada. Ejecute Claude Code desde un Git Bash o una shell de WSL para que sh esté en su PATH.

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 y remediate disponibles

Configuración de Claude Code (recomendado)

Para asegurar que Claude Code utilice correctamente las herramientas del servidor MCP de axe, añada las siguientes instrucciones a un archivo CLAUDE.md en la raíz de su proyecto. Esto le dice a Claude que siga el flujo de trabajo adecuado de analizar y luego remediar.

# Accessibility Testing and Remediation Workflow

## MANDATORY WORKFLOW - DO NOT DEVIATE

When working with accessibility issues, you MUST follow this exact workflow:

### 1. Analysis Phase

When asked to analyze pages for accessibility issues, you MUST:

- Use the `analyze` tool to scan the page
- Do NOT manually identify accessibility issues
- Always provide the complete URL being analyzed

### 2. Remediation Phase

When asked to remediate or fix accessibility issues, you MUST:

- First use `remediate` tool for EACH violation found
- Provide the exact HTML element, rule ID, and issue description
- Review the remediation guidance before making any code changes
- Apply fixes based on the remediate tool's recommendations
- Do NOT manually fix accessibility issues without first using the remediate tool

### 3. Verification Phase

After applying fixes, you MUST:

- Re-run `analyze` to verify all issues are resolved
- Confirm zero violations before considering the task complete

Para más detalles sobre las instrucciones del agente, consulte Configuración de Su Agente de IA.

Is this page helpful?

Help us improve this page

Still need help?