Configurazione in Cursor
Prima di configurare, scegli una distribuzione (Docker o npm) e imposta l'autenticazione (chiave API o OAuth 2.0). Poi aggiungi la configurazione corrispondente 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 blocco axe-mcp-server all'interno dell'oggetto mcpServers 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 una gestione sicura degli input. La sintassi ${env:AXE_API_KEY} istruisce Cursor a prendere il valore dalle variabili di sistema. Per ulteriori informazioni, vedi documentazione MCP di Cursor.
Utilizzando un'istanza axe regionale, cloud privato o locale? Aggiungi AXE_SERVER_URL al blocco env con l'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 di Deque negli USA). Vedi Riferimento di 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": {
"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 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.
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.
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 punta a un binario esistente. Vedi Scelta di una Distribuzione.
Chiave API
Crea un file .cursor/mcp.json nella directory principale del tuo progetto (a 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 suo blocco env. I file a livello di progetto come .cursor/mcp.json risiedono nel tuo repository — aggiungili a .gitignore, o mantieni le credenziali nella tua configurazione globale.
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.
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 raccomandate che guidano Cursor attraverso il flusso di lavoro analizza e poi rivisita, vedi Configurazione del Tuo Agente AI.