用途:通过 Rube MCP 调用 Composio 的 Amplitude 工具包,自动化 Amplitude 产品分析中的事件、用户活动、用户识别与分群操作。
前提与设置:需已连接 Rube MCP(RUBE_SEARCH_TOOLS 可用);在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API key;确认 RUBE_SEARCH_TOOLS 响应后,调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit amplitude,若连接非 ACTIVE,按返回的授权链接完成 Amplitude 认证;连接状态为 ACTIVE 后方可运行。每次执行前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。工具包文档:composio.dev/toolkits/amplitude。
主要能力与用法: 发送事件:AMPLITUDE_SEND_EVENTS,events 为对象数组,每项含 event_type、user_id 或 device_id、event_properties、user_properties、time。user_id 与 device_id 至少其一,event_type 不可为空,time 须为毫秒级 13 位时间戳。事件异步处理,成功响应不代表数据立即可查。 用户活动:先 AMPLITUDE_FIND_USER 解析用户,再 AMPLITUDE_GET_USER_ACTIVITY,参数 user 为 Amplitude 内部 ID,非应用 user_id,支持 offset、limit 分页,默认倒序。 用户识别:AMPLITUDE_FIND_USER 按 user_id、email 或 Amplitude ID 搜索;AMPLITUDE_IDENTIFY 支持 $set、$setOnce、$add、$append、$unset 属性操作,user_id 与 device_id 至少其一,属性变更为最终一致。 分群:AMPLITUDE_LIST_COHORTS 列出已保存分群;AMPLITUDE_GET_COHORT 用 cohort_id 查看详情;AMPLITUDE_UPDATE_COHORT_MEMBERSHIP 用 cohort_id 与 memberships 的 add/remove 数组增删成员,操作为异步,需用 AMPLITUDE_CHECK_COHORT_STATUS 凭 request_id 轮询状态至 complete 或 error;仅行为分群支持 API 成员更新,大批量更新需分块。 事件分类:AMPLITUDE_GET_EVENT_CATEGORIES 无参数列出事件分类,可用于校验 event_type,名称区分大小写。
限制:时间戳单位错误会误判为极旧日期;事件摄取、分群更新有速率与批量限制;响应数据可能嵌套于 data 键,可选字段需容错解析;分群列表可能含已归档项,需检查状态字段。