MCP サーバー

1. エージェントができること

Model Context Protocol クライアントをエンドポイントに接続すると、「今月、連打クリックが最も多いページは？」「ドイツからの2分超のセッションを3件見せて」といった質問ができ、セッションを再生するリンクを受け取れます。

ツール	得られる答え
mp_projects	このキーで読み取れるプロジェクト
mp_overview	セッション、人、ページビュー、時間、不満のシグナル
mp_sessions	国、デバイス、長さで絞り込んだ、再生リンク付きの最近のセッション
mp_session	一つのセッション：順序付きのページ、イベント、流入元、デバイス
mp_pages	閲覧数順のページとユニーク訪問者数
mp_frustration	ページ別の連打クリック、無反応クリック、JavaScript エラー
mp_goals	目標と、それぞれの達成回数

2. 接続

エンドポイントは、次で POST を受け付けます： /mcp 。Streamable HTTP に対応し、プロトコルのバージョンは 2026-07-28です。

認証には、通常の MousePlayer 読み取り用 API キーを使います。「設定」「API キー」で作成するものと同じで、REST API でも使う種類です。 二つ目の認証情報はありません。 キーを取り消すと、その瞬間にエージェントのアクセスも取り消されます。

次に、プロジェクトを有効にします

API キーはワークスペース全体へのアクセスを開きます。この機能では、意図的にそうしません。連携ページにプロジェクトごとのスイッチがあり、初期状態は無効です。有効にしていないプロジェクトは、 mp_projects に表示されず、エージェントが ID を推測しても読み取れません。

形式のための手続きではありません。デプロイスクリプトの API キーは、お客様が管理する一つの場所にあります。一方、エージェントの設定ファイル内のキーはモデルのコンテキストに入るため、管理の厳密さが大きく異なります。プロジェクトを一つずつ許可することが、それに合った制御です。

3. 読み取り専用であり、今後も変えない理由

七つのツールはいずれも書き込みません。このエンドポイントには、削除もエクスポートも設定変更もありません。時間が足りなかったからではなく、エージェントが呼び出せるツールは、誤っても呼び出せるツールだからです。

返さないもの

録画本体、DOM スナップショット、IP アドレスは返しません。エージェントが受け取るのは、人が画面で見る情報と、残りを視聴するリンクです。

レートと範囲の制限

キーごとに1分60リクエストで、REST API と同じです。期間は最大365日、結果一覧は最大200行です。切り詰めた場合はその旨を示します。黙って切り詰めた一覧は、完全な一覧と同じように見えるためです。

4. クライアントの開発者向け

メソッドは三つです： server/discover、 tools/list、 tools/call。セッション、GET ストリーム、次のものはありません： Last-Event-ID 。これらは2025-11-25までのプロトコルバージョンのもので、このバージョンには含まれません。GET または DELETE には405を返します。

すべての POST に、 MCP-Protocol-Version、 Mcp-Method 、および、次の場合には tools/call、 Mcp-Nameを含めます。それぞれが本文と一致しなければなりません。不一致の場合は、 400 と JSON-RPC エラーの -32020を返します。非対応のバージョンには、 400 と、 -32022 および対応しているバージョンの一覧を返すため、クライアントが選び直して再試行できます。

意図的に分けた二種類のエラー

不正なリクエストや不明なツールは JSON-RPC エラーになります。「このプロジェクトは許可されていません」「そのセッションはありません」は、次を伴う通常の結果として返します： isError: true 。モデルは後者なら、次を問い合わせて、 mp_projects 再試行することで回復できますが、前者からは回復できないためです。

結果には、次と、 structuredContent 同じデータをシリアライズしたテキストブロックの両方が含まれます。そのため、古いクライアントでも有用な情報を受け取れます。