モバイルツールを分析
このanalyze_mobileツールは、Axe DevTools Mobileルールを使用して、モバイルデバイスで現在表示されている画面のアクセシビリティの問題をスキャンします。接続されたAndroidデバイスまたはエミュレーター、起動したiOSシミュレーター、またはUSB接続のiPhoneで使用できます。
analyze_mobileにはAxe DevTools Mobileサブスクリプションが必要です。無料またはプレミアムプランには含まれていません。
その機能
- 認証 - Axe DevTools Mobileの資格情報を検証します:
AXE_MOBILE_API_KEYまたはAxe DevTools Mobileアカウント用OAuth 2.0アクセストークン - デバイスのセットアップ -
adb(Android) またはxcodebuild(iOS) を使用してあなたのマシンにDequeのスキャンサーバーをデバイスにインストールして開始します - アクセシビリティスキャン - デバイスで開いている画面をスキャンし、デフォルトのAxe DevTools Mobileルールを使用します
- 結果の配信 - 違反、不完全なチェック、合格を返し、それぞれについてエージェントがソースコード内のビューを見つけるのに十分な場所の詳細を提供します
要件
以下のすべてが真である場合にのみ、ツールはMCPクライアントに表示されます:
- npm配布。モバイルスキャンはコンテナがアクセスできないあなたのマシンに接続されたデバイスまたはシミュレーターを駆動します。
- Axe DevTools Mobileの資格情報。 Set
AXE_MOBILE_API_KEYto an Axe DevTools Mobile API key from the Axe Account Portal, or sign in with OAuth 2.0 using an account entitled to Axe DevTools Mobile. - スキャナーパッケージ、がサーバーの隣にインストールされます。セットアップを参照してください。
各プラットフォームには、サーバーを実行するマシンにツールが必要です:
| プラットフォーム | ホスト | 必要なもの |
|---|---|---|
| Android | macOS、Windows、Linux | Android SDK Platform-Tools、あなたのPATHにadbがある。USBデバッグがオンのデバイス、または実行中のエミュレーター。 |
| iOSシミュレーター | macOSのみ | Xcode(コマンドラインツールだけでなく)をxcode-selectで選択します。起動済みのシミュレーター。 |
| iPhone(物理) | macOSのみ | Xcode、USBケーブルで接続されたデベロッパーモードがオンのiPhone、WebDriverAgentを署名するためのApple Developerアカウント。物理的なiPhoneのスキャンを参照してください。 |
セットアップ
1. スキャナーパッケージをサーバーコマンドに追加する
npmディストリビューションがnpxでサーバーを実行するので、スキャナーパッケージを同じコマンドに追加します:
- Android用
@deque/axe-appium3-uiautomator2-server - iOS用
@deque/axe-appium3-webdriveragent-assets
macOSでは、両方をインストールします。たとえ1プラットフォームのみをスキャンする場合でもWindowsとLinuxでは、Androidパッケージのみをインストールします。サーバーは起動時に両方を探しますが、いずれかが欠けている場合はツールを提供しません。
macOS、両プラットフォーム:
{
"mcpServers": {
"axe-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"-p",
"axe-mcp-server",
"-p",
"@deque/axe-appium3-uiautomator2-server@^1.7.0",
"-p",
"@deque/axe-appium3-webdriveragent-assets@^1.7.0",
"axe-mcp-server"
],
"env": {
"AXE_MOBILE_API_KEY": "${AXE_MOBILE_API_KEY}"
}
}
}
}WindowsとLinux、Androidのみ:
"args": [
"-y",
"-p",
"axe-mcp-server",
"-p",
"@deque/axe-appium3-uiautomator2-server@^1.7.0",
"axe-mcp-server"
]この例はClaude Codeの.mcp.jsonフォーマットを使用しています。同じargsをあなたのクライアントの設定に入れてください。セットアップガイドでClaude Code、カーソル、またはVS Code with Copilotを参照してください。パッケージが不足している場合、サーバーはその起動ログで名前を示します。
2. 資格情報を設定する
次の1つを設定します:
- APIキー:
AXE_MOBILE_API_KEYをAxeアカウントポータルからAxe DevTools Mobile APIキーに設定します。 - OAuth 2.0:
npx @deque/axe-auth loginで1回サインインし、Axe DevTools Mobileを利用できるアカウントを使用します。その後、@deque/axe-auth runの下でサーバーを実行します:npxと同じ引数を--の後に置き、AXE_MOBILE_API_KEYを省略します。OAuth 2.0を参照してください。
APIキーを使用してウェブツールも利用する場合、AXE_API_KEYをAXE_MOBILE_API_KEYと一緒に設定します。APIキーはAXE_ACCESS_TOKENと組み合わせることはできません。構成リファレンスを参照してください。
3. デバイスを接続する
スキャンする前にデバイスが見えることを確認してください:
- Android:
adb devicesを実行します。デバイスまたはエミュレーターが状態deviceでリストされるはずです。unauthorizedの状態は、デバイスがまだUSBデバッグプロンプトを受け入れていないことを意味します。offlineはadbが到達できないことを意味します。 - iOS: シミュレータを確認するために
xcrun simctl list devices bootedを実行します。物理的なiPhoneはXcodeのデバイスとシミュレータウィンドウに表示されるはずです。
4. 初回スキャンを実行する
スキャンしたい画面を開き、その後にエージェントに指示します。
Android:
Scan the screen on my Android emulator for accessibility issuesiOS:
Scan the screen on my iPhone simulator for accessibility issuesiOSの場合、エージェントはスキャンとともにアプリのバンドルIDを送信します。これはXcodeプロジェクトで確認することもできますし、プロンプトで名前を指定することもできます。
最初のiOSスキャンはWebDriverAgentをビルドし、最大15分かかることがあります。同じデバイスでの後続のスキャンははるかに速くなります。
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
platform |
はい | "android"または"ios" |
bundleId |
はい(iOSのみ) | 画面上のアプリのバンドルID、com.example.appなど |
udid |
いいえ(iOSのみ) | スキャン対象のシミュレータまたはiPhoneのUDID。省略された場合、サーバーは起動されたシミュレータまたは接続されたiPhoneを使用します。 |
Androidデバイスを選択します。 Androidにはデバイスパラメータはありません。1つのデバイスまたはエミュレーターが準備できている場合、サーバーがスキャンを開始します。複数が準備できている場合、ANDROID_SERIALをサーバーの環境で希望するデバイスのシリアルadb devicesに設定します。
バンドルIDを見つける。 XcodeプロジェクトのPRODUCT_BUNDLE_IDENTIFIER、またはアプリのInfo.plistです。エージェントにその場所を教えるか、プロンプトにバンドルIDを含めます。
自然言語でAIエージェントに指示します。エージェントはあなたの意図をツール呼び出しに変換します:
Scan the app on my iPhone simulator for accessibility issues. The bundle ID
is in ios/MyApp.xcodeproj.エージェントはプロンプトを解決し、analyze_mobileを次のようなペイロードで呼び出します:
{
"platform": "ios",
"bundleId": "com.example.myapp"
}結果
ツールはスキャンのsummaryと、violations、incomplete、passesの3つの発見リストを返します。
発見
violations、incomplete、passesの各エントリには次のフィールドがあります:
| フィールド | 説明 |
|---|---|
ruleId |
Axe DevTools Mobileルール、ColorContrastなど |
summary |
ルールの短い説明 |
impact |
Critical、Serious、Moderate、またはMinor |
standard |
ルールがマッピングされる標準、WCAG 2.1など |
successCriteria |
ルールがマッピングされる成功条件、1.4.3など |
identifier |
ビューの開発者設定の識別子: iOSのaccessibilityIdentifier、またはAndroidのリソースID、#nameと表示されるか、ビューにない場合はnull |
viewPath |
画面のルートからビューまでのパス、クラス名のリストとして、各ビューの識別子がある場合はそれを括弧内に示し、Button(#login_button)など |
bounds |
画面上のビューの位置は、left、top、right、bottomとして示されます |
accessibleName |
支援技術がビューに対してアナウンスする名前、またはnull |
props |
ルール固有の証拠として、コントラストチェックが測定した色と比率などがあり、フィールドはルールにより異なります |
identifierとviewPathは、エージェントがソースコード内でビューを見つける方法です。identifierは最も直接的な一致ですので、プロジェクト内で検索してください。ビューに識別子がない場合、viewPathはクラス名および識別子を持つ最も近い祖先によってその位置を示します。
ルール
analyze_mobileは、各プラットフォームのAxe DevTools Mobileルールを実行します:
analyze_mobileはデフォルトのAxe DevTools Mobileルールを実行します。まだ組織のモバイルグローバルルール設定を適用しません。
Advanced RulesとIntelligent Guided Testsはウェブのみの機能であり、モバイルスキャンでは実行されません。
物理的なiPhoneのスキャン
物理的なiPhoneはシミュレータよりも少し多くのことが必要です:
- USBケーブルで接続します。 Wi-FiでMacとペアリングされた電話はスキャンできません。
- 開発者モードをオンにします の下で 設定 > プライバシーとセキュリティ > 開発者モード を選び、電話を再起動します。
- Macを信頼します。 電話のロックを解除し、信頼 が求められたときにタップします。
- ロックを解除したままにします、スキャン中は画面がオンのままにします。
- Apple開発者アカウントでWebDriverAgentに署名します。 サーバーは署名IDを設定しません。Xcodeで
WebDriverAgent.xcodeprojを開き、チームの下に署名と機能を選択し、Xcodeがプロビジョニングプロファイルを作成するのを許可します。
署名が失敗すると、スキャンは開発チームやプロビジョニングプロファイルのように、何が不足しているかを示すメッセージを返します。
トラブルシューティング
analyze_mobileがクライアントに表示されない場合、要件とサーバーの起動ログを確認し、欠けているスキャナーパッケージの名前を特定します。構成を変更した後、クライアントのMCPセッションを再起動します。
その他の問題については、サーバーのエラーメッセージが問題を示しています。メッセージ以上に必要なものがある場合:
| メッセージ | 対処法 |
|---|---|
AXE_MOBILE_API_KEY is not supported in the Docker distribution |
サーバーがモバイルキーでDocker内で起動を拒否します。npmディストリビューションに切り替えます。 |
No Android device or emulator found, or the device is not ready |
エミュレーターを起動するか、USBデバッグをオンにしたデバイスを接続し、デバイス上でプロンプトを受け入れます。adb devicesを確認します: 状態はdeviceでなければならず、unauthorizedまたはofflineではいけません。 |
More than one Android device is ready |
ANDROID_SERIALをスキャンするデバイスのシリアルに設定するか、他のデバイスを切断します。 |
The device named by ANDROID_SERIAL is not ready |
ANDROID_SERIALをadb devicesの左列と比較します。 |
An iOS scan needs the bundleId of the app on screen |
プロンプトにバンドルIDを含めるか、エージェントにそれを見つける場所を教えます。 |
xcodebuild not found |
App StoreからXcodeをインストールします。インストールされている場合は、それを選択します: sudo xcode-select -s /Applications/Xcode.app。コマンドラインツールだけでは不十分です。 |
The iPhone is not connected by USB |
Wi-Fiでペアリングされた電話はスキャンできません。USBケーブルで接続します。 |
Code signing failed: … |
Apple開発者アカウントでWebDriverAgentに署名します。物理的なiPhoneのスキャンを参照してください。 |
The device has Developer Mode disabled / has not trusted this Mac / appears to be locked |
物理的なiPhoneのスキャンの手順に従います。 |
The on-device scan server did not start within …ms |
MOBILE_SERVER_READY_TIMEOUT_MSを上げ、再試行します。 |
This account does not have an active axe DevTools Mobile subscription |
アカウント管理者にAxe DevTools Mobileサブスクリプションの追加を依頼し、その後新しいセッションを開始します。 |
This API key belongs to a different product |
AXE_MOBILE_API_KEYがAxe DevTools Mobileキーを、AXE_API_KEYがWebキーを持っていることを確認し、その後新しいセッションを開始します。 |
`analyze` needs a web credential (またはremediate、igt) |
AXE_MOBILE_API_KEYのみが設定されており、Webツールを認証しません。AXE_API_KEYを追加するか、OAuthに切り替えてAXE_MOBILE_API_KEYを削除し、その後新しいセッションを開始します。 |
その他の失敗の場合、サーバーの環境にLOG_LEVEL=debugを設定します。iOSビルドの失敗については、デバッグログにXcodeの出力が含まれます。また、一般的なトラブルシューティングページも参考にしてください。
制限事項
- 1つの画面ごとに1回。 このツールは画面上のものをスキャンし、アプリをナビゲートしません。各画面を自分で開き、それからスキャンしてください。
- 一度に1回のスキャン、1台のマシンごとに。 サーバーは1回のモバイルスキャンを実行し、Androidスキャンは固定されたローカルポートを使用するため、1台のマシンにつき1つのモバイルスキャンサーバーのみを稼働させてください。
- 高度なルールやインテリジェントガイドテストはありません。 両方ともウェブ専用です。
- スクリーンショットなし。
analyzeとは異なり、このツールは画面の画像を返しません。 - 最初のiOSビルド中に進捗の更新なし。 WebDriverAgentがビルドされ、スキャンが完了するまで、呼び出しは静かに保たれます。
- モバイルの修正なし。
remediateツールはウェブの問題のみを受け付けます。
