Microsoft Clarity MCP

Microsoft Clarity MCP サーバー（microsoft-clarity-mcp）

行動 UX 分析、レイジクリック、無反応クリック、すぐに戻る操作、過剰なスクロール、JavaScript のランタイムエラーに対応する、Microsoft Clarity のデータエクスポート API を公開する FastMCP サーバーです。

AI エージェント向けの Google Analytics および Search Console と連携する行動診断エンジンです。

---

1. クイックスタート

uvx（Python）または npx（Node）を使うと、インストールせずに直接実行できます。

Python 経由（uvx）

uvx microsoft-clarity-mcp

Node 経由（npx）

npx microsoft-clarity-mcp

---

2. MCP クライアントの設定

MCP クライアントの設定（claude_desktop_config.json、cursor.json、または Antigravity/OpenCode）に追加します。

{
  "mcpServers": {
    "microsoft-clarity": {
      "command": "uvx",
      "args": ["microsoft-clarity-mcp"],
      "env": {
        "CLARITY_API_TOKEN": "your_clarity_api_token_here"
      }
    }
  }
}

または、npx を使用します。

{
  "mcpServers": {
    "microsoft-clarity": {
      "command": "npx",
      "args": ["-y", "microsoft-clarity-mcp"],
      "env": {
        "CLARITY_API_TOKEN": "your_clarity_api_token_here"
      }
    }
  }
}

---

3. 認証と API トークン

Microsoft Clarity では、静的な JWT Bearer トークンを使用してデータエクスポートを保護しています。

1. Microsoft Clarity にログインします。
2. プロジェクトのダッシュボードを開きます。
3. Settings -> Data Export に移動します。
4. Generate new API token をクリックします（4～32 文字の英数字で名前を指定します。例：clarity-agent）。
5. 生成されたトークンをコピーし、CLARITY_API_TOKEN を設定します。

---

4. レート制限対策と永続キャッシュ

• 1 日あたりの上限：Microsoft Clarity では、プロジェクトごとに 1 日 10 リクエストまでに厳しく制限されています。
• 自動キャッシュ：エージェントの暴走ループによるユーザーの利用枠の消費を防ぐため、すべてのレスポンスは ~/.clarity_mcp/cache.json に 1 時間の TTL でローカル保存されます（CLARITY_CACHE_TTL で設定可能です）。
• 古いキャッシュへのフォールバック：1 日あたりの 10 リクエストの上限に達すると、サーバーは明示的な警告とともに古いキャッシュデータを自動的に返すため、エージェントは強制終了することなく動作を続けられます。
• 利用枠の可視化：各ツールのレスポンスには、calls_used_today、remaining_today、daily_limit の詳細を示すメタデータが含まれます。

---

5. ツール

ツール	パラメーター	説明
get_ux_insights	project_id、num_of_days=3、token	セッション数、レイジクリック、無反応クリック、すぐに戻る操作、過剰なスクロール、JS エラーなど、行動上の摩擦に関する主要な指標です。
get_frustration_breakdown	project_id、dimension="URL"、num_of_days=3、token	URL パス、デバイス、ブラウザー、オペレーティングシステム、国別に、摩擦の深刻度をランキング形式で示します。
get_js_errors	project_id、num_of_days=3、token	ブラウザーおよびオペレーティングシステム別にグループ化した、JavaScript のランタイム例外とエラークリックです。
doctor	project_id、token	トークン形式、キャッシュの整合性、1 日あたりの残り API 利用枠を確認する診断ユーティリティです。
skills_list	(なし)	サーバーに同梱された動的なスキルプレイブックを一覧表示します。
skill_read	name	運用プレイブック（例：ux-triage、setup-clarity-token、frustration-audit）を取得します。
check_for_updates	(なし)	PyPI で新しいバージョンとアップグレードコマンドを確認します。

---

6. テレメトリーとプライバシー

このパッケージには、信頼性の確保とさまざまなクライアントハーネスでのランタイムバグ検出を目的とした、匿名の使用状況テレメトリーが含まれています。テレメトリーは Schema v2 に厳密に準拠しています。

• オプトアウト：DO_NOT_TRACK=1、DISABLE_TELEMETRY=1、または CLARITY_TELEMETRY=false を厳密に尊重します。
• 個人情報ゼロ：ユーザー URL、個人識別情報、認証トークンは一切収集されません。

---

ライセンス

MIT License。Copyright (c) 2026 Surendran B。