カーソルでのセットアップ
Axe MCPサーバーは、プロジェクトレベルまたはグローバルレベルで追加できます。
ワンクリックインストール
以下のリンクをクリックすると、axe MCPサーバーをカーソルに直接インストールできます:
カーソルはインストールの確認を求めます。または、以下の手動セットアップ手順に従ってください。
スコープの選択
- プロジェクトレベル: プロジェクトのルートディレクトリにファイルを作成
.cursor/mcp.json - グローバルレベル: カーソルの設定を開き、 機能 > MCPに移動し、 新しいMCPサーバーを追加をクリックします。これにより、グローバル設定ファイルが開きます。
構成JSONの追加
次の構成JSONを追加します。
他のサーバーが既に定義されている場合は、 axe-mcp-server ブロックを既存の mcpServers オブジェクト内に追加します。
{
"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} の構文は、システム変数から値を取得するようにカーソルに指示します。詳細については、 カーソル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 認証の使用
OAuth を API キーよりも好む場合は、上記の設定を以下に置き換えてください。これは、 @deque/axe-auth token を使用して、サーバーの起動時に毎回新しいアクセストークンを取得します。
設定する前に、 ステップ 1: 認証 を OAuth 2.0 認証ガイドで完了してください。
{
"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インスタンスを使用していますか？ 以下を追加してください AXE_SERVER_URL を Docker コマンドに追加し、 env ブロックに、インスタンスのベース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インスタンス）に設定されます。詳細は 構成オプション を参照してください。
この設定は、 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 シェルから Cursor を実行して、 sh があなたの PATHを参照してください。
使用と検証
追加後、カーソル設定のステータスインジケーターにサーバーが稼働中であることが示されるはずです:
- カーソル設定を開く
- に移動し、 機能 > MCP
- でaxe-mcp-serverがインストールされたMCPサーバーとしてリストされ、分析および修復ツールが利用可能になるはずです。