Configuración en VS Code con Copilot

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

La siguiente configuración se puede usar a nivel de proyecto o a nivel de configuración de usuario (en todos los proyectos). Para la configuración a nivel de proyecto, crea un archivo .vscode/mcp.json en tu espacio de trabajo. Para una configuración a nivel de usuario, añade un servidor MCP a tu archivo de configuración de usuario existente.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "axe-api-key",
      "description": "axe MCP Server API Key",
      "password": true
    }
  ],
  "servers": {
    "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": "${input:axe-api-key}"
      }
    }
  }
}

Nota: La configuración utiliza "AXE_API_KEY": "${input:axe-api-key}" para el manejo seguro de entradas. Se te pedirá que ingreses tu clave API cuando el servidor se inicie por primera vez. Para obtener más información sobre la configuración de VS Code MCP, consulta la documentación de VS Code MCP.

note

¿Usando una instancia regional, en una nube privada o local de axe? Añade AXE_SERVER_URL al bloque env con la URL base de tu instancia:

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

Si se omite, el servidor predeterminará a https://axe.deque.com (la instancia SaaS compartida de Deque en EE.UU.). Consulta Opciones de Configuración para más detalles.

info

Para una lista completa de opciones configurables, consulta la sección Opciones de Configuración .

Uso de autenticación OAuth 2.0

Si prefieres OAuth en lugar de una clave API, reemplaza la configuración anterior con la siguiente. Esto utiliza @deque/axe-auth token para obtener un nuevo token de acceso cada vez que el servidor se inicia. No se necesita un bloque inputs — el token se recupera automáticamente de la llavero de tu sistema.

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

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

¿Usando una instancia regional, en una nube privada o local de axe? Añade AXE_SERVER_URL al comando Docker y un bloque env con la URL base de tu 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 predeterminará a https://axe.deque.com (la instancia SaaS compartida de Deque en EE.UU.). Consulta 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 bandera -y omite el aviso de "¿Listo para continuar?" que de otro modo npx solicitaría en un shell no interactivo. No configures AXE_API_KEY junto a AXE_ACCESS_TOKEN.

caution

Usuarios de Windows: Esta configuración utiliza un shell POSIX (sh) y sustitución de comandos ($(...)), que no está disponible en cmd.exe o PowerShell por defecto. Ejecuta VS Code desde un Git Bash o un shell WSL para que sh esté en tu PATH.

Iniciar el Servidor MCP

  1. Abre VS Code con tus configuraciones establecidas
  2. Localiza la "axe-mcp-server" entrada en tu mcp.json archivo
  3. Haz clic en el **Inicio** botón que aparece sobre la configuración del servidor
  4. Si configuraste la autenticación de clave API, ingresa tu clave API cuando se te solicite. Si configuraste OAuth, el servidor se inicia sin un aviso y recupera un token de tu llavero del sistema.

Enviar indicaciones a Copilot

Una vez que el servidor axe MCP está en funcionamiento, puedes usarlo a través de la interfaz de chat de Copilot en VS Code:

  1. Abre el chat de Copilot en VS Code
  2. Asegúrate de estar en modo agente para permitir el uso de herramientas
  3. Envía indicaciones para analizar sitios web y remediar problemas de accesibilidad

Is this page helpful?

Help us improve this page

Still need help?