Claude Code
GA4 を Claude Code に接続するには、claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp で PaidSync.ai にサインインします。
Claude Code は 26 のツールで Google Analytics 4 にアクセスします。カスタムレポート、リアルタイム確認、キーイベント、カスタムディメンション、オーディエンス、Google Ads リンクに対応し、各ツールの実行前に確認します。GA4 の書き込みはドライランなしで初回から適用されます。
コマンド一つ。OAuth で鍵の貼り付け不要。無料プラン月 100 タスク、$50 相当、カード不要。
コマンド
Claude Code は、Streamable HTTP でリモートの MCP サーバーと通信します。PaidSync もその一つです。一度追加すれば、コードを編集するのと同じターミナルから GA4 プロパティを照会し、設定できます。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpデフォルトでは、現在のプロジェクトにのみサーバーを登録します。--scope user を追加すると、お使いのマシン上のすべてのプロジェクトで利用できます。
claude mcp list を実行して登録を確認し、セッションを開始して /mcp と入力してサインインします。
5 ステップのセットアップ
1paidsync.ai/signup で登録
所要時間は 10 秒。Google またはメールでサインインします。無料プランは月 100 タスクで $0、カード不要です。
2PaidSync ダッシュボードで GA4 を接続する
Google Analytics 4 の 接続 をクリックします。GA4 は、プロパティにアクセスできる Google アカウントで Google OAuth により認可されます。Google Ads と同じ Google サインインを使い、アナリティクスのスコープ analytics.edit と analytics.readonly を要求します。
すでに Claude Code の中にいますか？ connect_ga4 の実行を頼んでください。ツールがブラウザで開く OAuth リンクを返します。
3Claude Code が作業するプロパティを選ぶ
セッション内では、list_ga4_accounts と list_ga4_properties で、サインインで届くすべてのプロパティが表示されます。プロンプトでプロパティを指定するか、プロジェクトの CLAUDE.md に固定して、すべてのセッションで使います。
4PaidSync を Claude Code に追加する
ターミナルで次を実行します。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpセッションを開始して /mcp と入力し、paidsync を選んで、開いたブラウザウィンドウで PaidSync のログインでサインインします。OAuth トークンは Claude Code が保存します。キーはどこにも貼り付けません。
チームで設定しますか？リポジトリのルートに .mcp.json をコミットすれば、エンジニア全員が同じコネクタを使えます。
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}ヘッドレス実行などで API キーを使いたいですか？ログに残ってしまう URL ではなく、ヘッダーで送ってください。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"コミットする .mcp.json には "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } を追加すると、キーは各エンジニアの環境に残り、git には入りません。Google Ads の変更の適用には、引き続き OAuth サインインが必要です。ほかのプラットフォームではキーでも変更を適用できるため、パスワードと同じように扱い、OAuth を優先してください。
5接続をテスト
Claude Code のセッションで次のように質問します。“過去 28 日間のソースとメディア別のセッションとキーイベントを表示してください”
Claude Code はそのプロパティで GA4 レポートを実行し、表を返します。これで接続は完了です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code 向け GA4 プロンプト
以下のプロンプトは、それぞれ PaidSync の GA4 グループのツールに対応します。ツールは Claude Code が選びます。最後の列は、その呼び出しがプロパティを変更し得るかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “GA4 プロパティとそのデータストリームを一覧表示してください” | list_ga4_properties, list_ga4_data_streams | なし |
| “過去 28 日間のソースとメディア別のセッションとコンバージョン” | run_ga4_report | なし |
| “purchase イベントは今発火していますか？” | run_ga4_realtime_report | なし |
| “どのキーイベントが設定されていて、Google Ads はリンクされていますか？” | list_ga4_conversion_events, list_ga4_google_ads_links | なし |
| “ウェブストリームでオンになっている拡張計測機能のイベントはどれですか？” | get_ga4_enhanced_measurement | なし |
| “generate_lead をキーイベントに設定してください” | create_ga4_conversion_event | はい、確認後に実行されます |
| “plan_tier イベントパラメータのカスタムディメンションを追加してください” | create_ga4_custom_dimension | はい、確認後に実行されます |
| “Google Ads アカウント 123-456-7890 をこのプロパティにリンクしてください” | create_ga4_google_ads_link | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Run a GA4 report for the last 7 days of sessions and key events by source and medium, and flag any source whose key events dropped against the week before." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/ga4-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
26 個の GA4 ツールのうち、11 個は読み取り専用、13 個は書き込みができます。
続きを読む
読み取りとレポートは、プロパティ、データストリーム、キーイベント、カスタムディメンションと指標、オーディエンス、Google Ads リンク、拡張計測機能に対応し、run_ga4_report によるカスタムレポートと run_ga4_realtime_report による直近 30 分のデータも取得できます。
書き込みはプロパティの設定を変更します。対象は、プロパティ、データストリーム、キーイベント、カスタムディメンションと指標、オーディエンス、拡張計測機能、Google Ads リンクです。GA4 への書き込みにはドライランがありません。どれも最初の呼び出しで適用されるため、許可する前に Claude Code のプロンプトで引数を確認してください。削除には confirm_destructive が必要です。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
知っておきたい制限
create_ga4_conversion_eventがイベントをキーイベントに設定するには、そのイベントがデータストリームですでに発火している必要があります。- GA4 のツールは、ウェブサイトにタグを設置しません。タグは Google Tag Manager にあり、独自の Claude Code のセットアップ があります。
setup_ga4_eventは GTM のワークスペースに GA4 イベントタグを作成するため、GTM も接続されている必要があります。 delete_ga4_conversion_eventでキーイベントを削除すると、キーイベントとしてカウントされなくなります。GA4 はそのイベント自体の収集を続けます。- リアルタイムレポートは直近 30 分のみが対象です。それより前のデータには
run_ga4_reportを使います。
よくある質問
GA4 を Claude Code に接続するには？
paidsync.ai に登録し、ダッシュボードで Google サインインにより Google Analytics 4 を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインします。
Claude Code は GA4 の設定を変更できますか？
はい。Claude Code は、キーイベントの設定、カスタムディメンションと指標の追加、オーディエンスの作成、拡張計測機能の変更、Google Ads のリンクができます。GA4 の書き込みにはドライランがなく、最初の呼び出しで適用されるため、Claude Code のプロンプトが確認の場になります。削除には明示的な確認が必要です。
Claude Code でトラッキングが動いているか確認できますか？
はい。run_ga4_realtime_report は直近 30 分を表示するので、サイトでテストイベントを発火させて、届いたかどうかを Claude Code に尋ねられます。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
26 個の GA4 ツール。Claude Code でコマンド一つ。