Configuration dans VS Code avec Copilot

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

La configuration suivante peut être utilisée soit au niveau du projet, soit au niveau des paramètres utilisateur (dans tous les projets). Pour une configuration au niveau du projet, créez un .vscode/mcp.json fichier dans votre espace de travail. Pour une configuration au niveau des paramètres utilisateur, ajoutez un serveur MCP à votre fichier de configuration utilisateur existant.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "axe-api-key",
      "description": "axe MCP Server API Key",
      "password": true
    }
  ],
  "servers": {
    "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": "${input:axe-api-key}"
      }
    }
  }
}

Remarque: la configuration utilise "AXE_API_KEY": "${input:axe-api-key}" pour gérer les entrées de manière sécurisée. Cela vous demandera votre clé API lorsque le serveur démarrera pour la première fois. Pour plus d'informations sur la configuration MCP dans VS Code, consultez la documentation MCP de VS Code.

note

Vous utilisez une instance axe régionale, cloud privé ou sur site ? Ajoutez AXE_SERVER_URL au bloc env avec l'URL de base de votre instance :

"env": {
  "AXE_API_KEY": "${input:axe-api-key}",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Si omis, le serveur passe par défaut à https://axe.deque.com (l'instance SaaS US partagée de Deque). Voir Options de configuration pour plus de détails.

info

Pour obtenir une liste complète des options configurables, référez-vous à la section Options de configuration .

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 fois que le serveur démarre. Aucun inputs bloc n'est nécessaire — le jeton est récupéré automatiquement dans le trousseau de clés de votre système.

Avant de configurer, complétez l'Étape 1 : Authentifier dans le guide d'authentification OAuth 2.0.

{
  "servers": {
    "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"
      ]
    }
  }
}
note

Vous utilisez une instance axe régionale, cloud privé 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 passe par défaut à https://axe.deque.com (l'instance SaaS US partagée de Deque). Voir Options de configuration pour plus de détails.

note

Cette configuration utilise sh -c pour permettre la substitution de commandes. $(npx -y @deque/axe-auth token) est exécuté 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 ?" qui npx autrement aurait demandé dans un shell non interactif. Ne définissez pas AXE_API_KEY avec AXE_ACCESS_TOKEN.

caution

Utilisateurs Windows : Cette configuration utilise un shell POSIX (sh) et la substitution de commandes ($(...)), qui n'est pas disponible dans cmd.exe ou PowerShell par défaut. Exécutez VS Code à partir d'un Git Bash ou d'un shell WSL afin que sh soit sur votre PATH.

Démarrer le serveur MCP

  1. Ouvrez VS Code avec vos paramètres configurés
  2. Localisez l' "axe-mcp-server" entrée dans votre mcp.json fichier
  3. Cliquez sur le bouton **Démarrer** qui apparaît au-dessus de la configuration du serveur
  4. Si vous avez configuré l'authentification par clé API, entrez votre clé API lorsque vous y êtes invité. Si vous avez configuré OAuth, le serveur démarre sans invite et récupère un jeton depuis votre trousseau système.

Soumettre des invites à Copilot

Une fois que le serveur axe MCP est en marche, vous pouvez l'utiliser via l'interface de chat Copilot de VS Code :

  1. Ouvrez le chat Copilot dans VS Code
  2. Assurez-vous d'être en mode agent pour permettre l'utilisation des outils
  3. Soumettez des invites pour analyser des sites web et résoudre les problèmes d'accessibilité

Is this page helpful?

Help us improve this page

Still need help?