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

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

Scegli l'ambito

  • 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.

Aggiunta del JSON di configurazione

Aggiungi il seguente JSON di configurazione.

info

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

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

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.

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 Opzioni di configurazione per i dettagli.

Imposta la tua chiave API

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.).

Utilizzo dell'autenticazione OAuth 2.0

Se preferisci OAuth rispetto a una chiave API, sostituisci la configurazione sopra con la seguente. Questo utilizza @deque/axe-auth token per ottenere un nuovo token di accesso ogni volta che il server si avvia.

Prima di configurare, completa Fase 1: Autenticazione nella guida all'autenticazione OAuth 2.0.

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

Utilizzare un'istanza axe regionale, cloud privato o on-premise? 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 predefinito è https://axe.deque.com (istanza SaaS condivisa di Deque negli Stati Uniti). Vedi Opzioni di 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. La -y flag salta il prompt "Procedere?" della prima esecuzione che npx altrimenti richiederebbe 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 di default. Esegui Claude Code da Git Bash o da una shell WSL in modo che sh sia sul tuo PATH.

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 e remediate disponibili

Configurazione di Claude Code (raccomandato)

Per assicurarti che Claude Code utilizzi correttamente gli strumenti del server MCP axe, aggiungi le seguenti istruzioni a un file CLAUDE.md nella radice del tuo progetto. Questo indica a Claude di seguire il corretto flusso di lavoro analizza-poi-correggi.

# Accessibility Testing and Remediation Workflow

## MANDATORY WORKFLOW - DO NOT DEVIATE

When working with accessibility issues, you MUST follow this exact workflow:

### 1. Analysis Phase

When asked to analyze pages for accessibility issues, you MUST:

- Use the `analyze` tool to scan the page
- Do NOT manually identify accessibility issues
- Always provide the complete URL being analyzed

### 2. Remediation Phase

When asked to remediate or fix accessibility issues, you MUST:

- First use `remediate` tool for EACH violation found
- Provide the exact HTML element, rule ID, and issue description
- Review the remediation guidance before making any code changes
- Apply fixes based on the remediate tool's recommendations
- Do NOT manually fix accessibility issues without first using the remediate tool

### 3. Verification Phase

After applying fixes, you MUST:

- Re-run `analyze` to verify all issues are resolved
- Confirm zero violations before considering the task complete

Per maggiori dettagli sulle istruzioni dell'agente, vedi Configurazione del tuo agente AI.

Is this page helpful?

Help us improve this page

Still need help?