GA4 - Google Analytics MCP Server

GA4 - Google Analytics MCP服务器是什么？

GA4 - Google Analytics MCP服务器是一个独立的服务器，通过标准化的模型上下文协议提供Google Analytics 4的报告功能。它充当您GA4属性和任何MCP兼容AI工具之间的安全桥梁，实现快速分析查找、报告和通过预定义功能集成到AI工作流中。

如何配置

1. Google设置

   • 在您的Google Cloud项目中启用Google Analytics数据API。
   • 在“IAM与管理 > 服务账号”中创建服务账号，并生成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工具或大型语言模型代理可以通过MCP接口调用runReport、getPageViews、getActiveUsers、getEvents或getUserBehavior等功能。
   • 传递所需字段（例如，日期范围、维度、指标）作为函数参数。

3. 示例：查询页面浏览量

   • 使用getPageViews工具，提供日期范围和可选维度以获取页面浏览量指标。

4. 集成

   • 将服务器与任何支持MCP的AI客户端或自动化系统结合，实现动态分析访问。

主要特点

• 通过标准MCP功能调用访问实时GA4分析数据。
• 可定制的报告：选择特定指标、维度、过滤器和周期。
• 多个预定义工具：页面浏览量、用户指标、事件指标和行为分析。
• 安全的服务账号认证，所需权限最低。
• 易于安装和配置，适用于独立和集成使用（例如，在Claude Desktop中）。
• 旨在为未来的分析需求提供扩展性。

使用案例

• 将GA4指标直接集成到以AI驱动的仪表板、报告工具或助手工作流中。
• 使聊天机器人或AI代理能够回答有关网站/应用使用情况、流量趋势或用户参与度的问题。
• 自动生成分析摘要、用户分析或基于事件的报告。
• 实时监控活动表现和用户行为，从AI赋能的产品中查看。

常见问题

问1：服务账号需要什么GA4权限？
答：服务账号只需要对目标GA4属性的“查看者”访问权限，允许只读访问分析数据。

问2：我的私钥在操作期间安全么？
答：是的，您的私钥和凭据仅保存在服务器端环境变量中；永远不要将密钥暴露给客户端或公共存储库。

问3：我可以使用任何AI工具或工作流吗？
答：可以，只要工具支持MCP集成，您就可以连接服务器并访问分析功能。

问4：如果我的凭据无效或没有正确设置会发生什么？
答：服务器将无法通过Google Analytics进行身份验证，功能调用将返回指示凭据问题的错误；请确保您仔细遵循设置说明。

问5：是否可以扩展或自定义可用工具？
答：可以，该项目是开源的，您可以贡献或调整服务器以支持更多GA4查询或自定义报告逻辑。