用途:通过 Rube MCP 调用 Composio 的 Segment 工具包,自动化 Segment 客户数据平台操作,包括事件追踪、用户识别、群组管理、页面浏览、身份别名和批量请求。工具包文档见 composio.dev/toolkits/segment。
前提条件:需连接 Rube MCP(确保 RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit segment 建立活动连接。设置时在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器,无需 API 密钥,确认 RUBE_SEARCH_TOOLS 响应后,调用 RUBE_MANAGE_CONNECTIONS 并完成 Segment 认证,连接状态为 ACTIVE 后再执行工作流。始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
主要能力与用法:
- SEGMENT_TRACK:发送单个追踪事件,参数含 userId 或 anonymousId、event、properties、timestamp、context。userId 与 anonymousId 至少提供其一,event 名称须遵循一致命名规范,properties 为自由对象但建议 schema 一致,timestamp 须为 ISO 8601 格式。事件异步处理,成功响应仅表示已接受,不代表已投递。
- SEGMENT_IDENTIFY:设置用户 traits 和身份。traits 与已有 traits 合并而非替换,设为 null 可移除;新用户应先 identify 再 track;除非目标端已配置,否则避免发送 PII。
- SEGMENT_BATCH:单次请求发送多条调用,batch 为消息对象数组,每条含 type(track、identify、group、page、alias)及标识。每条消息独立处理,一条失败不影响其他;须各自满足类型要求;批量是高效发送多条调用的首选方式。
- SEGMENT_GROUP:关联用户与公司、团队或组织,groupId 必填,traits 合并到群组资料而非用户资料,一个用户可属于多个群组。
- SEGMENT_PAGE:记录页面浏览,name 和 category 可选但建议提供,标准属性包括 url、title、referrer、path、search。
- SEGMENT_ALIAS:合并匿名与已识别用户,userId 为新标识,previousId 为旧匿名标识;该操作单向不可撤销,通常仅在用户首次识别(如注册)时调用一次,并非所有目标端支持。
- SEGMENT_LIST_SCHEMA_SETTINGS_IN_SOURCE 查看源 schema 设置;SEGMENT_UPDATE_SOURCE 更新源配置(可能影响数据收集,须谨慎);SEGMENT_LIST_CONNECTED_WAREHOUSES_FROM_SOURCE 列出已连接仓库。
常见模式:用户生命周期为匿名访问 PAGE、交互 TRACK、注册时 ALIAS 后 IDENTIFY、后续 TRACK、加入组织时 GROUP。批量优化是先收集消息数组再调用 SEGMENT_BATCH。命名建议:事件用“对象 动作”格式,属性与 traits 用 snake_case。
已知限制:每次调用须包含 userId 或 anonymousId;ALIAS 每次身份合并只用一次;identify 应先于 track;事件名称需跨源一致;除非目标端配置,避免敏感 PII;批量限制须查看当前 schema;成功响应仅表示接受而非投递,需检查批量响应中的单条错误;时间戳须为带时区的 ISO 8601 格式。