カーソルでのセットアップ
設定を行う前に、配布方法を選択（Docker または npm）と認証を設定（APIキーまたはOAuth 2.0）を確認してください。その後、以下の該当する設定を追加してください。
Axe MCP サーバーは、プロジェクトレベルまたはグローバルレベルで追加できます。
- プロジェクトレベル: プロジェクトのルートディレクトリに
.cursor/mcp.jsonというファイルを作成してください - グローバルレベル: Cursorの設定を開き、機能 > MCPに移動し新しいMCPサーバーを追加をクリックします。これにより、グローバル設定ファイルが開かれます。
他のサーバーが既に定義されている場合は、axe-mcp-server ブロックを既存のmcpServersオブジェクト内に追加してください。
Docker
API キー
ワンクリックインストール
以下のリンクをクリックすると、axe MCPサーバーをカーソルに直接インストールできます:
カーソルがインストールの確認を促します。または、以下の手動セットアップに従ってください。
手動セットアップ
{
"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}"
}
}
}
}設定は、セキュアな入力処理のために"AXE_API_KEY": "${env:AXE_API_KEY}"を使用します。${env:AXE_API_KEY}構文は、Cursorにシステム変数から値を取得するよう指示します。詳細はカーソルMCPのドキュメントを参照してください。
地域、プライベートクラウド、またはオンプレミスのaxeインスタンスを使用していますか？ AXE_SERVER_URLをenvブロックに追加し、インスタンスのベースURLを設定してください：
"env": {
"AXE_API_KEY": "${env:AXE_API_KEY}",
"AXE_SERVER_URL": "https://your-axe-instance.example.com"
}省略された場合、サーバーはデフォルトでhttps://axe.deque.com（Dequeの共有US SaaSインスタンス）に設定されます。詳細は構成リファレンスを参照してください。
OAuth 2.0
設定を行う前に、認証ガイドのステップ1：認証を完了してください。
This uses @deque/axe-auth token to obtain a fresh access token each time the server starts.
{
"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"
]
}
}
}地域別、プライベートクラウド、またはオンプレミスの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 キー
プロジェクトのルートディレクトリ（プロジェクトレベル）に.cursor/mcp.jsonファイルを作成するか、CursorのグローバルMCP設定を通じてサーバーを追加してください：
{
"mcpServers": {
"axe-mcp-server": {
"command": "npx",
"args": ["-y", "axe-mcp-server"],
"env": {
"AXE_API_KEY": "your-api-key-here"
}
}
}
}設定にはenvブロックに資格情報が含まれています。 .cursor/mcp.jsonのようなプロジェクトレベルのファイルはリポジトリに格納されます ー それらを.gitignoreに追加するか、資格情報をグローバル設定に保持してください。
OAuth 2.0
OAuth 2.0はnpm配布版でもサポートされています ー 起動時に@deque/axe-auth tokenから新しいトークンを注入して、AXE_API_KEYの代わりにAXE_ACCESS_TOKENを設定してください。フルフローについては認証をご覧ください。
AXE_API_KEYかAXE_ACCESS_TOKENのどちらか一方を設定してください。両方の変数を設定すると、サーバーは起動時に失敗します。
使用と検証
追加後、カーソル設定のステータスインジケーターにサーバーが稼働中であることが示されるはずです:
- カーソル設定を開く
- 機能 > MCPに行く
- インストール済み MCP サーバーの下に axe-mcp-server がリストされ、analyze、remediate、および igt ツールが利用できるはずです。
分析から修正へのワークフローをCursorに案内する推奨カスタム指示については、AI エージェントの構成を参照してください。