Configurazione in 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
tip

Preferisci un'installazione con un solo comando? Il plugin di accessibilità axe registra il server per te e aggiunge competenze e comandi che guidano il flusso di lavoro analizza → correggi → verifica. Questa pagina copre la configurazione manuale del server.

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

Il server MCP Axe può essere aggiunto sia a livello di progetto che di utente:

  • A livello di progetto: Crea un file in .mcp.json nella directory principale del tuo progetto (ideale per condividere le impostazioni con un team)
  • A livello di utente: Aggiungi il server all'oggetto mcpServers in ~/.claude.json nella tua directory home (valido per tutti i tuoi progetti). Puoi anche gestire i server a livello utente con il comando claude mcp add --scope user — vedi di Claude Code MCP per i dettagli.
info

Se hai già altri server definiti, aggiungi il blocco axe-mcp-server all'interno dell'oggetto mcpServers esistente.

Docker

Chiave 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 configurazione utilizza "AXE_API_KEY": "${AXE_API_KEY}" per la gestione sicura degli input. La sintassi ${AXE_API_KEY} istruisce Claude Code a ottenere il valore dall'ambiente della tua shell. Per ulteriori informazioni, vedi la di Claude Code MCP.

Imposta la tua chiave API come variabile d'ambiente nella tua shell:

export AXE_API_KEY="your-api-key-here"

Per una configurazione permanente, aggiungi questa linea al tuo profilo shell (~/.bashrc, ~/.zshrc, ecc.).

note

Utilizzare un'istanza axe regionale, cloud privato o on-premise? Aggiorna il valore AXE_SERVER_URL nel blocco env con la URL di base della tua istanza:

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

Se omesso, il server predefinito è https://axe.deque.com (l'istanza SaaS condivisa negli Stati Uniti di Deque). Vedi Riferimento Configurazione per i dettagli.

OAuth 2.0

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

Avvia il server tramite @deque/axe-auth run, che mantiene fresco il token di accesso del server in esecuzione finché dura la sessione.

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@deque/axe-auth",
        "run",
        "--",
        "docker",
        "run",
        "--add-host=host.docker.internal:host-gateway",
        "-i",
        "--rm",
        "-p",
        "127.0.0.1:9223:9223",
        "-e",
        "AXE_ACCESS_TOKEN",
        "-e",
        "AXE_TOKEN_REFRESH_PORT",
        "-e",
        "AXE_TOKEN_REFRESH_SECRET",
        "-e",
        "AXE_TOKEN_REFRESH_HOST=0.0.0.0",
        "dequesystems/axe-mcp-server:latest"
      ],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}
note

Il refresh del token ha raggiunto il server MCP dell'ascia in v1.5.0. npx -y @deque/axe-auth recupera sempre la CLI corrente, ma un'immagine Docker scaricata prima di quella versione non ha alcun ascoltatore di refresh per run a cui inviare — riscaricalo con docker pull dequesystems/axe-mcp-server:latest.

npx -y @deque/axe-auth run avvia il container e lo supervisiona per tutta la durata della sessione, inviando un token di accesso appena generato al server in esecuzione prima che quello attuale scada. Il tuo token di aggiornamento non lascia mai il tuo computer: solo i token di accesso di breve durata raggiungono il server. Il flag -y salta il prompt iniziale "Ok per procedere?" che altrimenti npx chiederebbe in una shell non interattiva.

I rimanenti flag esistono per rendere disponibile tale invio all'interno del container:

  • -p 127.0.0.1:9223:9223 pubblica il listener di aggiornamento del server solo su loopback host, mantenendolo lontano dalle interfacce esterne del tuo computer.
  • -e AXE_ACCESS_TOKEN, -e AXE_TOKEN_REFRESH_PORT e -e AXE_TOKEN_REFRESH_SECRET inoltrano i valori generati da run nel container. Passa solo i nomi, senza =value — run li fornisce.
  • -e AXE_TOKEN_REFRESH_HOST=0.0.0.0 collega il listener all'interfaccia di rete del container. Una porta pubblicata inoltra lì piuttosto che al loopback del container, quindi il bind predefinito del loopback sarebbe irraggiungibile. Il segreto condiviso, non l'isolamento del container, è ciò che protegge il punto finale.

9223 è un esempio — qualsiasi porta libera sul tuo computer funziona, purché AXE_TOKEN_REFRESH_PORT e il -p pubblicano lo stesso nome. Vedi Variabili di aggiornamento token per il riferimento completo.

note

Utilizzi un'istanza axe regionale, privata o locale? Aggiungi AXE_SERVER_URL al comando Docker e al blocco env, insieme alla porta di aggiornamento:

"args": [
  "-y",
  "@deque/axe-auth",
  "run",
  "--",
  "docker",
  "run",
  "--add-host=host.docker.internal:host-gateway",
  "-i",
  "--rm",
  "-p",
  "127.0.0.1:9223:9223",
  "-e",
  "AXE_SERVER_URL",
  "-e",
  "AXE_ACCESS_TOKEN",
  "-e",
  "AXE_TOKEN_REFRESH_PORT",
  "-e",
  "AXE_TOKEN_REFRESH_SECRET",
  "-e",
  "AXE_TOKEN_REFRESH_HOST=0.0.0.0",
  "dequesystems/axe-mcp-server:latest"
],
"env": {
  "AXE_TOKEN_REFRESH_PORT": "9223",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Usa lo stesso URL che hai passato a --server quando hai effettuato l'accesso, così i token che axe-auth genera provengono dall'istanza chiamata dal server. Se omesso, il server utilizza per default https://axe.deque.com (l'istanza SaaS condivisa di Deque negli USA). Vedi Riferimento alla configurazione per i dettagli.

npm

La distribuzione npm funziona su Node.js. Usa un release LTS attiva di Node.js — le versioni precedenti potrebbero non essere supportate.

La distribuzione npm necessita di un browser Chromium — installane uno tramite Playwright o indica un binario esistente. Vedi Scelta di una Distribuzione.

Chiave API

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_API_KEY": "${AXE_API_KEY}"
      }
    }
  }
}

Imposta AXE_API_KEY nella tua shell come mostrato sopra affinché Claude Code possa ottenerlo dall'ambiente.

OAuth 2.0

OAuth 2.0 è supportato anche con la distribuzione npm. Incapsula il server in @deque/axe-auth run esattamente come sopra — non c'è un contenitore in cui pubblicare una porta, quindi il comando è più breve:

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@deque/axe-auth",
        "run",
        "--",
        "npx",
        "-y",
        "axe-mcp-server"
      ],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}

npx -y @deque/axe-auth run avvia il server e lo supervisiona per tutta la durata della sessione, fornendo un token di accesso appena generato al processo in esecuzione prima che quello corrente scada. Qui non è necessaria una pubblicazione della porta: il processo incapsulato eredita AXE_TOKEN_REFRESH_PORT direttamente e il listener rimane sul loopback. 9223 è un esempio — qualsiasi porta libera sulla tua macchina funziona, e la variabile è opzionale qui: omettila e run sceglierà una porta libera per la sessione.

caution

A differenza di un container, la distribuzione npm eredita l'intero ambiente della tua shell. Se AXE_API_KEY è esportato lì, arriva al server insieme al token OAuth e il server si rifiuta di avviarsi. Annullalo nella shell da cui avvii il tuo editor, oppure usa la configurazione Docker sopra descritta, che riceve solo le variabili passate con i flag -e espliciti.

Consulta Autenticazione per il flusso completo.

note

Imposta o AXE_API_KEY o AXE_ACCESS_TOKEN — non entrambi. Il server fallirà all'avvio se entrambe le variabili sono impostate.

Uso e verifica

Una volta configurato, riavvia Claude Code per caricare il server MCP.

  1. Avvia Claude Code dal tuo terminale: claude
  2. Digita /mcp per gestire le connessioni ai server MCP
  3. Dovresti vedere axe-mcp-server elencato con gli strumenti analyze, remediate e igt disponibili

Configurazione di Claude Code (raccomandato)

Per garantire che Claude Code utilizzi correttamente gli strumenti axe MCP Server, aggiungi le istruzioni di workflow consigliate per l'analisi e quindi la correzione a un file CLAUDE.md nella radice del tuo progetto. Vedi Configurazione del tuo agente AI per il modello completo.

Is this page helpful?

Help us improve this page

Still need help?