Google Analytics 4

Google Analytics 4 MCP 服务

Google Analytics 4 的 MCP 服务——通过 Admin 和 Data API 创建媒体资源、配置数据流、管理转化并运行报告。

一次性设置（约 3 分钟）

1. Google Cloud Console → IAM 和管理 → 服务账号

   • 创建一个服务账号（名称不限）
   • 点击该账号 → Keys → Add Key → JSON → 下载

2. 在 GCP 项目中启用 API：

   • Google Analytics Admin API
   • Google Analytics Data API

3. GA4 管理 → 媒体资源访问权限管理 → 将服务账号的邮箱（见 JSON）添加为编辑者

4. 配置凭据（任选一种）：

   • 选项 A（推荐）：将 JSON 内容复制到 MCP 配置中的 GA_CREDENTIALS 环境变量
   • 选项 B：将文件保存到 ~/.google-analytics-4-mcp/credentials.json

完成。无需浏览器流程、同意页面或刷新令牌。

安装

Claude Code

claude mcp add google-analytics -e GA_CREDENTIALS='{"type":"service_account",...}' -- uvx google-analytics-4-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-4-mcp"],
      "env": {
        "GA_CREDENTIALS": "{\"type\":\"service_account\",\"project_id\":\"...\", ...}"
      }
    }
  }
}

从源代码安装

git clone https://github.com/stucchi/mcp-google-analytics.git
cd mcp-google-analytics
uv run google-analytics-4-mcp

快速开始

1. 检查身份验证：调用 check_auth_status，确认服务账号已配置
2. 列出账号：调用 list_accounts 查看你的 GA4 账号
3. 设置媒体资源：依次使用 create_property → create_web_data_stream → get_tracking_snippet
4. 查询数据：使用 run_report，并指定维度和指标

工具（23 个）

身份验证

工具	描述
check_auth_status	验证服务账号是否已配置且有效

Admin API

工具	描述
list_accounts	列出可访问的 GA4 账号
list_properties	列出账号的媒体资源
create_property	创建 GA4 媒体资源
get_property	获取媒体资源详情
delete_property	软删除媒体资源
list_data_streams	列出数据流
create_web_data_stream	创建 Web 数据流 → 获取 Measurement ID
delete_data_stream	删除数据流
get_tracking_snippet	生成 gtag.js HTML 代码片段
list_key_events	列出转化事件
create_key_event	将事件标记为转化事件
delete_key_event	移除转化事件
list_custom_dimensions	列出自定义维度
create_custom_dimension	创建自定义维度
list_custom_metrics	列出自定义指标
create_custom_metric	创建自定义指标
list_google_ads_links	列出 Google Ads 关联
create_google_ads_link	关联 Google Ads 账号
get_measurement_protocol_secret	获取或创建 Measurement Protocol 密钥

Data API

工具	描述
run_report	使用维度、指标、日期和过滤条件运行报告
run_realtime_report	实时活跃用户和事件
get_metadata	列出可用的维度和指标

环境变量

变量	默认值	描述
GA_CREDENTIALS	—	服务账号 JSON 密钥内容（复制粘贴完整 JSON）
GA_CREDENTIALS_PATH	~/.google-analytics-4-mcp/credentials.json	备用选项：JSON 密钥文件的路径

GA_CREDENTIALS 的优先级高于 GA_CREDENTIALS_PATH。

使用示例

You: "Set up Google Analytics for my website https://mcpadvisor.stucchi.consulting"

Assistant calls: list_accounts → create_property → create_web_data_stream → get_tracking_snippet

Result: Property created with Measurement ID G-XXXXXXXXXX and ready-to-paste HTML snippet.

You: "Show me the top 10 countries by sessions in the last 7 days"

Assistant calls: run_report(property_id="...", dimensions=["country"], metrics=["sessions"], start_date="7daysAgo", limit=10)

许可证

MIT