Configurazione in 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 seguente configurazione può essere utilizzata a livello di progetto o a livello di impostazioni utente (per tutti i progetti). Per la configurazione a livello di progetto, crea un .vscode/mcp.json file nel tuo spazio di lavoro. Per una configurazione a livello di impostazioni utente, aggiungi un server MCP al tuo file di configurazione utente esistente.

{
  "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 configurazione utilizza "AXE_API_KEY": "${input:axe-api-key}" per gestire in modo sicuro gli input. Questo ti chiederà la tua chiave API quando il server viene avviato per la prima volta. Per ulteriori informazioni sulla configurazione di VS Code MCP, consulta la documentazione VS Code MCP.

note

Utilizzi un'istanza axe regionale, cloud privata o on-premises? Aggiungi AXE_SERVER_URL al blocco env con l'URL base della tua istanza:

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

Se omesso, il server predefinisce https://axe.deque.com (l'istanza SaaS condivisa di Deque negli USA). Vedi Opzioni di configurazione per i dettagli.

info

Per un elenco completo delle opzioni configurabili, consulta la sezione Opzioni di configurazione .

Utilizzo dell'autenticazione OAuth 2.0

Se preferisci OAuth al posto di una chiave API, sostituisci la configurazione sopra con la seguente. Questa utilizza @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.

Prima di configurare, completa Fase 1: Autenticarsi nella guida all'Autenticazione 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

Utilizzi un'istanza axe regionale, cloud privata o on-premises? Aggiungi AXE_SERVER_URL al comando Docker e un blocco env con l'URL base della tua istanza:

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

Se omesso, il server predefinisce https://axe.deque.com (l'istanza SaaS condivisa di Deque negli USA). Vedi Opzioni di configurazione per i dettagli.

note

Questa configurazione utilizza sh -c per permettere la sostituzione della shell. $(npx -y @deque/axe-auth token) viene eseguito all'avvio del server e inietta un token di accesso valido nel contenitore Docker. Il flag -y salta il prompt "Procedere?" alla prima esecuzione che npx richiederebbe altrimenti in una shell non interattiva. Non impostare AXE_API_KEY insieme a AXE_ACCESS_TOKEN.

caution

Utenti Windows: Questa configurazione utilizza una shell POSIX (sh) e la sostituzione dei comandi ($(...)), che non è disponibile in cmd.exe o PowerShell per impostazione predefinita. Esegui VS Code da una shell Git Bash o WSL in modo che sh sia nel tuo PATH.

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à

Is this page helpful?

Help us improve this page

Still need help?