QuerySail: Google Analytics

QuerySail：Google Analytics MCP 服务

QuerySail 是面向 Google Analytics 4 的托管只读 MCP 服务。将它连接到 ChatGPT、Claude、Codex、Cursor 或 VS Code，登录并连接一次 Google 账号，即可用日常语言询问流量、互动和转化情况。无需安装任何东西，无需 Google Cloud 项目，也无需粘贴 API 密钥。

• 端点： https://mcp.querysail.com/ga4/mcp（Streamable HTTP，支持动态客户端注册的 OAuth 2.1）
• 网站： https://querysail.com/google-analytics
• 定价： 包含在与 QuerySail for Google Search Console 相同的套餐中。免费试用 7 天，无需信用卡，之后每月 $8。请参阅 https://querysail.com/pricing。

此仓库包含公开目录所需的文件（MCP Registry server.json、Claude Code 插件、客户端配置）。服务本身托管于 querysail.com；其源代码未在此发布。

工具

所有工具均为只读。QuerySail 无法创建或编辑媒体资源、数据流、关键事件、受众群体或任何其他 Google Analytics 设置。

工具	功能
list_properties	列出已连接的 Google 账号可读取的 Google Analytics 4 媒体资源，并提供准确的媒体资源 ID 及其 Analytics 账号。
list_fields	列出媒体资源可报告的维度和指标，包括自定义维度、自定义指标和关键事件。
run_report	按日期、渠道、来源/媒介、着陆页、页面、国家/地区、设备、事件等细分用户数、会话数、浏览量、互动、事件、关键事件、收入以及任何其他 Data API 指标，并支持筛选。
compare_report	比较两个时间段（上一时间段、一年前相同星期几或自定义日期），并列出增长或下降最多的渠道、来源、页面或国家/地区。
run_realtime_report	按国家/地区、城市、设备、页面或事件统计过去 30 分钟内的活跃用户、浏览量和事件。

示例提示词

• 过去 28 天，我的网站有多少用户和会话？
• 上个月哪些渠道带来了最多会话？与前一个月相比有何变化？
• 按关键事件统计，哪些着陆页排名最高？
• 现在有多少人在网站上？他们来自哪些国家/地区？
• 比较自然搜索会话数与去年相同几周的数据。

设置

你需要拥有 QuerySail 账号并连接 Google Analytics：请前往 https://querysail.com 注册，然后在 Account → Connections 下选择 Connect Google Analytics。以下每种客户端都会在首次使用时打开浏览器窗口供你登录。

Claude Code

claude mcp add --transport http --scope user querysail-ga4 https://mcp.querysail.com/ga4/mcp

然后运行 /mcp，选择 querysail-ga4 并登录。也可以将它安装为插件，这还会添加一项 Google Analytics 分析技能：

/plugin marketplace add querysail/querysail-ga4
/plugin install querysail-ga4@querysail-ga4

Claude Desktop 和 claude.ai

打开 Customize → Connectors，选择 + Add → Add custom connector，将其命名为 QuerySail GA4，并将 https://mcp.querysail.com/ga4/mcp 粘贴为服务 URL。

ChatGPT

在 Settings → Security and login 下启用 Developer mode，前往 chatgpt.com/plugins，选择加号按钮，并将端点粘贴为连接 URL。

Codex

codex mcp add querysail-ga4 --url https://mcp.querysail.com/ga4/mcp
codex mcp login querysail-ga4

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "querysail-ga4": { "url": "https://mcp.querysail.com/ga4/mcp" }
  }
}

VS Code

运行 MCP: Add Server，选择 HTTP 并粘贴端点，或添加到 mcp.json：

{
  "servers": {
    "querysail-ga4": { "type": "http", "url": "https://mcp.querysail.com/ga4/mcp" }
  }
}

仅运行本地命令的客户端

使用 mcp-remote 桥接程序（需要 Node.js）：

{
  "mcpServers": {
    "querysail-ga4": { "command": "npx", "args": ["mcp-remote", "https://mcp.querysail.com/ga4/mcp"] }
  }
}

数据与限制

• Google 访问使用 analytics.readonly 范围，该范围与 Search Console 分开授权。刷新令牌会加密存储。你可以随时隐藏媒体资源、断开 Google 连接或删除账户。
• 收到请求时，系统会从 Google 获取报告，并将其缓存最多 15 分钟；实时报告不会缓存。不支持 Universal Analytics 媒体资源。
• Google 可能会对部分报告应用阈值限制或抽样；QuerySail 会将这些标记传递给你的助手。Google 针对每个媒体资源设置的 API 配额同样适用。
• 隐私：https://querysail.com/privacy · 条款：https://querysail.com/terms · 支持：https://querysail.com/support

许可证

此仓库中的文件采用 MIT 许可证。QuerySail 服务受其条款约束。