---

name: amplitude-automation description: "通过 Rube MCP（Composio）自动化 Amplitude 任务：事件、用户活动、群组、用户识别。始终先搜索工具获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 自动化 Amplitude

通过 Composio 的 Amplitude 工具包经由 Rube MCP 自动化产品分析。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit amplitude 建立活跃的 Amplitude 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥 -- 只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应来验证 Rube MCP 可用
2. 使用 toolkit amplitude 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Amplitude 认证
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 发送事件

适用场景：用户想要追踪事件或向 Amplitude 发送事件数据

工具序列：

1. AMPLITUDE_SEND_EVENTS - 向 Amplitude 发送一个或多个事件 [必需]

关键参数：

• events：事件对象数组，每个包含：
  • event_type：事件名称（例如 'page_view'、'purchase'）
  • user_id：唯一用户标识符（如果没有 device_id 则必需）
  • device_id：设备标识符（如果没有 user_id 则必需）
  • event_properties：自定义事件属性对象
  • user_properties：要设置的用户属性对象
  • time：事件时间戳（毫秒级 epoch）

注意事项：

• 每个事件至少需要 user_id 或 device_id 之一
• 每个事件都需要 event_type；不能为空
• time 必须是毫秒（13 位 epoch），不是秒
• 有批量限制；检查 schema 了解每次请求的最大事件数
• 事件异步处理；成功的 API 响应不意味着数据立即可查询

2. 获取用户活动

适用场景：用户想要查看特定用户的事件历史

工具序列：

1. AMPLITUDE_FIND_USER - 通过 ID 或属性查找用户 [前置条件]
2. AMPLITUDE_GET_USER_ACTIVITY - 获取用户的事件流 [必需]

关键参数：

• user：Amplitude 内部用户 ID（来自 FIND_USER）
• offset：事件列表的分页偏移量
• limit：返回的最大事件数

注意事项：

• user 参数需要 Amplitude 的内部用户 ID，不是你应用的 user_id
• 必须先调用 FIND_USER 将你的 user_id 解析为 Amplitude 的内部 ID
• 活动默认按时间倒序返回
• 大量活动历史需要通过 offset 分页

3. 查找和识别用户

适用场景：用户想要查找用户或设置用户属性

工具序列：

1. AMPLITUDE_FIND_USER - 通过各种标识符搜索用户 [必需]
2. AMPLITUDE_IDENTIFY - 设置或更新用户属性 [可选]

关键参数：

• FIND_USER：
  • user：搜索词（user_id、email 或 Amplitude ID）
• IDENTIFY：
  • user_id：你应用的用户标识符
  • device_id：设备标识符（user_id 的替代）
  • user_properties：包含 $set、$unset、$add、$append 操作的对象

注意事项：

• FIND_USER 跨 user_id、device_id 和 Amplitude ID 搜索
• IDENTIFY 使用特殊属性操作（$set、$unset、$add、$append）
• $set 覆盖现有值；$setOnce 仅在未设置时设置
• IDENTIFY 至少需要 user_id 或 device_id 之一
• 用户属性更改是最终一致的；不是即时的

4. 管理群组

适用场景：用户想要列出群组、查看群组详情或更新群组成员

工具序列：

1. AMPLITUDE_LIST_COHORTS - 列出所有已保存的群组 [必需]
2. AMPLITUDE_GET_COHORT - 获取详细群组信息 [可选]
3. AMPLITUDE_UPDATE_COHORT_MEMBERSHIP - 添加/移除群组用户 [可选]
4. AMPLITUDE_CHECK_COHORT_STATUS - 检查异步群组操作状态 [可选]

关键参数：

• LIST_COHORTS：无必需参数
• GET_COHORT：cohort_id（来自列表结果）
• UPDATE_COHORT_MEMBERSHIP：
  • cohort_id：目标群组 ID
  • memberships：包含 add 和/或 remove 用户 ID 数组的对象
• CHECK_COHORT_STATUS：来自更新响应的 request_id

注意事项：

• 所有群组特定操作都需要群组 ID
• UPDATE_COHORT_MEMBERSHIP 是异步的；使用 CHECK_COHORT_STATUS 验证
• 需要更新响应中的 request_id 来检查状态
• 每次请求的最大成员变更数可能有限制；大量更新需要分块
• 只有行为群组支持 API 成员更新

5. 浏览事件类别

适用场景：用户想要发现可用的事件类型