Claude Codeでのセットアップ
設定を行う前に、ディストリビューションを選択（Docker または npm）および認証を設定（API キーまたは OAuth 2.0）を準備してください。その後、以下の該当する設定を追加します。
Axe MCP サーバーは、プロジェクトレベルまたはユーザーレベルで追加できます：
- プロジェクトレベル: プロジェクトのルートディレクトリに
.mcp.jsonファイルを作成します（チームと設定を共有するのに最適） - ユーザーレベル: ホームディレクトリ内の
~/.claude.jsonにあるmcpServersオブジェクトにサーバーを追加します（全てのプロジェクトで適用されます）。ユーザーレベルのサーバーはclaude mcp add --scope userコマンドで管理することもできます。詳細はClaude Code MCPドキュメンテーションをご覧ください。
既に他のサーバーが定義されている場合は、既存のmcpServersオブジェクト内にaxe-mcp-serverブロックを追加してください。
Docker
API キー
{
"mcpServers": {
"axe-mcp-server": {
"type": "stdio",
"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_SERVER_URL": "https://axe.deque.com",
"AXE_API_KEY": "${AXE_API_KEY}"
}
}
}
}この設定は、"AXE_API_KEY": "${AXE_API_KEY}"を使用して安全な入力処理を行います。${AXE_API_KEY}構文で、Claude Codeにシェル環境から値を取得するよう指示します。詳細はClaude Code MCPドキュメンテーションをご参照ください。
シェルの環境変数としてAPIキーを設定します：
export AXE_API_KEY="your-api-key-here"恒久的な設定を行うには、シェルプロファイル（~/.bashrc、~/.zshrcなど）にこの行を追加します。
地域、プライベートクラウド、またはオンプレミスのaxeインスタンスを使用していますか？ インスタンスの基本URLでenvブロック内のAXE_SERVER_URL値を更新します。
"env": {
"AXE_API_KEY": "${AXE_API_KEY}",
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}省略された場合、サーバーはデフォルトでhttps://axe.deque.com（Dequeの共有US SaaSインスタンス）に設定されます。詳細は設定リファレンスをご覧ください。
OAuth 2.0
設定を行う前に、認証ガイドのステップ1：認証を完了してください。
サーバーの起動時に毎回新しいアクセストークンを取得するために@deque/axe-auth tokenを使用します。
{
"mcpServers": {
"axe-mcp-server": {
"type": "stdio",
"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インスタンスを使用していますか？ 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"
}省略した場合、サーバーはデフォルトでhttps://axe.deque.com（Dequeの共有US SaaSインスタンス）を使用します。詳細はConfiguration Referenceをご覧ください。
この構成では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シェルからエディターを実行して、shがPATHにあるようにしてください。
npm
npmディストリビューションはNode.jsで動作します。アクティブなNode.js LTSリリースを使用してください — 古いリリースはサポートされていない可能性があります。
npm配布版にはChromiumブラウザが必要です — Playwrightを使用してインストールするか、既存のバイナリを指す設定にします。詳細はディストリビューションの選択をご覧ください。
API キー
{
"mcpServers": {
"axe-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "${AXE_API_KEY}"
}
}
}
}Claude Codeが環境から取得できるように、AXE_API_KEYをシェルに、上記のように設定してください。
OAuth 2.0
npm配布版でもOAuth 2.0をサポートしています — AXE_ACCESS_TOKENをAXE_API_KEYの代わりに設定し、起動時に@deque/axe-auth tokenから新しいトークンを注入します。完全なフローは認証をご覧ください。
AXE_API_KEYかAXE_ACCESS_TOKENのどちらか一方を設定してください。両方の変数を設定すると、サーバーは起動時に失敗します。
使用と検証
設定後、Claude Codeを再起動してMCPサーバーをロードします。
- ターミナルからClaude Codeを起動します:
claude - MCP サーバー接続を管理するには
/mcpを入力します axe-mcp-serverが、analyze、remediate、igtツールと一緒に表示されるはずです
Claude Codeの設定（推奨）
Claude Codeがaxe MCPサーバーツールを正しく使用するために、推奨される「分析→修正」ワークフローの指示を、プロジェクトのルートにあるCLAUDE.mdファイルに追加します。完全なテンプレートはAIエージェントの設定をご覧ください。