Configurazione in VS Code con Copilot

Prima di configurare, scegli una distribuzione (Docker o npm) e configura l'autenticazione (API key o OAuth 2.0). Poi aggiungi la configurazione corrispondente qui sotto.

La configurazione può essere utilizzata a livello di progetto o a livello di impostazioni utente (attraverso tutti i progetti). Per la configurazione a livello di progetto, crea un .vscode/mcp.json file nel tuo workspace. Per una configurazione a livello di impostazioni utente, aggiungi un server MCP al tuo file di configurazione utente esistente. Per ulteriori informazioni, vedi il documentazione VS Code MCP.

Docker

API key

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

La configurazione usa "AXE_API_KEY": "${input:axe-api-key}" per la gestione sicura dell'input. Questo ti chiederà di inserire la tua API key quando il server si avvia per la prima volta.

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

OAuth 2.0

Prima di configurare, completa il Passo 1: Autenticazione nella guida all'autenticazione.

Questo usa @deque/axe-auth token per ottenere un nuovo token di accesso ogni volta che il server si avvia. Non è necessario alcun blocco inputs — il token viene recuperato automaticamente dal portachiavi di sistema.

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

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

npm

La distribuzione npm funziona su Node.js. Usa una release LTS attiva di Node.js — le versioni più vecchie potrebbero non essere supportate.

La distribuzione npm necessita di un browser Chromium — installane uno tramite Playwright o punta a un binario esistente. Vedi Scegliere una distribuzione.

API key

Crea un .vscode/mcp.json file nel tuo workspace (a livello di progetto) o aggiungi il server alla tua configurazione utente:

{
  "servers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_API_KEY": "your-api-key-here"
      }
    }
  }
}

OAuth 2.0

OAuth 2.0 è supportato anche con la distribuzione npm — imposta AXE_ACCESS_TOKEN invece di AXE_API_KEY, iniettando un nuovo token da @deque/axe-auth token all'avvio. Vedi Autenticazione per il flusso completo.

Gestione sicura dei segreti

Se inserisci una credenziale nel blocco env , tratta quel file come qualsiasi altro segreto:

• Non commetterlo mai nel controllo del codice sorgente. I file a livello di progetto come .vscode/mcp.json vivono nel tuo repository — aggiungili al tuo .gitignore, oppure conserva le credenziali nella tua configurazione utente.
• Preferisci il portachiavi del tuo sistema operativo o un gestore di segreti dove supportati. Per OAuth, @deque/axe-auth già memorizza i token nel portachiavi del tuo sistema — vedi Autenticazione.
• Limita i permessi del file in modo che solo il tuo utente possa leggere il file (per esempio, chmod 600 .vscode/mcp.json su macOS e Linux).

Avvia il server MCP

1. Apri VS Code con le tue impostazioni configurate
2. Individua l' "axe-mcp-server" voce nel tuo mcp.json file
3. Fai clic sul pulsante **Avvia** che appare sopra la configurazione del server
4. Se hai configurato l'autenticazione tramite chiave API, inserisci la tua chiave API quando richiesto. Se hai configurato OAuth, il server si avvia senza richieste e recupera un token dal tuo portachiavi di sistema.

Invia Comandi a Copilot

Una volta che il server axe MCP è in esecuzione, puoi usarlo tramite l'interfaccia di chat di Copilot in VS Code:

1. Apri la chat di Copilot in VS Code
2. Assicurati di essere in modalità agente per consentire l'uso degli strumenti
3. Invia comandi per analizzare i siti web e risolvere problemi di accessibilità

Per istruzioni personalizzate consigliate che guidino Copilot attraverso il flusso di lavoro analizza e correggi, vedi Configurare il tuo agente AI.