GA4レポート作成 1. GA4をつなぐ

プロジェクトディレクトリを作る

この回では、最初に C:\aruru-code の中へ ga4-report というプロジェクトディレクトリを作って始めます。

作成後は、そのフォルダへ移動しておきます。

Google Cloud の基本が不安な方へ

プロジェクト作成、課金アカウント、API有効化、サービスアカウント作成などの共通設定をまとめています。初めてGoogle Cloudを触る方は、先にこちらを確認してから進めてください。

やること

Google Cloud で新しいプロジェクトを作成します。名前は `claude-ga4-mcp` のように分かりやすければOKです。作業自体は、今作った ga4-report フォルダを起点に進めます。

大事なポイント

JSONキーは認証ファイルなので、プロジェクトフォルダの外など安全な場所に保存してください。誰かと共有してはいけないファイルです。

.mcp.json をClaude Codeに作らせる

設定ファイルは手書きせず、Claude Codeに依頼して作ってもらいます。作業フォルダで claude を起動し、次のように依頼します。

生成された .mcp.json が、次のような構造になっているか確認してください。

{
  "mcpServers": {
    "ga4": {
      "command": "pipx",
      "args": [
        "run",
        "analytics-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "ここにサービスアカウント名（xxx@xxx.iam.gserviceaccount.com）が入る",
        "GOOGLE_APPLICATION_CREDENTIALS": "ここにサービスアカウントのキーファイル（JSON）のパスが入る",
        "GA_PROPERTY_ID": "ここにGA4のプロパティID（xxxxxxxxx）が入る"
      }
    }
  }
}

内容が一致していたら、GOOGLE_CLIENT_EMAIL・GOOGLE_APPLICATION_CREDENTIALS・GA_PROPERTY_ID の3つを自分のものに差し替えます。MCP名は Claude 上で見える名前なので自由です。

サービスアカウントのキーファイル（JSON）は、プロジェクトフォルダの外に保存してください。うっかりGitHub等にコミットしないためです。GOOGLE_APPLICATION_CREDENTIALS には、その外側の置き場所を絶対パスで指定します。

確認コマンド

Claude Code を再起動したあとに `/mcp` を実行して、`ga4: connected` と表示されれば接続成功です。

次へ

接続できたら、次は最初の GA4 レポートを作ってみます。