Configuration dans Cursor
Avant de configurer, choisissez une distribution (Docker ou npm) et mettez en place l'authentification (clé API ou OAuth 2.0). Ajoutez ensuite 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 à 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 une gestion sécurisée des entrées. La syntaxe ${env:AXE_API_KEY} indique à Cursor de tirer la valeur de vos variables système. Pour plus d'informations, voir 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 (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 fois que le serveur démarre.
{
"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 ? Add AXE_SERVER_URL to the Docker command and an env block with your instance's base URL:
"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 elle est omise, le serveur utilise par défaut https://axe.deque.com (l'instance partagée SaaS 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 drapeau -y saute la demande "D'accord pour continuer ?" que npx poserait autrement dans un shell non interactif. Ne pas régler 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 par défaut dans cmd.exe ou PowerShell. Exécutez votre éditeur depuis un shell Git Bash ou WSL afin que sh soit sur votre PATH.
npm
La distribution npm fonctionne sur Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes pourraient ne pas être prises en charge.
La distribution npm nécessite un navigateur Chromium — soit installez-en un via Playwright, soit pointez vers un binaire existant. Voir Choisir une distribution.
Clé API
Créez un fichier .cursor/mcp.json dans le répertoire 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 un identifiant dans son bloc env. Les fichiers au niveau projet comme .cursor/mcp.json se trouvent dans votre dépôt — ajoutez-les à .gitignore, ou conservez les identifiants dans votre configuration globale à la place.
OAuth 2.0
OAuth 2.0 est également pris en charge avec la distribution npm — définissez AXE_ACCESS_TOKEN au lieu de AXE_API_KEY, injectant un nouveau jeton de @deque/axe-auth token au démarrage. Voir Authentification pour l'intégralité du flux.
Définissez soit AXE_API_KEY soit AXE_ACCESS_TOKEN — mais 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
- Aller à 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.