用途：通过 Miro REST API 操作在线白板与可视化协作内容，适合需要程序化创建、查询、修改或分享白板的场景。
主要能力：验证令牌（查看 scopes、团队、用户）；列出与筛选看板；获取看板详情；创建看板；列出看板中的各类元素（便签、图形、文本、图片、卡片、框架、连接线等），可按类型过滤；创建便签、图形、文本元素；删除任意元素；通过邮箱邀请成员并分配角色。
必要用法：基础地址为 https://api.miro.com，所有请求在请求头中携带 Authorization: Bearer $MIRO_TOKEN。令牌由 Developer Portal 应用签发，可永不过期，存放在环境变量 MIRO_TOKEN 中。官方文档见 https://developers.miro.com/reference/overview。请求失败时可运行 zero doctor check-connector --env-name MIRO_TOKEN 或 zero doctor check-connector --url https://api.miro.com/v1/oauth-token --method GET 排查。
注意事项：看板坐标以中心为 (0,0)，X 向右为正，Y 向下为正，单位为像素；便签只需提供宽度即可保持正方形比例，图形需同时提供宽高；列表接口默认每页 20 条、最大 50 条，通过 cursor 参数翻页；限流约每分钟每应用 200 次请求，批量创建可使用 POST /v2/boards/{board_id}/items/bulk；统一 items 接口可列出所有子类型，创建时应使用对应子类型接口（如 /sticky_notes、/shapes、/texts 等）；文本内容支持有限的 HTML 行内标签。
限制：资料未提供免费/付费、价格或平台范围等信息；令牌的权限范围在应用创建时确定，如需更多 scopes 或不同团队需新建应用或重装后再连接。