高度なルール

高度なルール は、一見見出しに見えるが見出しでないもの、役に立たない代替テキストを持つ情報画像、グラデーションや画像上のテキストのコントラストなどの標準の axe-core では捉えられない問題を検出するために、スクリーンショット、コンピュータービジョン、大規模言語モデルを使用した一連の自動アクセシビリティテストです。

この analyze ツールは、標準の axe-core ルールセットとともに高度なルールを実行することができます。この場合、特別な操作やワークフローの変更は不要で、進化した検出結果がすでにエージェントが使用している同じ結果配列に統合されます。

高度なルールは、組織のAxe の設定によって管理され、管理者が許可する場合には、サーバー単位またはスキャン単位で上書きすることができます。

許容されるプリセット値

AI を使用する高度なルールは、明確な合格や不合格ではなく信頼度スコアを報告し、プリセットは報告されるかどうかの閾値を設定します。各プリセットが意味することや選択方法については信頼度コントロールを参照してください。すべての製品で高度なルールを使用する場合、閾値は同じです。

Axe MCP サーバーがプリセットを受け入れる場所では、advancedRules ツール引数またはAXE_ADVANCED_RULES 環境変数で、以下のような値が認識されます：

値は大文字小文字を区別せず、周囲の空白は無視されるので、" Balanced " と "BALANCED" はどちらも balanced に解決されます。disabled のパーセンテージエイリアスはありません。

プリセットの選択

プリセットを設定する方法は3つあります。複数が存在する場合、優先順位の高いものが優先されます：

1. advancedRules ツール引数 — スキャンごとに
2. AXE_ADVANCED_RULES 環境変数 — サーバーごとに
3. 組織の Axe 設定のデフォルト — 組織ごとに

どのソースが使用されても、解決された値は応答のadvancedRules ブロックに報告されるので、エージェントはどのプリセットが実行されたかを常に確認できます。

組織のデフォルト

Your organization's default comes from the デフォルトの高度なルール setting in Axe の設定, which an administrator manages in the Axe Account Portal. That page documents the available options and the 「ユーザーに変更を許可」 checkbox that decides whether the two overrides below are permitted at all.

Axe MCP サーバーに特化した2つの事項:

• サーバーはすべての analyze呼び出しの際に Axe 設定を読み取るため、管理者が行った変更は次のスキャンで反映されます — サーバーやクライアントの再起動は不要です。
• 設定がロックされていると、環境変数とツール引数は静かに無視され、応答には"source": "org_policy_locked"が報告されます。これにより、オーバーライドが適用されずに除外されたことがわかります。

AXE_ADVANCED_RULES環境変数

MCP サーバー構成にAXE_ADVANCED_RULESを設定して、そのサーバーが実行するすべてのスキャンに対してプリセットを選択します。チーム全体やプロジェクト全体の選択を、各プロンプトで繰り返す必要がないようにするには、ここが適切な場所です。

{
  "servers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_ACCESS_TOKEN": "<your-token>",
        "AXE_ADVANCED_RULES": "thorough"
      }
    }
  }
}

詳細は設定リファレンスを参照し、クライアント設定ガイドではクライアントの中にどこにenvブロックが存在するかを確認してください。

Invalid Advanced Rules value: "high". Expected one of: 'precise' (90%), 'balanced' (70%), 'thorough' (50%), 'disabled'.

advancedRulesツール引数

advancedRules を単一のanalyze コールに渡して、そのスキャンのプリセットを上書きします。AI エージェントに自然言語で指示してください — エージェントはあなたの意図をツールコールに翻訳します：

Analyze http://localhost:3000 for accessibility issues using the
thorough advanced rules preset

エージェントはanalyzeツールを次のようなペイロードで呼び出します：

{
  "url": "http://localhost:3000",
  "advancedRules": "thorough"
}

ここに無効な値を指定すると、許容される値を名前する1回のスキーマ検証エラーが発生し、サーバーや後続の呼び出しには影響しません。

ツール引数を使用して、一時的な逸脱を行いたい場合に使用します — たとえば、thoroughが監査中のページである場合や、disabledが大きなページで高速な標準結果だけを求めたい場合などです。

Analyze http://localhost:3000 with advanced rules disabled

advancedRules応答ブロック

すべてのanalyze応答には、実際に実行されたプリセットとその出所を報告するadvancedRulesブロックが含まれています。

{
  "pageUrl": "http://localhost:3000",
  "data": [],
  "advancedRules": {
    "value": "balanced",
    "source": "org_default"
  }
}

valueは常に4つのプリセットのいずれかです。sourceは、その値にどのように到達したかを説明します。

フェールクローズの動作

Axe MCPサーバーはプリセットを推測することはありません。Axe Configurationに接続可能だがアドバンストルールの設定が欠けている場合、またはこのバージョンのサーバーが認識しない値を持っている場合、スキャンは"value": "disabled", "source": "unavailable"を報告し、標準のaxe-coreのみを実行します — ハードコーディングされたプリセットにではないフォールバックすることはありません。これにより、サーバーとAxe アカウント ポータルの間のバージョンの相違から、誰も選んでいないしきい値が静かに適用されることを防ぎます。

Axe Configurationをまったく取得できない場合（ネットワーク障害、無効な資格情報）、analyze呼び出しは不明な設定でスキャンする代わりに完全に失敗します。これは既存のすべての設定に対する動作であり、アドバンストルールに特有のものではありません — 認証エラーを参照してください。

アドバンストルールが実行されない場合

disabledという効果的な値は、アドバンストルールがスキャンに実際にロードされていないことを意味します。スクリーンショットはそれらのためにキャプチャされず、Dequeへの評価も送信されず、AIクレジットも消費されません。標準のaxe-core検出結果は、他のパターンと同様に返されます。

要求したプリセットがサーバーにアドバンストルールが利用できないために実行できない場合、応答のmessages配列がそれを示しています。

Advanced Rules are not enabled for this server; the scan used standard axe-core only.

何も要求しなかった場合、メッセージは発行されません — disabled組織のデフォルトは意図的な選択であり、報告する問題ではありません。

部分的な劣化

アドバンストルールはスキャンを失敗させることは決してありません。ルールがロードされるがサーバー側の評価が問題に直面した場合、analyzeは標準のaxe-core結果に加えて失われた内容を説明するメッセージを返します。

利用可能性

Axe MCPサーバーは、ウェブ用の Axe DevToolsバンドルに含まれており、アドバンストルールが付属しています。Axe MCPサーバーにアクセスできる場合、アドバンストルールも利用可能です — アドバンストルールの別途購入は必要ありません。

アドバンストルールを利用できない状況がまだ一つあります：アドバンストルールはサーバー側で評価されるため、デプロイメントはDequeのAIインフラストラクチャに接続されている必要があります。プライベートクラウドとオンプレミスのデプロイメントには、MLとLLMのサービスが必要です — AI機能の利用ガイドをご覧ください。SaaSカスタマーは、最初から接続されています。

スキャンが"source": "unavailable"を報告し、アドバンストルールが利用可能であることを期待している場合、カスタマーサクセスマネージャーにお問い合わせください。サーバーの起動時に可用性が解決されるため、MCPサーバー（またはMCPクライアント）を再起動してからサブスクリプション変更後の次のスキャンで取得されることを期待せずに、再起動してください。

Dequeに送信される内容

アドバンストルールは、analyzeページデータをDequeサーバーに送信する唯一のケースです。アクティブなプリセットが解決されたとき、スキャンは次のことを行います：

1. ブラウザで全ページのスクリーンショットをキャプチャし、Dequeのスクリーンショットエンドポイントにアップロードします。
2. レコーダーの評価ペイロード（ページ構造、計算済みのスタイルとジオメトリ）がDequeのアドバンストルールエンドポイントに送信され、MLとLLMのモデルがそれを評価します。
3. 返された発見結果をあなたの結果にマージします。

標準のaxe-coreスキャンには影響しません：アドバンストルールdisabled、analyzeツールはDequeに認証と設定要求以外を送信しません。

AIクレジット

大きな言語モデルを利用するアドバンストルールは、組織の毎月の割り当てからAIクレジットを消費します。専用のアドバンストルールサブスクリプションを持つ組織は、クレジットが請求されません。

クレジット残高が尽きた場合、AI駆動の高度なルールはスキップされ、残りの高度なルールは実行され続けます。スキャンは失敗しません。監視と購入についてはAIクレジットをご覧ください。

スキャン時間

高度なルールはスキャンに意味のある時間を追加します。通常はスクリーンショットのキャプチャとアップロードに加えて15〜20秒です。高度なルールを有効にした後にスキャンがタイムアウトし始めた場合は、BROWSER_TIMEOUT_MSを増やしてください（設定リファレンスを参照）あるいはdisabledを使用して反復し、最終確認のためにアクティブなプリセットを使ってください。

信頼性

一部の高度なルールはAIを使用しているため、同じページでの実行間で結果がわずかに異なることがあります。75%の信頼度で報告された所見が次のスキャンで65%になることがあり、これによりしきい値をクリアするかどうかが変わることがあります。結果は、オペレーティングシステム、GPU、ディスプレイ特性などがレンダリングに影響を与えるため、マシンや環境によっても異なることもあります。

高度な所見の実行間の違いを回帰ではなく、期待されるばらつきとして扱ってください。全体像については制限事項と考慮点をご覧ください。

他の設定との関係

• 実験的なルールは独立しています。 advancedRules: "disabled"は実験的なaxe-coreルールを無効にしません。また、実験的ルールを有効にしても、高度なルールのプリセットがバイパスされることはありません。この2つの設定が組み合わされます。
• 個別の信頼度しきい値オプションはありません。 しきい値はプリセットから導かれ、Axe ConfigurationとAxe DevTools Browser Extensionに一致します。
• アクセシビリティの標準、ベストプラクティス、および要レビューは依然として適用されます。 高度な所見は標準的な所見と同じAxe Configuration設定によってフィルタリングされます。