需完成Miro与Jira双向集成：一、通过插件快速添加单个Jira问题；二、管理员配置Jira Cloud原生集成实现全局同步；三、在白板中编辑、拖拽、批量更新卡片并实时同步；四、排查权限、API、连接状态、筛选器及字段映射问题。
如果您希望在Miro白板中直接查看、同步和操作Jira任务，需完成Miro与Jira之间的双向集成配置。以下是实现该集成的具体步骤：
一、通过Miro插件添加Jira问题到白板
此方法适用于在已有Miro白板中快速插入单个或多个Jira问题卡片，无需预先配置全局连接，适合临时协作场景。
1、在Miro编辑界面任意位置点击，输入斜杠键 / 唤出命令菜单。
2、在弹出的“其他应用”菜单中，向下滚动并选择 Jira 选项。
3、点击 继续，系统将跳转至Jira登录页；若尚未登录，请使用您的Jira账户凭据完成身份验证。
4、登录成功后，页面提示授予Miro对Jira的 读/写访问权限，点击 接受 确认授权。
5、授权完成后，系统列出您在Jira中已保存的筛选器（Filters），从中选择一个目标筛选器，如 My Open Issues 或自定义的Sprint待办列表。
6、确认后，所选Jira问题将以原生卡片形式自动载入当前Miro白板，支持拖拽、分组、添加评论及实时状态同步。
二、在Miro中启用Jira Cloud原生集成（管理员级）
此方式为组织级配置，启用后所有成员可在任意白板中导入Jira任务，并支持字段映射、状态自动更新与双向同步，适用于长期敏捷协作团队。
1、确保您拥有Miro企业版或商业版权限，并具备 Miro工作区管理员 身份。
2、进入Miro工作区设置：点击左下角头像 → 选择 Admin settings → 在左侧导航栏点击 Integrations。
3、在集成市场中搜索 Jira Cloud，点击其卡片右侧的 Install 按钮。
4、系统跳转至Atlassian OAuth授权页，确认允许Miro访问您的Jira Cloud实例中的项目、问题、状态等数据范围。
5、返回Miro后，在集成详情页填写连接名称（例如 Prod Team Jira Sync），并选择默认同步的Jira项目与问题类型（如Story、Bug、Task）。
6、开启 Auto-sync enabled 开关，并设定同步频率（推荐每15分钟一次），点击 Save connection 完成配置。
三、使用Jira问题卡片进行白板内协作
完成任一上述集成后，即可在白板中对Jira卡片执行本地化操作，所有变更将按策略同步回Jira系统，保障数据一致性。
1、在白板上右键点击任意Jira问题卡片，选择 Open in Jira 查看完整详情页。
2、双击卡片可展开内联编辑器，修改标题、描述、状态字段（若Jira权限允许），修改后自动触发同步。
3、将Jira卡片拖入Miro白板上的不同分区（如“To Do”、“In Progress”、“Done”），Miro将依据预设的字段映射规则，自动更新Jira中对应问题的 Status 或 Sprint 字段。
4、在卡片下方添加便签或评论，内容将作为新评论同步至Jira问题的Activity流中，且带Miro来源标识。
5、选中多个Jira卡片后，点击顶部工具栏的 Bulk update，可批量修改优先级、标签或关联史诗（Epic Link）。
四、故障排查：Jira卡片无法加载或同步失败
当Jira问题未显示或状态不同步时，通常由权限、网络或配置偏差导致，可通过以下路径逐项验证。
1、检查Jira用户权限：确保用于授权的Jira账户至少拥有目标项目的 Browse Projects 和 View Issues 权限。
2、验证Jira REST API可用性：在浏览器中访问 https://your-domain.atlassian.net/rest/api/3/project（替换为实际域名），确认返回JSON响应且HTTP状态码为200。
3、审查Miro集成状态：进入Miro Admin Settings → Integrations → Jira Cloud，查看连接状态是否为 Active；若显示“Connection failed”，点击 Retry 并重新授权。
4、确认Jira问题筛选器有效性：在Jira中手动运行该筛选器，确保结果非空且不包含语法错误（如非法JQL函数或缺失字段权限）。
5、检查字段映射设置：在Miro集成配置页中，核实 Status field mapping 是否将Miro分区名（如“Done”）正确映射至Jira工作流中的对应状态（如“Closed”）。
