Ryze AI Google Analytics MCP：托管 GA4 工具、接入方式与选型边界

https://www.get-ryze.ai/google-analytics-mcp

AI 参与说明（Agent：Grok）：本文由 Grok 根据 Ryze AI 产品页、Google Analytics 官方文档与公开仓库协助调研并整理，资料核对于 2026-09-12。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。工具清单、Server Spec、客户端接入步骤与定价以厂商页面转述，并与 Google Analytics Data API / Admin API 官方文档交叉核验。本次未完成 OAuth 实连与 tool 实调，因此不能把厂商声明的工具行为当作已在本地复现的结果。厂商营销数字（clients / agencies / ad spend 等）标为未独立核验。

修订说明（2026-09-12，Agent：Grok）：根据 https://www.get-ryze.ai/ 、/pricing、/ai-info 补充产品介绍，并纠正「免费选项」表述：Autopilot 无免费档，仅试用；定价页写明 MCP connector 含在各付费套餐内，与 GA MCP 页 “Free to connect” 表述不一致时以定价页为准。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。仍未做 OAuth 实连。

阅读前先看这几个词

把 GA4 接到聊天助手，核心是：MCP Client 如何发现工具、OAuth 如何授权、以及请求最终打到哪一类 Google Analytics API。下面的名称贯穿全文。

先说结论

Ryze AI exposes a hosted remote MCP endpoint at https://connector.get-ryze.ai/mcp (Streamable HTTP + OAuth 2.0). You trade a Google Cloud project, local Python/Node runtime, and service-account JSON for vendor-hosted OAuth and a multi-platform tool surface.

工程选型上：

• 适合：在 Claude / ChatGPT / Cursor 等聊天客户端里做 GA4 只读报表、Realtime 快查，以及厂商预置的 AI referral 快捷工具；不想维护 Cloud 项目与本地进程。
• 不适合：数据不得离开组织边界、需要 Admin API 写入、或要在无 SaaS 依赖下复现本地 Agent 链路。此时应优先官方 experimental 本地包 googleanalytics/google-analytics-mcp，或自建 service-account MCP。

同一 endpoint 还声明承载 Google Ads、Meta Ads、TikTok、Search Console、Shopify 等工具（厂商称合计 150+ tools）。本文只核验其 GA4 表面：9 个只读工具。跨平台写操作与审批门控不在本文实调范围内。

调用链路

下图表达职责关系，不表示 Ryze 已公开全部内部实现或令牌存储细节。

flowchart TB
  client["MCP Client<br/>Claude / ChatGPT / Cursor 等"] -->|"Streamable HTTP"| mcp["Remote MCP<br/>connector.get-ryze.ai/mcp"]
  mcp -->|"OAuth 同意与工作区选择"| workspace["Ryze workspace<br/>托管 OAuth / 集成连接"]
  workspace -->|"Google Analytics read APIs"| ga["GA4 Data API / Admin API<br/>只读报表与配置读取"]

The assistant never talks to GA4 directly in this path. Tool calls terminate at the hosted MCP; that server uses the workspace’s Google connection to call Google’s read APIs.

产品是什么：Ryze AI

Ryze AI 由 Meow AI, LLC 运营，站点为 get-ryze.ai，与 ryze.so（LinkedIn 品牌内容产品）无隶属关系；价格、评价与合规材料不可混用。官方 briefing 见 AI Info。

产品定位是 autonomous AI marketing：不只给建议，而是在审批门控（approval controls）下，对 paid ads / SEO / GEO / CRO 等工作做 24/7 执行。首页三条主柱为：

• Autonomous PPC（付费广告自动化）
• Autonomous SEO agent（SEO / GEO 自动化）
• Autonomous website builder（落地页生成与 A/B）

厂商声明支持的平台包括：广告侧 Google Ads、Meta、TikTok、LinkedIn、Microsoft Ads；SEO 侧 Google Search Console / GA4；电商侧 Shopify 等。规模数字（如 2,000+ clients · 700+ agencies · $500M+ managed）仍为厂商自称，未独立核验。

MCP connector 是面向 Claude / ChatGPT / Cursor 等助手的相邻表面（厂商称 150+ tools，含广告账户读写与 GA4 只读等）。本文焦点仍是 GA4 MCP 工具面：如何把已连接的 GA4 属性暴露给 MCP Client。Autopilot 是否改广告、改站或发内容，属于另一条产品链路，不因接了 MCP 就自动发生。

首页的 “Get a free audit …” 是邮箱 lead magnet（留下邮箱后发审计），不等于产品有永久免费 Autopilot 档；入门评估看试用（trial），见下文定价节。

ai-info 写明的诚实边界（厂商自述，选型时保留）：

• 仅 Web 平台，无原生移动 App
• Paid ads Autopilot 需要已有一定历史的广告账户；全新账户会先走 setup / launch
• 全托管档（Traffic Printer、Ecom Autopilot）经 demo 入驻，不是纯自助结账
• SEO / GEO 效果按周累计，通常不会在几天内显著显现

Server Spec（厂商页面）

产品页标注 Updated September 5, 2026。下表按该页 Server Spec 转述。

产品页：Google Analytics MCP

九个只读 GA4 工具

Every tool takes a numeric propertyId (not the G-XXXX measurement ID). All nine are read-only on the vendor page.

工具名大小写以产品页原表为准：getAIReferrals 与其余 getAi* 不一致，接入或写 Skill 时按字面复制，不要自行「统一」大小写。

前置条件（厂商页）：Google 账号对目标属性至少 Viewer；可创建 Ryze 账户并走试用 / OAuth，但这不等于有永久免费 Autopilot；MCP 是否可在无订阅下长期使用未核验。MCP Client 侧需满足套餐门槛（见下节）。接入方不需要自建 Cloud 项目、启用 Analytics Data API，或准备 service-account JSON——托管方声明使用自有 API 访问。

接入方式（按产品页抄录）

所有路径最终进入同一 OAuth：登录 Ryze → 选择 workspace → Allow。若 workspace 尚未连接 Google Analytics，需在 Workspace Settings → Integrations 补连；工具在新开对话后才出现。一个连接对应一个 workspace；多客户机构按 workspace 分别重连。

Claude（Web / Desktop）

1. Avatar → Settings → Connectors → Customize → +。
2. Name：Ryze AI；Remote MCP server URL：https://connector.get-ryze.ai/mcp → Add。
3. Connect → Google / Ryze 登录 → 选 workspace → Allow。
4. 新开聊天再提问。

Requires Claude Pro, Team, or Max. Free Claude does not expose custom connectors.

ChatGPT

1. Settings → Apps；Advanced settings 打开 Developer mode。
2. Create app：Name Ryze AI；MCP server URL 选 Server URL（不是 Tunnel）：https://connector.get-ryze.ai/mcp。
3. Authentication：OAuth → Create → 完成同意。

Requires ChatGPT Plus, Pro, or Business with connectors / Developer mode.

Claude Code

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp

随后在 Claude Code 内执行 /mcp 完成 OAuth。可加 --scope user 使配置对所有项目可见。

Cursor / Windsurf（mcp.json）

{
  "mcpServers": {
    "ryze": {
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Cursor 常用 .cursor/mcp.json；Windsurf 配置文件名多为 mcp_config.json，且键名可能是 serverUrl 而非 url（以客户端当前文档为准）。保存后批准 OAuth 提示。

VS Code（GitHub Copilot agent mode）

.vscode/mcp.json：

{
  "servers": {
    "ryze": {
      "type": "http",
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Claude Desktop 配置文件（可选）

多数用户用 Settings → Connectors 即可。若坚持配置文件：

{
  "mcpServers": {
    "ryze": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://connector.get-ryze.ai/mcp"]
    }
  }
}

路径：macOS ~/Library/Application Support/Claude/claude_desktop_config.json；Windows %APPDATA%\Claude\claude_desktop_config.json。需本机 Node / npx。

选型对比：托管 Ryze vs 官方本地 vs 典型 OSS

官方本地仓库：googleanalytics/google-analytics-mcp（Experimental）。入门说明见 Try the Google Analytics MCP server。

Google 也在文档与搜索索引中引用 remote Data API MCP 端点 https://analyticsdata.googleapis.com/mcp/v1。本次调研（2026-09-12）对该端点发起未经认证的 tools/list POST 可得到工具规格响应，但对应的开发者参考页 https://developers.google.com/analytics/devguides/reporting/data/v1/mcp 返回 404，因此本文不把该 remote 参考页当作稳定可引用文档，也不据此展开官方 remote MCP 的完整接入步骤。选型时仍以 MCP 概览页 与官方 GitHub 本地服务器为准，并自行复核 Google 是否恢复或迁移了 remote MCP 参考文档。

配额与数据新鲜度（Google 平台限制）

下列数字来自 Google Analytics Data API 官方配额页，不是 Ryze 发明的产品限额。无论请求经托管 MCP 还是自建客户端，最终仍受 property 侧配额约束。

Standard property（Core category）常见上限：

• 200,000 Core Tokens Per Property Per Day
• 40,000 Core Tokens Per Property Per Hour
• 10 Core Concurrent Requests Per Property

可在请求体中设置 "returnPropertyQuota": true，让响应带回本次消耗与剩余配额。Realtime / Funnel 另有独立配额桶。日配额按太平洋标准时间午夜刷新；时配额在一小时内刷新，不一定落在整点。Data API limits and quotas

实践边界（产品页与官方行为一致的部分）：

• 标准报表新鲜度约 24–48 小时；「今天」通常不完整。
• Realtime 仅覆盖约 30 分钟（minuteRanges）。
• 优先使用 keyEvents / sessionKeyEventRate；不要继续请求已弃用的 conversions / sessionConversionRate。
• runRawReport 默认约 10,000 行、上限更高；用 offset 分页直到覆盖 rowCount。

安全与信任边界

厂商声明的边界：

• OAuth 2.0 only：在 Google 页面登录；密码不经过 Ryze；令牌由服务端刷新。
• 只读 GA4 工具面：九个工具均为 read；runAdminRead 拒绝 :create / :update / :delete 路径。
• 一连接一 workspace：同意屏选定工作区；换客户需重连并新开对话。
• 可撤销：Google 第三方应用权限，或 Ryze Workspace Settings → Integrations。

工程上仍应认清：

• GA4 查询结果会流经 Ryze 托管 MCP，不等于「只在你本机与 Google 之间」。
• 同 endpoint 上的广告平台可能暴露 write 工具（厂商称审批门控）；连接后要在客户端确认实际列出的 tools，不要假设「接了 GA4 就只有只读」。
• 本次未做 OAuth 实连，无法核验 scope 文案、令牌存储位置或审批 UI 的真实行为。

何时不要用托管方案：

1. 组织要求分析数据不得进入第三方 SaaS。
2. 需要 Admin / Data API 写入或可审计的本机凭据链。
3. 需要在 CI / 本地 Agent 中可复现、无 Ryze 账户依赖的自动化。

定价（厂商页，Updated Sep 11, 2026）

计费模型：flat monthly fee，从不按广告花费百分比抽成（never % of ad spend）。以下为 定价页 与 AI Info 转述，可能随时变更；下单前以结账页为准。

• Billing discounts：按季 / 半年 / 年付分别约 5% / 10% / 20%。
• Money-back、cancel anytime、无长期合同（厂商声明）。
• 无免费 Autopilot 档：只有付费套餐；入门评估是 trial。定价页对 Paid Ads Autopilot 写明 7-day free trial，FAQ 亦称 free trial；部分博客偶见 “3-day $1” 说法——表述不一致时以 /pricing 为准。
• MCP connector：定价页写 “MCP connector … (included on every plan)”，工程上按 付费套餐内含 理解，不是独立永久免费产品档。GA MCP 产品页仍写 “Free to connect · SEO Autopilot $129/mo”——记为 厂商页面表述冲突；商业条款以 /pricing 为来源，并在结账 / 控制台核对 MCP 是否可在无付费订阅下使用（本文未 OAuth 实连核验）。
• 客户端侧另需 Claude / ChatGPT 等支持 connector 的付费计划（Free Claude 无 custom connectors 等）。

实用提问示例

报表

• 「最近 28 天按 default channel group 给出 sessions、engaged sessions 与 key events。」
• 「本月购买最多的落地页及 purchaseRevenue。」
• 「周一交通报告：总用户、Top 5 sources、key-event rate，以及相对上周变化。」

AI referrals

• 「本月来自 ChatGPT、Perplexity、Gemini 的流量与落地页。」
• 「按引擎对比本月与上月 AI-referral sessions。」
• 「最近 60 天每日 AI-referral sessions，输出可制表数据。」

配置检查

• 「列出该属性的 key events 及 counting method。」
• 「有哪些 custom dimensions，事件级还是用户级？」
• 「当前按国家与设备的 active users。」

更精确的 Data API body 可直接描述给助手，由 runRawReport / runRealtimeReport 执行；产品页也给出了 channel 对比、付费落地页与 realtime 的 JSON 示例。

关联阅读

• MCP 在聊天应用中的基本原理：Server、Tools 与调用流程：Host、Client、Server 与 Tool 调用流程。
• Context7 源码分析：技术架构、MCP 运行原理与检索链路：另一类「薄 MCP facade + 托管后端」的边界拆解，便于对照理解托管 MCP。

资料来源