name: trello-automation description: 通过Rube MCP(Composio)自动化Trello板、卡片和工作流。程序化创建卡片、管理列表、分配成员和跨板搜索。 requires: mcp: [rube] category: project-management
通过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密钥——只需添加端点即可工作。
- 通过确认
RUBE_SEARCH_TOOLS响应来验证Rube MCP可用 - 使用工具包
trello调用RUBE_MANAGE_CONNECTIONS - 如果连接未处于ACTIVE状态,请遵循返回的认证链接完成Trello认证
- 在运行任何工作流前确认连接状态显示为ACTIVE
核心工作流
1. 在板上创建卡片
使用时机: 用户希望向Trello板添加新卡片/任务
工具序列:
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER- 列出板以找到目标板ID [前提]TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD- 获取板上的列表以找到目标列表ID [前提]TRELLO_ADD_CARDS- 在解析的列表上创建卡片 [必需]TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD- 向卡片添加检查清单 [可选]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. 管理板和列表
使用时机: 用户希望查看、浏览或重新结构板布局
工具序列:
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER- 列出用户的所有板 [必需]TRELLO_GET_BOARDS_BY_ID_BOARD- 获取详细板信息 [必需]TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD- 获取板上的列表(列) [可选]TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD- 获取板成员 [可选]TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD- 获取板上的标签 [可选]
关键参数:
idMember: 使用’me’表示认证用户filter: ‘open’, ‘starred’或’all’idBoard: 24字符十六进制或8字符shortLink(非板名称)
常见陷阱:
- 某些运行在response.data.details[]下返回板——不要假设为平面顶层数组
- 列表可能嵌套在results[0].response.data.details下——防御性解析
- 带尾随’Z’的ISO 8601时间戳必须解析为时区感知
3. 在列表间移动卡片
使用时机: 用户希望通过将卡片移至另一列表来更改其状态
工具序列:
TRELLO_GET_SEARCH- 按名称或关键词查找卡片 [前提]TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD- 获取目标列表ID [前提]TRELLO_UPDATE_CARDS_BY_ID_CARD- 更新卡片的idList以移动它 [必需]
关键参数:
idCard: 搜索得到的卡片IDidList: 目标列表IDpos: 在新列表中的可选排序
常见陷阱:
- 搜索返回部分匹配;更新前验证卡片名称
- 移动不更新新列表中的位置;如果顺序重要,请设置pos
4. 向卡片分配成员
使用时机: 用户希望向卡片分配团队成员
工具序列:
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD- 从板获取成员ID [前提]TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD- 向卡片添加成员 [必需]
关键参数:
idCard: 目标卡片IDvalue: 要分配的成员ID
常见陷阱:
- UPDATE_CARDS_ID_MEMBERS替换整个成员列表;使用ADD_CARDS_ID_MEMBERS追加
- 成员必须具有板权限
5. 搜索和过滤卡片
使用时机: 用户希望跨板查找特定卡片
工具序列:
TRELLO_GET_SEARCH- 按查询字符串搜索 [必需]
关键参数:
query: 搜索字符串(支持board:, list:, label:, is:open/archived操作符)modelTypes: 设置为’cards’partial: 设置为’true’进行前缀匹配
常见陷阱:
- 搜索索引有延迟;新创建的卡片可能几分钟后才出现
- 对于精确名称匹配,使用TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD并在本地过滤
- 查询使用词元化;常见词可能被忽略为停用词
6. 添加评论和附件
使用时机: 用户希望向现有卡片添加上下文
工具序列:
TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD- 在卡片上发布评论 [必需]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。URL slug如’my-board’无效。
- 搜索延迟: 搜索索引有延迟;新创建/更新的卡片可能不会立即出现。
- 嵌套响应: 响应数据通常是嵌套的(data.data或data.details[]);防御性解析。
- 速率限制: 每个令牌300请求/10秒。使用TRELLO_GET_BATCH进行批量读取。
快速参考
| 任务 | 工具Slug | 关键参数 |
|---|---|---|
| 列出用户的板 | 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 或 file |
| 获取板成员 | TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD | idBoard |
| 批量读取 | TRELLO_GET_BATCH | urls(逗号分隔的路径) |
由Composio提供支持