GA4 - Google Analytics MCP Server

GA4 - Google Analytics MCP Server

GA4 - Google Analytics MCPサーバーは、モデルコンテキストプロトコル（MCP）を使用してGoogle Analytics 4（GA4）データへのシームレスで安全、柔軟なアクセスを提供するオープンソースのサーバー実装です。このサーバーはAIアプリケーションや言語モデルがGA4からのリアルタイム分析データを問い合わせ、分析できるようにし、ワークフロー、ダッシュボード、エージェントベースのシステムに直接統合します。

Author: ruchernchong


プロトコルを表示

GA4 - Google Analytics MCPサーバーとは？

GA4 - Google Analytics MCPサーバーは、標準化されたモデルコンテキストプロトコルを通じてGoogle Analytics 4のレポート機能を公開するスタンドアロンサーバーです。このサーバーは、GA4プロパティとMCP対応のAIツールとの間で安全な橋渡しを行い、迅速な分析の検索、レポート作成、およびAIワークフローへの統合を可能にします。

設定方法

  1. Googleの設定

    • Google CloudプロジェクトでGoogle Analytics Data APIを有効にします。
    • "IAM & Admin > サービスアカウント"でサービスアカウントを作成し、JSON認証キーを生成します。
    • Google AnalyticsでサービスアカウントにGA4プロパティへの「ビューアー」アクセス権を付与します。

  2. サーバー環境

    • 環境変数を設定します：
      • GOOGLE_CLIENT_EMAIL: 認証JSONからのサービスアカウントのメールアドレス
      • GOOGLE_PRIVATE_KEY: 認証JSONからのサービスアカウントの秘密鍵
      • GA_PROPERTY_ID: GA4プロパティID

  3. インストール

    • グローバルにインストール：npm install -g mcp-server-google-analytics
    • またはnpxを使用：npx mcp-server-google-analytics
    • またはSmitheryを介してClaude Desktopの統合用にインストールします。

  4. AIツール用の設定（例：Claude Desktop）

    • MCPサーバーの下でツールの設定に適切なコマンドと環境変数を追加します。

使用方法

  1. サーバーを起動

    • pnpm start、npx mcp-server-google-analytics、またはツール統合から起動します。

  2. 関数/ツールを呼び出す

    • AIツールやLLMエージェントは、MCPインターフェースを介して、runReport、getPageViews、getActiveUsers、getEvents、getUserBehaviorなどの関数を呼び出すことができます。
    • 必要なフィールド（例：日付範囲、次元、指標）を関数の引数として渡します。

  3. 例：ページビューのクエリ

    • getPageViewsツールを使用して、日付範囲とオプションの次元を提供し、ページビュー指標を取得します。

  4. 統合

    • MCPをサポートするAIクライアントや自動化システムとサーバーを組み合わせて、動的な分析アクセスを実現します。

主要機能

  • 標準MCP関数呼び出しを介してリアルタイムのGA4分析データにアクセス。
  • カスタマイズ可能なレポート：特定の指標、次元、フィルター、期間を選択。
  • 複数の事前定義されたツール：ページビュー、ユーザー指標、イベント指標、行動分析。
  • 最小限の権限で安全なサービスアカウント認証。
  • スタンドアロン使用および統合使用（例：Claude Desktop）のための簡単なインストールと設定。
  • 将来の分析ニーズに対応するために拡張できるように設計されています。

使い道

  • GA4指標を直接AI駆動のダッシュボード、レポーティングツール、アシスタントのワークフローに統合します。
  • チャットボットやAIエージェントが、ウェブサイトやアプリの使用、トラフィックの傾向、ユーザーのエンゲージメントについての質問に答えることを可能にします。
  • 分析の要約、コホート分析、イベントベースのレポートの生成を自動化します。
  • AI対応製品内で、キャンペーンのパフォーマンスやユーザー行動をリアルタイムで監視します。

よくある質問

Q1: サービスアカウントに必要なGA4の権限は？
A: サービスアカウントには、ターゲットGA4プロパティへの「ビューアー」アクセスが必要で、分析データへの読み取り専用アクセスが許可されます。

Q2: 操作中に私の秘密鍵は安全ですか？
A: はい、あなたの秘密鍵と認証情報はサーバー側の環境変数にのみ保持され、クライアントや公開リポジトリには決して露出されません。

Q3: これはどんなAIツールやワークフローでも使えますか？
A: はい、ツールがMCP統合をサポートしていれば、サーバーを接続して分析機能にアクセスできます。

Q4: 認証情報が無効であるか、適切に設定されていない場合はどうなりますか？
A: サーバーはGoogle Analyticsとの認証に失敗し、関数呼び出しは認証情報の問題を示すエラーを返します。設定手順を適切に従っていることを確認してください。

Q5: 利用可能なツールを拡張またはカスタマイズできますか？
A: はい、このプロジェクトはオープンソースであり、追加のGA4クエリやカスタムレポートロジックをサポートするようにサーバーを貢献または適応させることができます。