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 u OAuth 2.0). Luego agrega 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 (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.
info

Si ya tiene otros servidores definidos, añada el axe-mcp-server bloque dentro del mcpServers objeto 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 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.

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

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 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 nuevo token de acceso cada vez que el servidor se inicia.

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

note

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.

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 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 — instala uno a través de Playwright o apunta a un binario existente. Consulta 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}"
      }
    }
  }
}

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

OAuth 2.0

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

note

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 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 use correctamente las herramientas del servidor axe MCP, agrega las instrucciones del flujo de trabajo recomendado analizar-luego-corregir a un CLAUDE.md archivo en la raíz de tu proyecto. Consulta Configuración de Su Agente de IA para la plantilla completa.

Is this page helpful?

Help us improve this page

Still need help?