MCP Server Guide

振幅MCP服务器

利用对话式人工智能分析您的产品数据、实验结果和用户行为，将Amplitude的全部功能直接融入您的AI工作流程中。

概述

Amplitude的MCP（模型上下文协议）服务器使团队能够通过与AI的自然语言对话来分析产品数据、实验和用户行为。无需离开您的AI环境，即可查询您的分析数据、仪表板、实验和功能标志。

\[!警告\] 🚧 Amplitude MCP 服务器正在积极开发中。在此期间，某些功能和设置可能无法使用，您可能会遇到错误或性能问题。此功能仍在不断演进，并且可能会受到速率限制。

特点/特性

• 分析查询询问有关用户行为、转化率和产品指标的问题
• 实验分析分析A/B测试结果和特性标志（或功能开关）的性能表现
• 仪表盘访问从现有图表和仪表板中检索数据
• 会话回放搜索查找并分析符合特定标准的用户会话
• 自然语言接口无需学习复杂的查询语法——只需提出问题即可

服务器端点

选择符合您组织数据驻留要求的服务器：

• 美国服务器（默认）： https://mcp.amplitude.com/mcp
• 欧盟服务器： https://mcp.eu.amplitude.com/mcp

设置

先决条件

• 访问Amplitude组织
• 一个与MCP兼容的AI客户端（如Claude、Cursor、ChatGPT等）
• 在Amplitude中设置适当的项目权限

认证

Amplitude MCP服务器采用OAuth 2.0认证，并尊重您在Amplitude中的现有权限。您只能访问通常可以在Amplitude中查看的数据和项目。

客户端配置

不同的AI客户端设置过程可能有所不同，但通常遵循以下步骤：

1. 添加MCP服务器 到您的AI客户端配置
2. 使用相应的服务器URL 针对您的地区
3. 完成OAuth认证 当被提示时
4. 开始查询 您的振幅数据

请查阅您AI客户端的文档，以获取特定的MCP服务器配置说明。

可用工具

Amplitude MCP 服务器提供以下工具用于分析您的数据：

核心分析

• search - 查找仪表板、图表、笔记本和实验
• query_chart - 从特定图表中提取数据
• query_experiment - 分析实验结果并评估统计显著性
• query_dataset - 执行自定义分析查询
• query_metric - 获取特定指标的数据

内容管理

• get_charts - 获取完整的图表定义
• get_dashboard - 访问仪表板内容和布局
• get_notebook - 获取包含图表和分析的笔记本内容
• get_experiments - 获取详细的实验信息
• get_flags - 获取功能标志配置

用户洞察

• get_session_replays - 搜索和筛选会话录制内容
• get_event_properties - 探索事件属性定义
• get_context - 访问用户和组织信息

示例查询

以下是一些您可以向Amplitude MCP服务器提出的问题示例：

用户行为分析

• “过去7天的日活跃用户数是多少？”
• “给我看看我们注册流程的转化漏斗”
• “哪些功能的互动率最高？”

实验分析

• “我们主页改版实验的结果如何？”
• “给我看看结账流程测试的统计显著性结果”
• “哪些实验变体表现最佳？”

产品洞察

• “本周按数量统计的顶级事件有哪些？”
• “展示按获取渠道划分的用户留存率”
• “不同流量来源的转化率有何差异？”

典型分析工作流程

1. 搜索 使用自然语言获取相关内容
2. 检索 图表定义及实验详情
3. 查询 带有自定义参数和过滤器的数据
4. 分析 结果，并通过后续问题深入探究

最佳实践

有效的提示

• 要具体说明 关于时间范围、用户群体和指标
• 提供背景信息 关于你试图理解的内容
• 简化复杂分析 分解成更小、更具体的问題
• 引用现有内容 在基于先前分析的基础上进行构建时

安全考量

• 数据访问权限受限于您当前的Amplitude权限
• 第三方AI模型在分析过程中处理您的数据
• 审查贵组织关于人工智能数据处理的政策
• 组织管理员可以控制对MCP服务器的访问

故障排除

常见问题

• 认证失败验证您的Amplitude帐户权限
• 未返回数据确认您有权访问所需的项目
• 连接错误确保您使用的是针对您所在地区的正确服务器URL
• 客户问题尝试重启您的AI客户端或重新配置MCP服务器

寻求帮助

• 从简单的查询开始以测试您的连接
• 在Amplitude网页界面中验证项目访问权限
• 请联系您的组织管理员了解MCP服务器权限

支持

对于Amplitude MCP服务器的技术支持和相关问题：

• 文档: Amplitude MCP 文档
• 反馈: 在MCP服务器上提交反馈
• 社区： 振幅社区
• 支持： 振幅支持

______________________________________________________________________

*Amplitude MCP服务器目前正处于测试阶段。我们将根据用户反馈持续改进其功能和性能。*