Configuration dans Cursor
Le serveur axe MCP peut être ajouté soit au niveau du projet, soit au niveau global.
Installation en un clic
Cliquez sur le lien ci-dessous pour installer directement le serveur axe MCP dans Cursor :
Installer le serveur axe MCP dans Cursor
Cursor vous demandera de confirmer l'installation. Vous pouvez également suivre les étapes de configuration manuelle ci-dessous.
Choisir la portée
- Au niveau du projet: Créez un fichier à
.cursor/mcp.jsondans le répertoire racine de votre projet - Au niveau global: Ouvrez les paramètres de Cursor, allez dans Fonctionnalités > MCP, et cliquez sur Ajouter un nouveau serveur MCP. Cela ouvrira votre fichier de configuration global.
Ajout de la configuration JSON
Ajoutez le JSON de configuration suivant.
Si vous avez déjà d'autres serveurs définis, ajoutez le bloc axe-mcp-server à l'intérieur de l'objet mcpServers existant.
{
"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 configuration utilise "AXE_API_KEY": "${env:AXE_API_KEY}" pour gérer les entrées de manière sécurisée. La syntaxe ${env:AXE_API_KEY} demande à Cursor de récupérer la valeur de vos variables système. Pour plus d'informations, consultez la documentation MCP de Cursor.
Utilisez-vous une instance axe régionale, en cloud privé ou sur site ? Ajoutez AXE_SERVER_URL au bloc env avec l'URL de base de votre instance :
"env": {
"AXE_API_KEY": "${env:AXE_API_KEY}",
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}Si omis, le serveur par défaut est https://axe.deque.com (l'instance SaaS partagée de Deque aux États-Unis). Voir Options de configuration pour plus de détails.
Utilisation de l'authentification OAuth 2.0
Si vous préférez OAuth à une clé API, remplacez la configuration ci-dessus par la suivante. Cela utilise @deque/axe-auth token pour obtenir un nouveau jeton d'accès à chaque démarrage du serveur.
Avant de configurer, complétez Étape 1 : S'authentifier dans le guide d'authentification 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"
]
}
}
}Utilisez-vous une instance axe régionale, en cloud privé ou sur site ? Ajoutez AXE_SERVER_URL à la commande Docker et un bloc env avec l'URL de base de votre instance :
"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"
}Si omis, le serveur par défaut est https://axe.deque.com (l'instance SaaS partagée de Deque aux États-Unis). Voir Options de configuration pour plus de détails.
Cette configuration utilise sh -c pour permettre la substitution de shell. $(npx -y @deque/axe-auth token) s'exécute au démarrage du serveur et injecte un jeton d'accès valide dans le conteneur Docker. Le -y drapeau saute l'invite "Ok pour continuer ?" lors de la première exécution que npx demanderait autrement dans un shell non interactif. Ne pas définir AXE_API_KEY en même temps que AXE_ACCESS_TOKEN.
Utilisateurs de Windows : Cette configuration utilise un shell POSIX (sh) et la substitution de commande ($(...)), qui ne sont pas disponibles dans cmd.exe ou PowerShell par défaut. Exécutez Cursor à partir d'un shell Git Bash ou WSL afin que sh soit sur votre PATH.
Utilisation et vérification
Une fois ajouté, l'indicateur d'état dans les paramètres de Cursor devrait montrer que le serveur est en cours d'exécution :
- Ouvrez les paramètres de Cursor
- Allez à Fonctionnalités > MCP
- Vous devriez voir axe-mcp-server répertorié sous les serveurs MCP installés avec les outils d'analyse et de remédiation disponibles.