VS Codeでの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

次の設定はプロジェクトレベルまたはユーザー設定レベル(すべてのプロジェクトにわたって)で使用できます。プロジェクトレベルの設定には、ワークスペースに .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ドキュメントを参照してください。

note

地域専用、プライベートクラウド、またはオンプレミスの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 設定オプション 設定オプション

info

設定可能なオプションの全リストについては、 設定オプション セクションを参照してください。

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

地域専用、プライベートクラウド、またはオンプレミスの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 設定オプション 設定オプション

note

この設定は、 sh -c を使用してシェル置換を許可します。 $(npx -y @deque/axe-auth token) はサーバー起動時に実行され、Docker コンテナに有効なアクセストークンを挿入します。 -y フラグは、非対話型シェルで npx が通常尋ねる「進めてよろしいですか?」プロンプトをスキップします。設定しないでください AXE_API_KEY と一緒に AXE_ACCESS_TOKENを参照してください。

caution

Windows ユーザー: この設定は、POSIX シェル (sh) とコマンド置換 ($(...)) を使用しますが、これはデフォルトでは cmd.exe や PowerShell では利用できません。Git Bash や WSL シェルから VS Code を実行し、 sh があなたの PATHを参照してください。

MCPサーバーを起動

  1. 設定を行った状態でVS Codeを開きます
  2. 次のエントリを見つけます "axe-mcp-server" mcp.json ファイル上にあるようにしてください
  3. サーバー設定の上に表示される 「開始」 ボタンをクリックします
  4. API キー認証を設定した場合、プロンプトが表示されたら API キーを入力してください。OAuth を設定した場合、サーバーはプロンプトを表示せずに起動し、システムキーチェーンからトークンを取得します。

Copilotにプロンプトを送信

axe MCPサーバーが稼働している場合、VS CodeのCopilotチャットインターフェイスを使用できます:

  1. VS CodeでCopilotチャットを開く
  2. ツールの使用を許可するため、エージェントモードになっていることを確認する
  3. ウェブサイトを分析し、アクセシビリティの問題を修正するためのプロンプトを送信する