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

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.

Questo utilizza @deque/axe-auth token per ottenere un nuovo token di accesso ogni volta che il server si avvia.

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

Utilizzi un'istanza axe regionale, privata o locale? Aggiungi AXE_SERVER_URL al comando Docker e un blocco env con l'URL di 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 predefinito è https://axe.deque.com (l'istanza condivisa SaaS statunitense di Deque). Vedi Riferimento alla configurazione per i dettagli.

note

Questa configurazione utilizza sh -c per consentire 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 "Va bene procedere?" che altrimenti npx chiederebbe 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 di comandi ($(...)), che non è disponibile in cmd.exe o PowerShell per impostazione predefinita. Esegui il tuo editor da una shell Git Bash o WSL in modo che sh sia sul tuo PATH.

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

L'OAuth 2.0 è supportato anche con la distribuzione npm — imposta AXE_ACCESS_TOKEN invece di AXE_API_KEY, iniettando un token nuovo da @deque/axe-auth token all'avvio. Vedi 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?