DequeのAgoraからのインストール

組織のネットワークがnpmjs.orgやDocker Hubといった公共レジストリへのアクセスを制限している場合は、代わりにAgoraからaxe MCPサーバーを取得できます。npmパッケージとDockerイメージの両方のディストリビューションがそこで利用可能です。

AgoraはDequeの独自のアーティファクトリポジトリで、agora.dequecloud.comでホストされています。Dequeが顧客向けにインストールするパッケージやイメージを公開しています。これはArtifactory上で稼働しており、すでにツールで理解している他のnpmレジストリやアーティファクトソースと同様に動作し、組織は独自のリポジトリマネージャーからプロキシできます。

このガイドは特にaxe MCPサーバーについて解説しています。他のAxe DevToolsパッケージについては、DequeのAgoraからNode.js用のAxe DevTools for Webのインストールを参照してください。

前提条件

• Agoraのログイン資格情報。これがない場合は、Dequeの担当者またはサポートデスクにお問い合わせください。
• 選択したディストリビューション — ディストリビューションの選択を参照してください。
• npmディストリビューションの場合、Node.js 22.19.0以上。
• Dockerディストリビューションの場合、Dockerがインストールされて稼働していること。

IDトークンの作成

Agoraではアカウントのパスワードでパッケージのダウンロードを認証しません。代わりにIDトークンを生成し、アカウントに関連付けられた長期間有効な資格情報として、それをパスワードが必要な際に使用します。たとえば、.npmrcやcurlコマンドで指示される場合に使用します。これを作成するのは一度だけです。

IDトークンを作成する最も簡単な方法は、Agoraウェブアプリを介してです。ログインしたら、ヘルプボタンの横にあるトップバーのようこそ あなたのメールアドレスボタンをクリックして作成しましょう。

IDトークンは毎年有効期限が切れ、作成時に一度だけ表示されます。安全な場所に保管してください。

Agoraがホストするもの

Agoraは公共レジストリに公開されているのと同じアーティファクトを、安定版リリースとして提供しています。

安定版リリースのみがAgoraに公開されています。カナリア（next）やリリース候補（rc）ビルドは、npmjs.orgにのみ残されています。

npmディストリビューション

認証の追加

npmやYarnを通じてDequeパッケージにアクセスするには、Agoraの認証情報を~/.npmrcファイルに追加します。Agoraパッケージへのアクセス設定ツールは、AgoraのメールアドレスとIDトークンからこの内容を生成できます。それ以外の場合は、curlコマンドを使用して生成してください。

curl -u "<your-email>" "https://agora.dequecloud.com/artifactory/api/npm/auth"

<your-email>をAgoraのログインメールアドレスに置き換えてください。curlはパスワードを要求するので、先ほど作成したIDトークンを貼り付けます。このコマンドが返すのは：

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

~/.npmrcを開いて編集し、レジストリマッピングを追加し、curlコマンドの出力を追記します：

@deque:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth=<generated-auth-string>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

curlコマンドを実行できない場合は、自分で<your-email>:<your-identity-token>をbase-64エンコードして認証文字列を生成してください。

アクセスの検証

何かをインストールする前に、資格情報が機能していることと、Agoraアカウントが両方のパッケージを見れることを確認してください。

npm view @deque/axe-auth versions
npm view axe-mcp-server versions --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

各コマンドは公開されているバージョンのリストを表示するはずです。もしうまくいかない場合は、下のトラブルシューティング参照ください。インストールが途中で手間になるよりも、今解決する方が簡単です。

@deque/axe-authのインストール

@deque/axe-auth—OAuth 2.0 認証に使用されるCLIはスコープ付きパッケージであるため、上記の@deque:registry行だけで済みます。すべてのaxe-authコマンドは変更なしに動作し、npmjs.orgではなくAgoraから解決されます。

npx @deque/axe-auth login

これにより、サーバーをnpx -y @deque/axe-auth runでラップするMCPクライアント設定は変更する必要がありません。

axe-mcp-server のインストール

axe-mcp-serverはスコープのないパッケージで、npmはスコープごとにレジストリをマップすることしかできません。Agoraに単一のスコープなしパッケージをルーティングする.npmrc行がないため、代わりにそのtarballからインストールします。

希望のバージョンのtarballをダウンロードし、<version>を1.4.0のようなリリース済みバージョンに置き換えます—リリースノートを参照してください。npm packは.npmrcにすでに登録されている資格情報で認証するため、別のダウンロードツールやトークン処理は不要です。

npm pack axe-mcp-server@<version> --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

次に、それをグローバルにインストールします。これにより、axe-mcp-serverコマンドがPATHに配置されます。

npm install -g ./axe-mcp-server-<version>.tgz

この2つ目のステップでは、playwrightの依存関係がデフォルトのレジストリからフェッチされます。ダウンロードとインストールを分けることで、その解決が機能します。

npmディストリビューションはNode.jsで動作します。アクティブなNode.js LTSリリースを使用してください — 古いリリースはサポートされていない可能性があります。

npmディストリビューションにはChromiumブラウザも必要であることを忘れないでください。Chromium のインストールを参照し、そこでのコマンドがnpmjs.orgからPlaywrightバージョンを取得していることに注意してください。代わりにAgoraから読み取るにはレジストリのオーバーライドを追加してください—npm viewは単一のパッケージをフェッチするため、ここでのオーバーライドはnpm packでのそれと同じ理由で安全です。

npm view axe-mcp-server@<version> dependencies.playwright --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

MCPクライアントの設定

サーバーがグローバルにインストールされ、オンデマンドでフェッチされないため、npxを経由せずにインストール済みのコマンドを直接呼び出してください。VS CodeとCopilot、APIキーを使用する例として設定します。

{
  "servers": {
    "axe-mcp-server": {
      "command": "axe-mcp-server",
      "args": [],
      "env": {
        "AXE_API_KEY": "your-api-key-here"
      }
    }
  }
}

OAuth 2.0の場合、他のガイドと同様に@deque/axe-auth runを通じてサーバーを起動し、インストールされたコマンドでnpx -y axe-mcp-server呼び出しを置き換えます。

{
  "servers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "@deque/axe-auth", "run", "--", "axe-mcp-server"],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}

その他のクライアント設定ガイドの内容はそのまま適用されます—commandとargsのみが異なります。同じ置換がカーソルとクロードコードにも適用されます。

アップグレード

新しいバージョン番号でダウンロードとグローバルインストールを繰り返してください。リリースノートで利用可能なものを確認してください。

Docker の配布

Agoraは、Dockerイメージをアーキテクチャごとに1つの保存されたtarとしてdevtools-bin/axe-mcp-server/v<version>/でホストしています。

<version>を1.4.0のようなリリースされたバージョンに置き換え、<arch>をあなたのマシンに合ったアーキテクチャに置き換えてください—IntelとAMDにはamd64、Apple SiliconとARMにはarm64を使用します。

curl -u "<your-email>" \
  -O "https://agora.dequecloud.com/artifactory/devtools-bin/axe-mcp-server/v<version>/axe-mcp-server-<version>-<arch>.tar"

curlはパスワードを求めるので、あなたのアイデンティティトークンを貼り付けてください。-u "<your-email>:<your-identity-token>"としてインラインで提供することも機能しますが、その場合はトークンがシェル履歴に残ります。

それをDockerにロードします。

docker load -i axe-mcp-server-<version>-<arch>.tar

docker tag dequesystems/axe-mcp-server:v<version> dequesystems/axe-mcp-server:latest

イメージがロードされると、クライアント設定ガイド内のDocker設定はそのまま動作します。docker runはローカルイメージを使用し、Docker Hubには接続しません。

アップグレードするには、新しいバージョンのtarをダウンロードしてロードしてください。

独自のアーティファクトリポジトリを使用したインストール

あなたの組織がArtifactoryやNexusのようなアーティファクトリポジトリをすでに運営している場合、Agoraをそれを通してプロキシする方が通常は優れた選択です。その場合、開発者はAgoraの資格情報を必要とせず、すべてのパッケージは通常通り解決され、上記のtarballアプローチとは異なり、npx -y axe-mcp-serverは他の場所と同様に動作します。

これは他のAxe DevToolsパッケージと同じAgora接続なので、既存の設定ガイドが適用されます—あなたのリポジトリマネージャ用にそれをフォローし、npmパッケージタイプとnpmレジストリURLhttps://agora.dequecloud.com/artifactory/api/npm/devtools-npm/を選択します。

• Artifactory を設定する
• Nexus を設定する

axe MCPサーバに特有な追加点：axe-mcp-serverはplaywrightに依存しているため、Agoraリモートリポジトリと既存のnpmjs.orgリモートを1つの仮想リポジトリに集約し、開発者のregistry=をそこに向けます。こうすることでDequeのパッケージはAgoraから解決され、パブリックの依存関係はnpmjs.orgを通して1つのURLから解決され、npx -y axe-mcp-serverはクライアント設定ガイドと同様に正確に動作します。

バージョンの可用性

Agoraにはどちらのnpmパッケージも安定版リリースがあり、latestタグはnpmjs.orgと同様に最新の安定版リリースに解決されます。nextおよびrcタグは含まれておらず、プレリリースビルドはnpmjs.orgからのみ入手可能です。

特定のリリースが必要な場合は、正確なバージョンでインストールしてください。

トラブルシューティング

サーバーがインストールされた後に実行する際の問題については、axe MCP Server トラブルシューティングガイドを参照してください。

次のステップ

1. 認証を設定する — APIキーまたはOAuth 2.0
2. クライアントを設定する — Copilotを使ったVS Code, カーソル, またはクロードコード

Agoraからのインストールに問題がある場合は、直接Dequeの担当者に連絡するか、弊社のサポートデスクを通じて質問するか、メールを送信してください。