---

name: convertkit-automation description: "通过 Rube MCP (Composio) 自动化 ConvertKit (Kit) 任务：管理订阅者、标签、广播和广播统计。始终先搜索工具以获取当前模式。" risk: critical source: community date_added: "2026-02-27"

ConvertKit (Kit) 通过 Rube MCP 自动化

通过 Composio 的 Kit 工具包经由 Rube MCP 自动化 ConvertKit（现称为 Kit）邮件营销操作。

前提条件

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

设置

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

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

核心工作流

1. 列出和搜索订阅者

何时使用：用户想要浏览、搜索或筛选邮件订阅者

工具序列：

1. KIT_LIST_SUBSCRIBERS - 使用过滤器和分页列出订阅者 [必需]

关键参数：

• status：按状态筛选（'active' 或 'inactive'）
• email_address：精确搜索的邮箱地址
• created_after/created_before：日期范围筛选（YYYY-MM-DD）
• updated_after/updated_before：日期范围筛选（YYYY-MM-DD）
• sort_field：按 'id'、'cancelled_at' 或 'updated_at' 排序
• sort_order：'asc' 或 'desc'
• per_page：每页结果数（最小 1）
• after/before：分页游标字符串
• include_total_count：设为 'true' 获取总订阅者数

注意事项：

• 如果 sort_field 为 'cancelled_at'，status 必须设为 'cancelled'
• 日期筛选使用 YYYY-MM-DD 格式（无时间部分）
• email_address 为精确匹配；不支持部分邮箱搜索
• 分页使用基于游标的方式，通过 after/before 游标字符串
• include_total_count 是字符串 'true'，不是布尔值

2. 管理订阅者标签

何时使用：用户想要为订阅者添加标签以进行分组

工具序列：

1. KIT_LIST_SUBSCRIBERS - 通过邮箱查找订阅者 ID [前置步骤]
2. KIT_TAG_SUBSCRIBER - 将订阅者与标签关联 [必需]
3. KIT_LIST_TAG_SUBSCRIBERS - 列出特定标签下的订阅者 [可选]

标签关键参数：

• tag_id：数字标签 ID（必填）
• subscriber_id：数字订阅者 ID（必填）

注意事项：

• tag_id 和 subscriber_id 必须为正整数
• 标签 ID 必须引用已存在的标签；标签通过 Kit 网页界面创建
• 对已标记的订阅者重复标记是幂等操作（不会报错）
• 订阅者 ID 从 LIST_SUBSCRIBERS 返回；使用 email_address 筛选查找特定订阅者

3. 取消订阅

何时使用：用户想要取消某个订阅者的所有通信

工具序列：

1. KIT_LIST_SUBSCRIBERS - 查找订阅者 ID [前置步骤]
2. KIT_DELETE_SUBSCRIBER - 取消订阅该订阅者 [必需]

关键参数：

• id：订阅者 ID（必填，正整数）

注意事项：

• 此操作将永久取消订阅者的所有邮件通信
• 订阅者的历史数据会保留，但不再接收邮件
• 操作是幂等的；对已取消订阅的用户再次取消不会报错
• 成功时返回空响应（HTTP 204 No Content）
• 订阅者 ID 必须存在；不存在的 ID 返回 404

4. 列出和查看广播

何时使用：用户想要浏览邮件广播或获取特定广播的详情

工具序列：

1. KIT_LIST_BROADCASTS - 使用分页列出所有广播 [必需]
2. KIT_GET_BROADCAST - 获取特定广播的详细信息 [可选]
3. KIT_GET_BROADCAST_STATS - 获取广播的性能统计 [可选]

列表关键参数：

• per_page：每页结果数（1-500）
• after/before：分页游标字符串
• include_total_count：设为 'true' 获取总数

详情关键参数：

• id：广播 ID（必填，正整数）

注意事项：

• per_page 广播最大值为 500
• 广播统计仅对已发送的广播可用
• 草稿广播没有统计数据
• 广播 ID 为数字整数

5. 删除广播

何时使用：用户想要永久删除一个广播

工具序列：

1. KIT_LIST_BROADCASTS - 查找要删除的广播 [前置步骤]
2. KIT_GET_BROADCAST - 验证是否为正确的广播 [可选]
3. KIT_DELETE_BROADCAST - 永久删除广播 [必需]

关键参数：

• id：广播 ID（必填）

注意事项：

• 删除是永久性的，无法撤销
• 删除已发送的广播不会撤回已送达的邮件
• 成功时返回空响应（HTTP 204 No Content）
• 广播 ID 必须存在；不存在的 ID 返回 404

重要提示

• 始终先调用 RUBE_SEARCH_TOOLS 获取最新的工具模式和参数
• 工具模式可能随时更新；不要依赖缓存的参数信息
• 所有 ID 参数均为正整数
• 分页使用基于游标的方式，不是基于偏移量的
• 日期格式统一为 YYYY-MM-DD
• 删除操作不可逆，执行前务必确认