---

name: miro-automation description: "通过 Rube MCP (Composio) 自动化 Miro 任务：看板、元素、便签、框架、共享、连接器。始终先搜索工具以获取当前架构。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Miro 自动化

通过 Composio 的 Miro 工具包经由 Rube MCP 自动化 Miro 白板操作。

前置条件

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

设置

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

1. 通过确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用工具包 miro 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接未处于 ACTIVE 状态，按照返回的认证链接完成 Miro OAuth
4. 在运行任何工作流之前确认连接状态显示为 ACTIVE

核心工作流

1. 列出和浏览看板

使用场景：用户想要查找看板或获取看板详情

工具调用顺序：

1. MIRO_GET_BOARDS2 - 列出所有可访问的看板 [必需]
2. MIRO_GET_BOARD - 获取特定看板的详细信息 [可选]

关键参数：

• query：按名称筛选看板的搜索词
• sort：按 'default'、'last_modified'、'last_opened'、'last_created'、'alphabetically' 排序
• limit：每页结果数量（最多 50）
• offset：分页偏移量
• board_id：用于详细检索的特定看板 ID

注意事项：

• 分页使用基于偏移量的方式，而非基于游标
• 每页最多 50 个看板；使用偏移量迭代获取完整列表
• 看板 ID 是长字母数字字符串；始终先通过搜索解析

2. 创建看板和元素

使用场景：用户想要创建新看板或向现有看板添加元素

工具调用顺序：

1. MIRO_CREATE_BOARD - 创建新的空白看板 [可选]
2. MIRO_CREATE_STICKY_NOTE_ITEM - 向看板添加便签 [可选]
3. MIRO_CREATE_FRAME_ITEM2 - 添加框架以组织内容 [可选]
4. MIRO_CREATE_ITEMS_IN_BULK - 批量添加多个元素 [可选]

关键参数：

• name / description：看板名称和描述（用于 CREATE_BOARD）
• board_id：目标看板 ID（所有元素创建操作必需）
• data：包含 content 字段的内容对象，用于便签文本
• style：包含 fillColor 的样式对象，用于便签颜色
• position：包含 x 和 y 坐标的对象
• geometry：包含 width 和 height 的对象

注意事项：

• 所有元素操作都需要 board_id；先通过 GET_BOARDS2 解析
• 便签颜色使用十六进制代码（如 '#FF0000'）在 fillColor 字段中
• 位置坐标使用看板坐标系（原点在中心）
• 批量创建有每次请求的最大元素数限制；检查当前架构
• 框架元素需要包含宽度和高度的 geometry

3. 浏览和管理看板元素

使用场景：用户想要查看、查找或组织看板上的元素

工具调用顺序：

1. MIRO_GET_BOARD_ITEMS - 列出看板上的所有元素 [必需]
2. MIRO_GET_CONNECTORS2 - 列出元素之间的连接 [可选]

关键参数：

• board_id：目标看板 ID（必需）
• type：按元素类型筛选（'sticky_note'、'shape'、'text'、'frame'、'image'、'card'）
• limit：每页元素数量
• cursor：上一次响应的分页游标

注意事项：

• 结果是分页的；跟随 cursor 直到不存在以获取完整元素列表
• 元素类型必须精确匹配 Miro 预定义的类型
• 大型看板可能有数千个元素；使用类型筛选缩小结果
• 连接器与元素是分开的；使用 GET_CONNECTORS2 获取关系数据

4. 共享和协作看板

使用场景：用户想要与团队成员共享看板或管理访问权限

工具调用顺序：

1. MIRO_GET_BOARDS2 - 查找要共享的看板 [前置条件]
2. MIRO_SHARE_BOARD - 与用户共享看板 [必需]
3. MIRO_GET_BOARD_MEMBERS - 验证当前看板成员 [可选]

关键参数：

• board_id：要共享的看板（必需）
• emails：要邀请的电子邮件地址数组
• role：访问级别（'viewer'、'commenter'、'editor'）
• message：可选的邀请消息

注意事项：

• 电子邮件地址必须有效；无效邮件会导致整个请求失败
• 角色必须是预定义值之一；区分大小写
• 与组织外用户共享可能需要管理员批准
• GET_BOARD_MEMBERS 返回所有成员，包括所有者

5. 创建视觉连接

使用场景：用户想要用线条或箭头连接看板上的元素

工具调用顺序：

1. MIRO_GET_BOARD_ITEMS - 查找要连接的元素 [前置条件]
2. MIRO_GET_CONNECTORS2 - 查看现有连接 [可选]

关键参数：

• board_id：目标看板 ID
• startItem：包含源元素 id 的对象