Configurazione in Cursor
Il server MCP Axe può essere aggiunto a livello di progetto o globale.
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 i passaggi di configurazione manuale qui sotto.
Scegli ambito
- 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.
Aggiunta della configurazione JSON
Aggiungi il seguente JSON di configurazione.
Se hai già altri server definiti, aggiungi il axe-mcp-server blocco all'interno del mcpServers oggetto esistente.
{
"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 Opzioni di configurazione per i dettagli.
Utilizzo di autenticazione OAuth 2.0
Se preferisci OAuth a una chiave API, sostituisci la configurazione sopra con la seguente. Questo utilizza @deque/axe-auth token per ottenere un token di accesso fresco ogni volta che il server si avvia.
Prima di configurare, completa il Passo 1: Autenticazione nella guida all'autenticazione OAuth 2.0.
{
"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"
]
}
}
}Utilizzando un'istanza axe regionale, cloud privato o locale? Aggiungi AXE_SERVER_URL al comando Docker e un env blocco con il 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 USA di Deque). Consulta Opzioni di 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 container Docker. Il -y flag salta il prompt "Ok per procedere?" alla prima esecuzione 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 sostituzione dei comandi ($(...)), che non è disponibile in cmd.exe o PowerShell per impostazione predefinita. Eseguire Cursor da una shell Git Bash o WSL in modo che sh sia sul tuo PATH.
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 Server MCP Installati con gli strumenti di analisi e correzione disponibili.