
关于
通过 Rube MCP(Composio)自动化 Segment 任务:追踪事件、识别用户、管理群组、页面浏览、别名、批量操作。始终先搜索工具,再执行操作。
name: segment-automation description: "通过 Rube MCP (Composio) 自动化 Segment 任务:追踪事件、识别用户、管理群组、页面浏览、别名、批量操作。操作前务必先搜索工具获取最新 schema。" risk: critical source: community date_added: "2026-02-27"
通过 Rube MCP 自动化 Segment 操作
通过 Composio 的 Segment 工具包,借助 Rube MCP 自动化 Segment 客户数据平台操作。
前置条件
- Rube MCP 必须已连接(
RUBE_SEARCH_TOOLS可用) - 通过
RUBE_MANAGE_CONNECTIONS建立活跃的 Segment 连接,工具包为segment - 操作前务必先调用
RUBE_SEARCH_TOOLS获取当前工具 schema
设置步骤
获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——添加端点即可使用。
- 确认
RUBE_SEARCH_TOOLS有响应,验证 Rube MCP 可用 - 使用工具包
segment调用RUBE_MANAGE_CONNECTIONS - 如果连接状态不是 ACTIVE,按照返回的认证链接完成 Segment 身份验证
- 确认连接状态显示 ACTIVE 后再执行任何工作流
核心工作流
1. 追踪事件
使用场景:用户需要向 Segment 发送事件数据以供下游目标使用
工具调用顺序:
SEGMENT_TRACK- 发送单个追踪事件 [必需]
关键参数:
userId:用户标识符(无anonymousId时必填)anonymousId:匿名标识符(无userId时必填)event:事件名称(如 'Order Completed'、'Button Clicked')properties:包含事件特定属性的对象timestamp:ISO 8601 时间戳(可选;默认为服务器时间)context:包含上下文元数据的对象(IP、用户代理等)
注意事项:
userId或anonymousId至少需要提供一个event名称为必填项,应遵循一致的命名规范- properties 为自由格式对象;确保跨事件的 schema 一致性
- 时间戳必须为 ISO 8601 格式(如 '2024-01-15T10:30:00Z')
- 事件异步处理;API 成功响应表示已接受,不代表已投递
2. 识别用户
使用场景:用户需要在 Segment 中将特征与用户档案关联
工具调用顺序:
SEGMENT_IDENTIFY- 设置用户特征和身份 [必需]
关键参数:
userId:用户标识符(无anonymousId时必填)anonymousId:匿名标识符traits:包含用户属性的对象(email、name、plan 等)timestamp:ISO 8601 时间戳context:上下文元数据
注意事项:
userId或anonymousId至少需要提供一个- traits 与现有特征合并,而非替换
- 要移除某个特征,将其设为
null - 对于新用户,应在 track 调用之前进行 identify 调用
- 除非目标已配置处理 PII,否则避免在 traits 中发送个人身份信息
3. 批量操作
使用场景:用户需要在单个请求中发送多个事件、identify 或其他调用
工具调用顺序:
SEGMENT_BATCH- 在一个请求中发送多个 Segment 调用 [必需]
关键参数:
batch:消息对象数组,每个对象包含:type:消息类型('track'、'identify'、'group'、'page'、'alias')userId/anonymousId:用户标识符- 基于类型的附加字段(event、properties、traits 等)
注意事项:
- 批次中每条消息必须有有效的
type字段 - 存在最大批次大小限制;查看 schema 获取当前限制
- 批次中所有消息独立处理;单条失败不影响其他消息
- 每条消息必须独立满足其类型的要求(如 track 需要事件名称)
- 批量是发送多个调用最高效的方式;优先使用而非逐个调用
4. 用户分组
使用场景:用户需要将某个用户与公司、团队或组织关联
工具调用顺序:
SEGMENT_GROUP- 将用户与群组关联 [必需]
关键参数:
userId:用户标识符(无anonymousId时必填)anonymousId:匿名标识符groupId:群组/组织标识符(必填)traits:包含群组属性的对象(name、industry、size、plan)timestamp:ISO 8601 时间戳
注意事项:
groupId为必填项;用于标识公司或组织- 群组特征与该群组的现有特征合并
- 一个用户可以属于多个群组
- 群组特征更新的是群组档案,而非用户档案
5. 追踪页面浏览
使用场景:用户需要在 Segment 中记录页面浏览事件
工具调用顺序:
SEGMENT_PAGE- 发送页面浏览事件 [必需]
关键参数:
userId:用户标识符(无anonymousId时必填)anonymousId:匿名标识符name:页面名称(如 'Home'、'Pricing'、'Dashboard')category:页面分类(如 'Docs'、'Marketing')properties:包含页面特定属性的对象(url、title、referrer)
注意事项:
userId或anonymousId至少需要提供一个name和category为可选项但建议提供以便更好地组织数据- properties 中的 url 和 title 如未提供会自动采集
- 页面调用通常在页面加载时触发
兼容工具
Claude CodeCursor
标签
后端开发
