VS CodeでのCopilotセットアップ
次の設定はプロジェクトレベルまたはユーザー設定レベル(すべてのプロジェクトにわたって)で使用できます。プロジェクトレベルの設定には、ワークスペースに .vscode/mcp.json ファイルを作成します。ユーザー設定レベルの設定には、既存のユーザー設定ファイルにMCPサーバーを追加します。
{
"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}"
}
}
}
}注意: この設定は、 "AXE_API_KEY": "${input:axe-api-key}" を使用して安全な入力処理を行います。サーバーが初めて起動するときにAPIキーを求められます。VS Code MCP設定に関する詳細は、 VS Code MCPドキュメントを参照してください。
地域専用、プライベートクラウド、またはオンプレミスのaxeインスタンスを利用していますか? 次の AXE_SERVER_URL ブロックにお使いのインスタンスの基本URLを追加します。 env これを省略すると、サーバーはデフォルトで
"env": {
"AXE_API_KEY": "${input:axe-api-key}",
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}(Dequeの共有US SaaSインスタンス) を使用します。詳細は、 https://axe.deque.com 設定オプション 設定オプション
設定可能なオプションの全リストについては、 設定オプション セクションを参照してください。
OAuth 2.0 認証の使用
OAuth を API キーよりも好む場合は、上記の設定を以下のものに置き換えてください。これにより、 @deque/axe-auth token を使用して、サーバーが起動するたびに新しいアクセストークンを取得します。 inputs ブロックは必要ありません — トークンは自動的にシステムキーチェーンから取得されます。
設定を行う前に、 ステップ 1: 認証 を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"
]
}
}
}地域専用、プライベートクラウド、またはオンプレミスのaxeインスタンスを利用していますか? 次の AXE_SERVER_URL Docker コマンドに追加し、 env これを省略すると、サーバーはデフォルトで
"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"
}(Dequeの共有US SaaSインスタンス) を使用します。詳細は、 https://axe.deque.com 設定オプション 設定オプション
この設定は、 sh -c を使用してシェル置換を許可します。 $(npx -y @deque/axe-auth token) はサーバー起動時に実行され、Docker コンテナに有効なアクセストークンを挿入します。 -y フラグは、非対話型シェルで npx が通常尋ねる「進めてよろしいですか?」プロンプトをスキップします。設定しないでください AXE_API_KEY と一緒に AXE_ACCESS_TOKENを参照してください。
Windows ユーザー: この設定は、POSIX シェル (sh) とコマンド置換 ($(...)) を使用しますが、これはデフォルトでは cmd.exe や PowerShell では利用できません。Git Bash や WSL シェルから VS Code を実行し、 sh があなたの PATHを参照してください。
MCPサーバーを起動
- 設定を行った状態でVS Codeを開きます
- 次のエントリを見つけます
"axe-mcp-server"mcp.jsonファイル上にあるようにしてください - サーバー設定の上に表示される 「開始」 ボタンをクリックします
- API キー認証を設定した場合、プロンプトが表示されたら API キーを入力してください。OAuth を設定した場合、サーバーはプロンプトを表示せずに起動し、システムキーチェーンからトークンを取得します。
Copilotにプロンプトを送信
axe MCPサーバーが稼働している場合、VS CodeのCopilotチャットインターフェイスを使用できます:
- VS CodeでCopilotチャットを開く
- ツールの使用を許可するため、エージェントモードになっていることを確認する
- ウェブサイトを分析し、アクセシビリティの問題を修正するためのプロンプトを送信する
