Configuration dans Cursor
Avant de configurer, choisissez une distribution (Docker ou npm) et mettez en place l'authentification (clé API ou OAuth 2.0). Ensuite, ajoutez la configuration correspondante ci-dessous.
Le serveur MCP Axe peut être ajouté soit au niveau du projet, soit au niveau global :
- 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.
Si vous avez déjà d'autres serveurs définis, ajoutez le bloc axe-mcp-server à l'intérieur de l'objet mcpServers existant.
Docker
Clé API
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 invitera à confirmer l'installation. Sinon, suivez la configuration manuelle ci-dessous.
Configuration manuelle
{
"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 Référence de configuration pour plus de détails.
OAuth 2.0
Avant de configurer, complétez Étape 1 : Authentification dans le guide d'authentification.
Cela utilise @deque/axe-auth token pour obtenir un nouveau jeton d'accès à chaque démarrage du serveur.
{
"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, privée ou sur site ? Ajoutez AXE_SERVER_URL à la commande Docker et un env bloc 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 utilise par défaut https://axe.deque.com (l'instance SaaS partagée de Deque aux États-Unis). Voir Référence 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 "D'accord pour continuer ?" du premier démarrage que npx demanderait autrement dans un shell non interactif. Ne pas définir AXE_API_KEY avec AXE_ACCESS_TOKEN.
Utilisateurs de Windows : Cette configuration utilise un shell POSIX (sh) et la substitution de commandes ($(...)), qui ne sont pas disponibles dans cmd.exe ou PowerShell par défaut. Lancez votre éditeur depuis un shell Git Bash ou WSL afin que sh soit sur votre PATH.
npm
La distribution npm fonctionne avec Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes peuvent ne pas être prises en charge.
La distribution npm nécessite un navigateur Chromium — installez-en un via Playwright ou pointez vers un binaire existant. Voir Choisir une distribution.
Clé API
Créez un .cursor/mcp.json fichier à la racine de votre projet (niveau projet) ou ajoutez le serveur via les paramètres MCP globaux de Cursor :
{
"mcpServers": {
"axe-mcp-server": {
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "your-api-key-here"
}
}
}
}Votre configuration contient une preuve d'identité dans son env bloc. Les fichiers au niveau du projet comme .cursor/mcp.json résident dans votre dépôt — ajoutez-les à .gitignore, ou conservez les preuves d'identité dans votre configuration globale à la place.
OAuth 2.0
OAuth 2.0 est également pris en charge avec la distribution npm — configurez AXE_ACCESS_TOKEN au lieu de AXE_API_KEY, en injectant un jeton frais de @deque/axe-auth token au démarrage. Voir Authentification pour le flux complet.
Définissez soit AXE_API_KEY ou AXE_ACCESS_TOKEN — pas les deux. Le serveur échouera au démarrage si les deux variables sont définies.
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 MCP Servers installés avec les outils d'analyse, de remédiation et igt disponibles.
Pour des instructions personnalisées recommandées qui guident Cursor à travers le flux de travail analyser-puis-remédier, voir Configurer votre agent AI.