---

name: posthog-automation description: "通过 Rube MCP (Composio) 自动化 PostHog 任务：事件、功能标志、项目、用户画像、注释。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 自动化 PostHog

通过 Composio 的 PostHog 工具包经由 Rube MCP 自动化 PostHog 产品分析和功能标志管理。

前置条件

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

设置

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

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

核心工作流

1. 捕获事件

使用场景：用户想要向 PostHog 发送事件数据进行分析追踪

工具序列：

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

关键参数：

• event：事件名称（如 '$pageview'、'user_signed_up'、'purchase_completed'）
• distinct_id：唯一用户标识符（必需）
• properties：包含事件特定属性的对象
• timestamp：ISO 8601 时间戳（可选；默认为服务器时间）

注意事项：

• 每个事件都需要 distinct_id；用于标识用户/设备
• PostHog 系统事件使用 $ 前缀（如 '$pageview'、'$identify'）
• 自定义事件不应使用 $ 前缀
• 属性是自由格式的；在事件间保持一致的 schema
• 事件异步处理；摄入延迟通常为几秒

2. 列出和过滤事件

使用场景：用户想要浏览或搜索已捕获的事件

工具序列：

1. POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS - 使用过滤器查询事件 [必需]

关键参数：

• project_id：PostHog 项目 ID（必需）
• event：按事件名称过滤
• person_id：按人员 ID 过滤
• after：此 ISO 8601 时间戳之后的事件
• before：此 ISO 8601 时间戳之前的事件
• limit：返回的最大事件数
• offset：分页偏移量

注意事项：

• project_id 是必需的；先通过 LIST_PROJECTS 解析
• 日期过滤器使用 ISO 8601 格式（如 '2024-01-15T00:00:00Z'）
• 大量事件需要分页；使用 offset 和 limit
• 结果默认按时间倒序返回
• 事件属性是嵌套的；需仔细解析

3. 管理功能标志

使用场景：用户想要创建、查看或管理功能标志

工具序列：

1. POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS - 列出现有功能标志 [必需]
2. POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS - 获取详细标志配置 [可选]
3. POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT - 创建新功能标志 [可选]

关键参数：

• 列出时：project_id（必需）
• 获取详情时：project_id、id（功能标志 ID）
• 创建时：
  • project_id：目标项目
  • key：标志键（如 'new-dashboard-beta'）
  • name：人类可读名称
  • filters：定向规则和灰度百分比
  • active：标志是否启用

注意事项：

• 功能标志 key 在项目内必须唯一
• 标志键应使用 kebab-case（如 'my-feature-flag'）
• filters 定义具有属性和灰度百分比的定向组
• 创建标志时设置 active: true 会立即对匹配用户启用
• 标志更改在几秒内生效，因为 PostHog 使用轮询机制

4. 管理项目

使用场景：用户想要列出或检查 PostHog 项目和组织

工具序列：

1. POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION - 列出所有项目 [必需]

关键参数：

• organization_id：组织标识符（根据认证方式可能是可选的）
• limit：每页结果数
• offset：分页偏移量

注意事项：

• 项目 ID 是数字类型；在大多数其他端点中用作参数
• 可能需要组织 ID；检查您的 PostHog 设置
• 分页基于偏移量；迭代直到结果为空
• 项目设置包含 API 密钥和配置详情

5. 用户画像和认证

使用场景：用户想要检查当前用户详情或验证 API 访问

工具序列：

1. POSTHOG_WHOAMI - 获取当前 API 用户信息 [可选]
2. POSTHOG_RETRIEVE_CURRENT_USER_PROFILE - 获取详细用户画像 [可选]

关键参数：

• 两个调用都不需要必需参数
• 返回当前认证用户的详情、权限和组织信息

注意事项：

• WHOAMI 是轻量级检查；用于验证连接
• 用户画像包含组织成员资格和权限详情
• 用于在执行操作前确认 API 访问级别

6. 管理注释

使用场景：用户想要在 PostHog 图表上创建或查看注释

工具序列：

1. POSTHOG_CREATE_ANNOTATION - 创建新注释 [必需]

关键参数：

• project_id：项目 ID
• content：注释文本
• date_marker：注释在图表上的日期位置
• scope：'project' 或 'organization'

注意事项：

• 注释出现在 PostHog 图表上的指定日期
• 用于标记部署、事件或重要变更
• 组织范围的注释对所有项目可见