Configurazione in Cursor
Prima della configurazione, scegli una distribuzione (Docker o npm) e imposta l'autenticazione (chiave API o OAuth 2.0). Poi aggiungi la configurazione corrispondente qui sotto.
Axe MCP server può essere aggiunto sia a livello di progetto che a livello globale:
- A livello di progetto: Crea un file in
.cursor/mcp.jsonnella directory principale del tuo progetto - A livello globale: Apri le impostazioni di Cursor, vai a Funzionalità > MCP, e clicca su Aggiungi nuovo server MCP. Questo aprirà il tuo file di configurazione globale.
Se hai già altri server definiti, aggiungi il axe-mcp-server blocco all'interno del mcpServers oggetto esistente.
Docker
Chiave API
Installazione con un clic
Clicca sul link qui sotto per installare direttamente il server MCP Axe in Cursor:
Installa il server MCP Axe in Cursor
Cursor ti chiederà di confermare l'installazione. In alternativa, segui la configurazione manuale qui sotto.
Configurazione manuale
{
"mcpServers": {
"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": "${env:AXE_API_KEY}"
}
}
}
}La configurazione utilizza "AXE_API_KEY": "${env:AXE_API_KEY}" per la gestione sicura degli input. La ${env:AXE_API_KEY} sintassi istruisce Cursor a prendere il valore dalle variabili di sistema. Per maggiori informazioni, vedi la documentazione MCP di Cursor.
Utilizzando un'istanza axe regionale, cloud privato o locale? Aggiungi AXE_SERVER_URL al env blocco con il URL base della tua istanza:
"env": {
"AXE_API_KEY": "${env:AXE_API_KEY}",
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}Se omesso, il server predefinito è https://axe.deque.com (istanza SaaS condivisa USA di Deque). Consulta Riferimento di 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 token di accesso fresco ogni volta che il server si avvia.
{
"mcpServers": {
"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"
]
}
}
}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.
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.
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 su un binario esistente. Vedi Scelta di una Distribuzione.
Chiave API
Crea un .cursor/mcp.json file nella directory principale del tuo progetto (livello di progetto) o aggiungi il server tramite le impostazioni globali MCP di Cursor:
{
"mcpServers": {
"axe-mcp-server": {
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "your-api-key-here"
}
}
}
}La tua configurazione contiene una credenziale nel env blocco. I file a livello di progetto come .cursor/mcp.json si trovano nel tuo repository — aggiungili a .gitignore, o mantieni le credenziali nella tua configurazione globale invece.
OAuth 2.0
OAuth 2.0 è supportato anche con la distribuzione npm — imposta AXE_ACCESS_TOKEN invece di AXE_API_KEY, iniettando un token fresco da @deque/axe-auth token all'avvio. Vedi Autenticazione per l'intero flusso.
Imposta o AXE_API_KEY o AXE_ACCESS_TOKEN — non entrambi. Il server fallirà all'avvio se entrambe le variabili sono impostate.
Utilizzo e verifica
Una volta aggiunto, l'indicatore di stato in Impostazioni Cursor dovrebbe mostrare che il server è in esecuzione:
- Apri Impostazioni Cursor
- Vai a Funzionalità > MCP
- Dovresti vedere axe-mcp-server elencato sotto i Server MCP installati con gli strumenti analyze, remediate e igt disponibili.
Per istruzioni personalizzate consigliate che guidano Cursor attraverso il flusso di lavoro analyze-then-remediate, vedi Configurazione del Tuo Agente AI.