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 nella .mcp.json nella directory principale del tuo progetto (ideale per condividere le impostazioni con il team)
  • A livello di utente: Aggiungi il server all'oggetto mcpServers nella ~/.claude.json nella tua home directory (si applica a tutti i tuoi progetti). Puoi anche gestire i server a livello utente con il comando claude mcp add --scope user — vedi la documentazione di Claude Code MCP per i dettagli.
info

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

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 gestire in modo sicuro l'input. La sintassi ${AXE_API_KEY} istruisce Claude Code a prelevare il valore dall'ambiente della tua shell. Per maggiori informazioni, consulta la documentazione 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 riga 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 l'URL 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 (istanza SaaS condivisa di Deque negli Stati Uniti). Vedi Riferimento Configurazione per i dettagli.

OAuth 2.0

Prima di configurare, completa il 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 env blocco 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 predefinito è https://axe.deque.com (istanza SaaS condivisa di Deque negli Stati Uniti). Vedi Riferimento alla configurazione per ulteriori 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 -y flag salta il prompt iniziale "Ok per procedere?" che npx altrimenti 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 dei comandi ($(...)), che non è disponibile in cmd.exe o in PowerShell di default. Esegui il tuo editor da una shell Git Bash o WSL in modo che sh sia nel tuo PATH.

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 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 in modo che Claude Code possa recuperarlo dall'ambiente.

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.

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 del 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 del server MCP Axe, aggiungi le istruzioni del flusso di lavoro analizza-poi-rimedia consigliate a un CLAUDE.md file 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?