QuerySail: Google Analytics

QuerySail：Google Analytics MCP サーバー

QuerySail は、Google Analytics 4 用のホスト型読み取り専用 MCP サーバーです。ChatGPT、Claude、Codex、Cursor、VS Code に接続してサインインし、Google アカウントを一度接続すれば、トラフィック、エンゲージメント、コンバージョンについて自然な言葉で質問できます。インストールは不要で、Google Cloud プロジェクトや貼り付ける API キーも必要ありません。

• エンドポイント： https://mcp.querysail.com/ga4/mcp（Streamable HTTP、動的クライアント登録を使用した OAuth 2.1）
• ウェブサイト： https://querysail.com/google-analytics
• 料金： QuerySail for Google Search Console と同じプランに含まれます。クレジットカード不要の 7 日間無料トライアルの後、月額 8 ドルです。https://querysail.com/pricing をご覧ください。

このリポジトリには、公開掲載用ファイル（MCP Registry の server.json、Claude Code プラグイン、クライアント設定）が含まれています。サービス自体は querysail.com でホストされており、ソースコードはここでは公開されていません。

ツール

すべてのツールは読み取り専用です。QuerySail は、プロパティ、データストリーム、キーイベント、オーディエンス、その他の Google Analytics の設定を作成または編集できません。

ツール	機能
list_properties	接続済みの Google アカウントで読み取り可能な Google Analytics 4 プロパティを、正確なプロパティ ID と Analytics アカウントとともに一覧表示します。
list_fields	カスタムディメンション、カスタム指標、キーイベントを含め、プロパティでレポートに使用できるディメンションと指標を一覧表示します。
run_report	ユーザー数、セッション数、表示回数、エンゲージメント、イベント、キーイベント、収益、その他の Data API 指標を、日付、チャネル、参照元／メディア、ランディングページ、ページ、国、デバイス、イベントなどで分類し、フィルターを適用してレポートします。
compare_report	2 つの期間（前の期間、前年の同じ曜日、またはカスタム日付）を比較し、最も増加または減少したチャネル、参照元、ページ、国を一覧表示します。
run_realtime_report	過去 30 分間のアクティブユーザー数、表示回数、イベントを、国、都市、デバイス、ページ、イベント別に表示します。

プロンプトの例

• 過去 28 日間のサイトのユーザー数とセッション数はどれくらいですか？
• 先月、最も多くのセッションをもたらしたチャネルはどれですか？前月からどう変化しましたか？
• キーイベント数が最も多いランディングページはどれですか？
• 現在サイトにいるユーザーは何人で、どの国からアクセスしていますか？
• オーガニック検索のセッション数を、昨年の同じ週と比較してください。

セットアップ

Google Analytics に接続した QuerySail アカウントが必要です。https://querysail.com で登録し、Account → Connections から Connect Google Analytics を選択してください。以下の各クライアントでは、初回にサインインするためのブラウザーウィンドウが開きます。

Claude Code

claude mcp add --transport http --scope user querysail-ga4 https://mcp.querysail.com/ga4/mcp

次に /mcp を実行し、querysail-ga4 を選択してサインインします。または、Google Analytics 分析スキルも追加されるプラグインとしてインストールできます。

/plugin marketplace add querysail/querysail-ga4
/plugin install querysail-ga4@querysail-ga4

Claude Desktop と claude.ai

Customize → Connectors を開き、+ Add → Add custom connector を選択して、QuerySail GA4 という名前を付け、サーバー URL として https://mcp.querysail.com/ga4/mcp を貼り付けます。

ChatGPT

Settings → Security and login で Developer mode をオンにし、chatgpt.com/plugins に移動して、プラスボタンを選択し、接続 URL としてエンドポイントを貼り付けます。

Codex

codex mcp add querysail-ga4 --url https://mcp.querysail.com/ga4/mcp
codex mcp login querysail-ga4

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "querysail-ga4": { "url": "https://mcp.querysail.com/ga4/mcp" }
  }
}

VS Code

MCP: Add Server を実行して HTTP を選択し、エンドポイントを貼り付けるか、mcp.json に追加します。

{
  "servers": {
    "querysail-ga4": { "type": "http", "url": "https://mcp.querysail.com/ga4/mcp" }
  }
}

ローカルコマンドのみを実行するクライアント

mcp-remote ブリッジを使用します（Node.js が必要です）。

{
  "mcpServers": {
    "querysail-ga4": { "command": "npx", "args": ["mcp-remote", "https://mcp.querysail.com/ga4/mcp"] }
  }
}

データと制限

• Google へのアクセスには analytics.readonly スコープを使用します。このスコープは Search Console とは別に付与されます。リフレッシュトークンは保存時に暗号化されます。プロパティを非表示にしたり、Google との接続を解除したり、アカウントを削除したりできます。
• レポートはリクエスト時に Google から取得され、最大15分間キャッシュされます。リアルタイムレポートはキャッシュされません。Universal Analytics プロパティには対応していません。
• 一部のレポートには Google によるしきい値処理やサンプリングが適用される場合があります。QuerySail はそのフラグをアシスタントに渡します。プロパティごとの Google API クォータが適用されます。
• プライバシー：https://querysail.com/privacy · 利用規約：https://querysail.com/terms · サポート：https://querysail.com/support

ライセンス

このリポジトリ内のファイルは MIT ライセンスです。QuerySail サービスには利用規約が適用されます。