SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场miro-automation

miro-automation

办公与效率

查看项目

更新于 10-15 08:01

技能介绍

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

用途 该技能用于以自动化方式完成 Miro 白板上的常见任务，包括查找和浏览白板、创建白板与元素、查看和管理白板内容、分享协作以及创建视觉连接。

前置条件

  • 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
  • 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Miro 连接，工具包为 miro。
  • 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

设置方式

  1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，工具包为 miro。
  4. 若连接不是 ACTIVE，按返回的授权链接完成 Miro OAuth。
  5. 确认连接状态为 ACTIVE 后再运行任何工作流。

核心工作流

  1. 列出和浏览白板 适用场景：用户想查找白板或获取白板详情。 工具顺序：MIRO_GET_BOARDS2（列出所有可访问白板，必需）；MIRO_GET_BOARD（获取特定白板详情，可选）。 关键参数：query（按名称过滤白板的搜索词）、sort（排序方式：default、last_modified、last_opened、last_created、alphabetically）、limit（每页结果数，最大 50）、offset（分页偏移）、board_id（用于详细检索的特定白板 ID）。 注意事项：分页基于 offset 而非 cursor；每页最多 50 个白板，需用 offset 迭代获取完整列表；白板 ID 是长字母数字字符串，应先用搜索解析。

  2. 创建白板和元素 适用场景：用户想创建新白板或向现有白板添加元素。 工具顺序：MIRO_CREATE_BOARD（创建新的空白白板，可选）；MIRO_CREATE_STICKY_NOTE_ITEM（添加便签，可选）；MIRO_CREATE_FRAME_ITEM2（添加框架以组织内容，可选）；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 解析；便签颜色在 fillColor 字段使用十六进制代码（如 '#FF0000'）；位置坐标使用白板坐标系（原点在中心）；批量创建有每请求最大元素数限制，需查看当前 schema；框架元素需要同时包含 width 和 height 的 geometry。

  3. 浏览和管理白板元素 适用场景：用户想查看、查找或整理白板上的元素。 工具顺序：MIRO_GET_BOARD_ITEMS（列出白板上所有元素，必需）；MIRO_GET_CONNECTORS2（列出元素之间的连接，可选）。 关键参数：board_id（目标白板 ID，必需）；type（按元素类型过滤：sticky_note、shape、text、frame、image、card）；limit（每页元素数）；cursor（上一响应中的分页游标）。 注意事项：结果分页，需跟随 cursor 直到不存在以获得完整元素列表；元素类型必须与 Miro 预定义类型完全匹配；大型白板可能有数千个元素，使用类型过滤缩小结果；连接器与元素分开，关系数据使用 GET_CONNECTORS2。

  4. 分享和协作白板 适用场景：用户想与团队成员分享白板或管理访问权限。 工具顺序：MIRO_GET_BOARDS2（找到要分享的白板，前置）；MIRO_SHARE_BOARD（与用户分享白板，必需）；MIRO_GET_BOARD_MEMBERS（验证当前白板成员，可选）。 关键参数：board_id（要分享的白板，必需）；emails（要邀请的电子邮件地址数组）；role（访问级别：viewer、commenter、editor）；message（可选邀请消息）。 注意事项：电子邮件地址必须有效，无效邮件会导致整个请求失败；角色必须是预定义值之一，区分大小写；与组织外用户分享可能需要管理员批准；GET_BOARD_MEMBERS 返回包括所有者在内的所有成员。

  5. 创建视觉连接 适用场景：用户想用线或箭头连接白板上的元素。 工具顺序：MIRO_GET_BOARD_ITEMS（找到要连接的元素，前置）；MIRO_GET_CONNECTORS2（查看现有连接，可选）。 关键参数：board_id（目标白板 ID）；startItem（含源元素 id 的对象）；endItem（含目标元素 id 的对象）；style（连接器样式：线型、颜色、箭头）。 注意事项：起始和结束元素必须存在于同一白板；连接需要元素 ID，先通过 GET_BOARD_ITEMS 解析；连接器样式多样，需查看 schema 中的可用选项；不允许自引用连接（起始和结束相同）。

常见模式 ID 解析：白板名称到白板 ID：调用 MIRO_GET_BOARDS2 并设置 query=board_name，在结果中按名称找到白板，提取 id 字段。白板上的元素查找：调用 MIRO_GET_BOARD_ITEMS 并传入 board_id 和可选 type 过滤，按内容或位置找到元素，提取元素 id 用于后续操作。 分页：白板使用 offset 和 limit（基于 offset）；白板元素使用 cursor 和 limit（基于 cursor）；持续直到无更多结果或 cursor 不存在；默认页大小因端点而异。 坐标系：白板原点 (0,0) 在中心；正 X 向右，正 Y 向下；元素按中心点定位；使用 position: {x: 0, y: 0} 表示白板中心；框架定义有界区域，内部元素继承框架位置。

已知注意事项 白板 ID：几乎所有操作都需要白板 ID；始终先通过 GET_BOARDS2 将白板名称解析为 ID；不要硬编码白板 ID，它们因账户而异。 元素创建：每种元素类型有不同的必填字段；便签需要 data.content 提供文本；框架需要 geometry.width 和 geometry.height；未指定时位置默认为 (0,0)，元素可能重叠。 速率限制：Miro API 对每个令牌有速率限制；批量操作优于逐个创建元素；多个元素使用 MIRO_CREATE_ITEMS_IN_BULK。 响应解析：响应数据可能嵌套在 data 键下；元素类型决定响应中存在哪些字段；防御性解析，可选字段可能缺失。

快速参考 任务 / 工具 Slug / 关键参数 列出白板 / MIRO_GET_BOARDS2 / query, sort, limit, offset 获取白板详情 / MIRO_GET_BOARD / board_id 创建白板 / MIRO_CREATE_BOARD / name, description 添加便签 / MIRO_CREATE_STICKY_NOTE_ITEM / board_id, data, style, position 添加框架 / MIRO_CREATE_FRAME_ITEM2 / board_id, data, geometry, position 批量添加元素 / MIRO_CREATE_ITEMS_IN_BULK / board_id, items 获取白板元素 / MIRO_GET_BOARD_ITEMS / board_id, type, cursor 分享白板 / MIRO_SHARE_BOARD / board_id, emails, role 获取成员 / MIRO_GET_BOARD_MEMBERS / board_id 获取连接器 / MIRO_GET_CONNECTORS2 / board_id