---

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 密钥——添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用
2. 使用工具包 segment 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 Segment 身份验证
4. 确认连接状态显示 ACTIVE 后再执行任何工作流

核心工作流

1. 追踪事件

使用场景：用户需要向 Segment 发送事件数据以供下游目标使用

工具调用顺序：

1. 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 中将特征与用户档案关联

工具调用顺序：

1. SEGMENT_IDENTIFY - 设置用户特征和身份 [必需]

关键参数：

• userId：用户标识符（无 anonymousId 时必填）
• anonymousId：匿名标识符
• traits：包含用户属性的对象（email、name、plan 等）
• timestamp：ISO 8601 时间戳
• context：上下文元数据

注意事项：

• userId 或 anonymousId 至少需要提供一个
• traits 与现有特征合并，而非替换
• 要移除某个特征，将其设为 null
• 对于新用户，应在 track 调用之前进行 identify 调用
• 除非目标已配置处理 PII，否则避免在 traits 中发送个人身份信息

3. 批量操作

使用场景：用户需要在单个请求中发送多个事件、identify 或其他调用

工具调用顺序：

1. SEGMENT_BATCH - 在一个请求中发送多个 Segment 调用 [必需]

关键参数：

• batch：消息对象数组，每个对象包含：
  • type：消息类型（'track'、'identify'、'group'、'page'、'alias'）
  • userId / anonymousId：用户标识符
  • 基于类型的附加字段（event、properties、traits 等）

注意事项：

• 批次中每条消息必须有有效的 type 字段
• 存在最大批次大小限制；查看 schema 获取当前限制
• 批次中所有消息独立处理；单条失败不影响其他消息
• 每条消息必须独立满足其类型的要求（如 track 需要事件名称）
• 批量是发送多个调用最高效的方式；优先使用而非逐个调用

4. 用户分组

使用场景：用户需要将某个用户与公司、团队或组织关联

工具调用顺序：

1. SEGMENT_GROUP - 将用户与群组关联 [必需]

关键参数：

• userId：用户标识符（无 anonymousId 时必填）
• anonymousId：匿名标识符
• groupId：群组/组织标识符（必填）
• traits：包含群组属性的对象（name、industry、size、plan）
• timestamp：ISO 8601 时间戳

注意事项：

• groupId 为必填项；用于标识公司或组织
• 群组特征与该群组的现有特征合并
• 一个用户可以属于多个群组
• 群组特征更新的是群组档案，而非用户档案

5. 追踪页面浏览

使用场景：用户需要在 Segment 中记录页面浏览事件

工具调用顺序：

1. SEGMENT_PAGE - 发送页面浏览事件 [必需]

关键参数：

• userId：用户标识符（无 anonymousId 时必填）
• anonymousId：匿名标识符
• name：页面名称（如 'Home'、'Pricing'、'Dashboard'）
• category：页面分类（如 'Docs'、'Marketing'）
• properties：包含页面特定属性的对象（url、title、referrer）

注意事项：

• userId 或 anonymousId 至少需要提供一个
• name 和 category 为可选项但建议提供以便更好地组织数据
• properties 中的 url 和 title 如未提供会自动采集
• 页面调用通常在页面加载时触发