trello-automation

通过 Rube MCP 自动化 Trello

通过 Composio 的 Rube MCP 集成，自动化 Trello 看板管理、卡片创建和团队工作流。

工具包文档：composio.dev/toolkits/trello

前提条件

• 必须已连接 Rube MCP（可用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Trello 连接，工具包为 trello
• 始终先调用 RUBE_SEARCH_TOOLS，获取最新的工具架构

设置

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

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 调用 RUBE_MANAGE_CONNECTIONS，工具包为 trello
3. 如果连接状态不是 ACTIVE，请访问返回的授权链接，完成 Trello 授权
4. 运行任何工作流前，确认连接状态显示为 ACTIVE

核心工作流

1. 在看板上创建卡片

适用场景：用户想在 Trello 看板上添加新卡片或任务

工具调用顺序：

1. TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER - 列出看板，以查找目标看板 ID [前置条件]
2. TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD - 获取看板上的列表，以查找目标列表 ID [前置条件]
3. TRELLO_ADD_CARDS - 在已确定的列表上创建卡片 [必需]
4. TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD - 为卡片添加清单 [可选]
5. TRELLO_ADD_CARDS_CHECKLIST_CHECK_ITEM_BY_ID_CARD_BY_ID_CHECKLIST - 为清单添加条目 [可选]

关键参数：

• idList：24 位十六进制 ID（不是列表名称）
• name：卡片标题
• desc：卡片描述（支持 Markdown）
• pos：位置（'top'/'bottom'）
• due：截止日期（ISO 8601 格式）

注意事项：

• 立即保存返回的 id（idCard）；没有它，后续清单操作将失败
• 清单负载可能是嵌套结构（data.data）；从内部对象中提取 idChecklist
• 每个清单条目都需要单独调用一次 API；清单较大时可能触发速率限制

2. 管理看板和列表

适用场景：用户想查看、浏览或调整看板布局

工具调用顺序：

1. TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER - 列出用户的所有看板 [必需]
2. TRELLO_GET_BOARDS_BY_ID_BOARD - 获取看板详细信息 [必需]
3. TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD - 获取看板上的列表（列）[可选]
4. TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD - 获取看板成员 [可选]
5. TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD - 获取看板上的标签 [可选]

关键参数：

• idMember：已通过身份验证的用户使用 'me'
• filter：'open'、'starred' 或 'all'
• idBoard：24 位十六进制 ID 或 8 位短链接（不是看板名称）

注意事项：

• 某些运行结果会将看板放在 response.data.details[] 中——不要假设它是顶层的扁平数组
• 列表可能嵌套在 results[0].response.data.details 中——应以稳健的方式解析
• 带有末尾 'Z' 的 ISO 8601 时间戳必须按时区感知型时间戳解析

3. 在列表之间移动卡片

适用场景：用户想通过将卡片移到其他列表来更改其状态

工具调用顺序：

1. TRELLO_GET_SEARCH - 按名称或关键词查找卡片 [前置条件]
2. TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD - 获取目标列表 ID [前置条件]
3. TRELLO_UPDATE_CARDS_BY_ID_CARD - 更新卡片的 idList，以移动卡片 [必需]

关键参数：

• idCard：搜索结果中的卡片 ID
• idList：目标列表 ID
• pos：新列表中的可选排序位置

注意事项：

• 搜索结果可能只有部分匹配；更新前请确认卡片名称
• 移动卡片不会更新其在新列表中的位置；如果排序很重要，请设置 pos

4. 将成员分配给卡片

适用场景：用户想将团队成员分配给卡片

工具调用顺序：

1. TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD - 获取看板中的成员 ID【前置条件】
2. TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD - 将成员添加到卡片【必需】

关键参数：

• idCard：目标卡片 ID
• value：要分配的成员 ID

注意事项：

• UPDATE_CARDS_ID_MEMBERS 会替换整个成员列表；使用 ADD_CARDS_ID_MEMBERS 追加成员
• 成员必须拥有看板权限

5. 搜索和筛选卡片

适用场景：用户想查找不同看板中的特定卡片

工具调用顺序：

1. TRELLO_GET_SEARCH - 根据查询字符串搜索【必需】

关键参数：

• query：搜索字符串（支持 board:、list:、label:、is:open/archived 运算符）
• modelTypes：设为 'cards'
• partial：设为 'true' 以进行前缀匹配

注意事项：

• 搜索索引存在延迟；新建的卡片可能需要几分钟才会显示
• 要精确匹配名称，请使用 TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD 并在本地筛选
• 查询会按词元进行分词；常见词可能会被忽略为停用词

6. 添加评论和附件

适用场景：用户想为现有卡片添加上下文信息

工具调用顺序：

1. TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD - 在卡片上发表评论【必需】
2. TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD - 附加文件或 URL【可选】

关键参数：

• text：评论文本（1-16384 个字符，支持 Markdown 和 @提及）
• url 或 file：附件来源（不能同时使用）
• name：附件显示名称
• mimeType：文件 MIME 类型

注意事项：

• 评论不支持文件附件；请单独使用附件工具
• 删除附件不可撤销

常见模式

ID 解析

执行操作前，始终先将显示名称解析为 ID：

• 看板名称 → 看板 ID：使用 TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER，并将 idMember='me'
• 列表名称 → 列表 ID：使用 TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD，并传入已解析的看板 ID
• 卡片名称 → 卡片 ID：使用 TRELLO_GET_SEARCH 和查询字符串
• 成员名称 → 成员 ID：使用 TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD

分页

大多数列表端点会返回所有项目。对于包含 1000 多张卡片的看板，请在卡片列表端点中使用 limit 和 before 参数。

速率限制

每个令牌每 10 秒最多 300 个请求。使用 TRELLO_GET_BATCH 执行批量读取操作，以免超出限制。

已知注意事项

• ID 要求：几乎所有工具都需要 ID，而不是显示名称。请始终先将名称解析为 ID。
• 看板 ID 格式：看板 ID 必须是 24 个字符的十六进制字符串或 8 个字符的 shortLink。像 'my-board' 这样的 URL slug 无效。
• 搜索延迟：搜索索引存在延迟；新建或更新的卡片可能不会立即显示。
• 嵌套响应：响应数据通常是嵌套的（data.data 或 data.details[]）；解析时请做好容错处理。
• 速率限制：每个令牌每 10 秒最多 300 个请求。使用 TRELLO_GET_BATCH 批量读取。

快速参考

任务	工具标识	关键参数
列出用户的看板	TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER	idMember='me', filter='open'
获取看板详情	TRELLO_GET_BOARDS_BY_ID_BOARD	idBoard（24 位十六进制）
列出看板列表	TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD	idBoard
创建卡片	TRELLO_ADD_CARDS	idList, name, desc, pos, due
更新卡片	TRELLO_UPDATE_CARDS_BY_ID_CARD	idCard, idList（用于移动）
搜索卡片	TRELLO_GET_SEARCH	query, modelTypes='cards'
添加检查清单	TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD	idCard, name
添加评论	TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD	idCard, text
分配成员	TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD	idCard, value（成员 ID）
附加文件/URL	TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD	idCard, url OR file
获取看板成员	TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD	idBoard
批量读取	TRELLO_GET_BATCH	urls（逗号分隔的路径）

---

由 Composio 提供支持