许多团队在 Jira 中安装完 Cursor 应用后，常常遇到一个棘手的问题：在评论框里输入 @Cursor，却始终无法弹出候选选项。别担心，这通常不是操作失误，而是站点、账户或代码仓库的连接尚未配置完整。一旦完成整套设置，Jira 的工作项中便能实时查看 Cursor 的运行状态；任务执行完毕后，变更摘要、测试说明和 PR 链接都会清晰呈现。

适用范围：当前方案仅针对 Jira Commercial Cloud，且你的站点必须提前启用 Rovo 功能；Cursor 方面，需要是 Teams 或 Enterprise 套餐。至于 Atlassian 的 HIPAA、FedRAMP 和 Government Cloud 版本，目前暂不支持，需等待后续更新。

确认账号、权限和代码仓库均已就绪

入口位置：你需要分别登录 Jira 站点管理后台、Cursor 团队管理后台，以及 Cursor 的 Cloud Agent 设置页面。负责安装的人员必须同时具备 Jira 站点管理员和 Cursor 团队管理员的权限。此外，团队需要先绑定一个代码仓库，例如 GitHub、GitLab、Azure DevOps 或 Bitbucket。

主要动作：首先检查你的 Jira 是否已开启 Rovo 的 Commercial Cloud 版本，再确认 Cursor 的套餐、团队权限和代码仓库服务商均无问题。建议提前准备一个权限清晰的测试仓库，后续用它进行首次验证，能有效避免“应用已安装但智能体启动失败”的困扰，提升排查效率。

成功标志：安装负责人能正常进入两个平台的管理后台，Cursor 中能看到要绑定的目标团队，代码仓库服务商也显示已连接。失败处理：如果看不到站点或团队，请先去补充管理员权限；如果仓库列表为空，则先完成代码仓库服务商的授权，不要急于进行 Jira 安装。

从 Cursor 集成页进入 Atlassian Marketplace

入口位置：打开 Cursor 仪表盘，进入 Integrations 页面，找到 Jira 项，点击旁边的 Connect 按钮。页面会自动跳转到 Atlassian Marketplace 中的 Cursor 应用详情页。

主要动作：确认应用名称是 Cursor，且页面标注了“适用于 Jira Cloud”，然后点击右上角的“Get it now”。注意不要从搜索结果中误选名称相似的第三方应用，否则会白费功夫。

如图所示，关键就是右上角的蓝色“Get it now”按钮，点击即可。左侧的 Cursor 名称和“works with Jira Cloud”标识，用于确认你未安装错误应用。如果按钮显示为登录提示，请先登录拥有目标 Jira 站点管理员权限的 Atlassian 账号。

成功标志：页面将跳转到 Jira 站点选择流程。失败处理：如果按钮无法点击，请检查 Atlassian 登录状态和站点权限；如果页面显示的应用或适用产品不正确，请退出并重新从 Cursor 的 Integrations 入口进入，避免误操作。

把应用安装到正确的 Jira 站点

入口位置：点击“Get it now”后，进入站点选择页面，这里会列出你当前 Atlassian 账号有权管理的所有 Jira Cloud 站点。

主要动作：选择你要接入 Cursor 的站点，点击“Review”，核对应用和站点无误后，点击确认页中的“Get it now”。安装完成后，应自动跳转到 Cursor Jira 应用的配置页。Atlassian 同步安装信息给 Cursor 需要一些时间，页面刚加载时不要反复点击，以免出错。

成功标志：配置页上会出现“Connect to Cursor”按钮。失败处理：如果目标站点不在列表中，大概率是当前账号没有该站点的管理员权限；如果安装后长时间未出现连接按钮，请等待几分钟再刷新配置页，若仍未出现，则检查应用是否确实安装到了目标站点。

连接 Cursor 团队并选定身份验证模式

入口位置：在 Cursor Jira 应用的配置页点击“Connect to Cursor”，然后选择你要绑定的 Cursor 团队。

主要动作：选择使用“服务账户”或“个人身份验证”模式。服务账户模式统一使用团队的 Cloud Agent 设置；如果打开了“Require personal authentication”开关，则每位成员需将自己的 Jira 账号与团队中的 Cursor 账号绑定，智能体将按每个人的 Cloud Agent 设置运行。

成功标志：配置页显示 Jira 站点已连接到正确的 Cursor 团队，身份验证开关状态与团队之前商定的一致。失败处理：如果看不到目标团队，请检查 Cursor 管理员权限和当前登录账号是否正确；个人模式下，成员首次启动智能体时收到连接提示属于正常现象，按提示绑定账号后再发送任务即可。

补齐 Cloud Agent 的仓库、计费和默认设置

入口位置：返回 Cursor 仪表盘的团队 Cloud Agent 设置页面；如果使用个人身份验证模式，成员还需要进入“My Settings”中的 Cloud Agent 设置。

主要动作：连接好代码仓库服务商，开启按用量计费，确认隐私设置，再选择默认的代码仓库、模型和基准分支。基准分支留空时，会自动使用仓库的默认分支；如果团队经常按 Jira 项目划分不同仓库，可以在仓库的路由规则中添加关键词，实现自动匹配。

成功标志：默认仓库、模型和分支的设置能正常保存，团队服务账户或个人账号能访问到测试仓库。失败处理：如果无法选择仓库，请检查服务商的授权范围是否正确；如果任务能创建但立即失败，请优先核对实际运行账号的仓库权限，以及按用量计费和隐私选项是否都已确认。

在 Jira 评论中选中 @Cursor

入口位置：打开一个描述清晰、适合验证的 Jira 工作项，找到“Activity”中的“Comments”输入框。

主要动作：输入 @Cursor，然后从弹出的提及候选浮层中，选择带 Cursor 图标的那一项。你也可以将工作项直接分配给 Cursor；不过，首次验证使用评论更合适，因为可以同时明确仓库、分支和模型。

候选浮层中应能看到 Cursor 的名称和图标。如果只输入普通文字而未真正选中提及对象，Jira 不会触发集成；如果候选列表未出现，请回头检查应用安装的站点是否正确、身份验证是否已连接，以及当前项目的权限是否足够。

成功标志：@Cursor 在评论框中显示为可识别的提及对象（而非普通文字）。失败处理：如果重新选择候选项仍无效，请使用 Jira 站点管理员账号确认应用是否已启用，再检查当前成员是否已完成个人身份验证。

提交一条能准确路由的测试指令

入口位置：仍在同一条 Jira 评论中，在 @Cursor 后面将任务描述清楚；如果需要覆盖默认值，可以添加 repo、branch 或 model 等参数。

主要动作：首次测试，建议选择范围小、结果易核对的任务，例如调查一个回归问题或更新相关测试。如果仓库较多，最好明确写上 repo=组织/仓库；仅在确实需要时，才指定分支或模型，然后点击“Save”。

在此界面中，需注意两点：评论中应保留 @Cursor 的提及，其后才是任务和参数；左下角的“Save”才是真正的提交按钮。如果参数值无法匹配到仓库，Cursor 会尝试根据工作项内容、路由规则、近期活动及默认仓库来选择，但首次测试时，建议明确写出仓库，以避免问题。

成功标志：评论成功发送，Jira 的“Agents”区域开始显示 Cursor 的状态。失败处理：如果评论发送后无任何状态，请先检查 @Cursor 是否仍是提及对象；如果状态出现但立即失败，请核对仓库名、分支、模型是否可用，以及运行账号的仓库访问权限。

用 Agents 状态确认集成已经启动

入口位置：评论发送后，停留在工作项详情页，查看“Activity”上方的“Agents”区域即可。

主要动作：等待状态从“启动中”变为“运行中”，同时留意当前的执行信息。如需补充指令，可打开 Jira 的 Rovo 聊天继续沟通，避免重复发送多条相同任务，以免混乱。

当“Agents”状态条显示“Cursor is running”时，说明 Jira 已将工作项交给 Cloud Agent。右侧的停止按钮仅在需要中止错误任务时使用；如果状态一直卡在启动阶段，请先检查账号连接和仓库权限，不要通过重复提交来掩盖配置问题，这无济于事。

成功标志：Agents 区域显示运行状态，Cursor 执行过程中会不断回传进度。失败处理：如果启动失败，请按顺序检查身份验证、仓库权限、默认仓库、计费和隐私设置；如果任务显式指定了分支或模型，还需确认这些值当前是否可用。

检查完成摘要和 PR 移交

入口位置：任务结束后，仍在同一个 Jira 工作项中，查看“Agents”状态和 Cursor 发布的评论即可。

主要动作：先确认状态变为“Work completed”，然后仔细阅读变更摘要和测试说明；如果任务创建了 PR，请点击回传的 PR 进行代码评审。不要看到“完成”就直接合并，务必核对修改范围、测试结果和目标分支是否正确。

完成界面会同时显示“Work completed”、“What changed”、“How I tested”和“PR”四项信息，这四项齐全后，才适合移交。没有 PR 不一定是失败，例如调查类任务可能只返回结论；如果需要代码变更却没有 PR，请检查任务范围、仓库写入权限和执行日志。

成功标志：Jira 收到了完成摘要，代码变更类任务还会附带一个可评审的 PR。失败处理：如果摘要显示仓库或分支不匹配，请修改 Cloud Agent 的默认值，或调整 Jira 评论中的参数；如果测试失败，请先根据回传信息修复环境或依赖，再通过 Rovo 聊天发送后续指令。

完成检查清单

• Jira 是已开启 Rovo 的 Commercial Cloud 版本，Cursor 团队使用的是 Teams 或 Enterprise 套餐。
• 安装负责人拥有 Jira 站点管理员和 Cursor 团队管理员权限，应用已安装到正确的站点，并连接到了正确的团队。
• 已确定使用服务账户还是个人身份验证模式；若使用个人模式，测试成员已完成 Jira 和 Cursor 的账号绑定。
• 代码仓库服务商、按用量计费、隐私设置、默认仓库、模型和基准分支均已保存，实际运行账号拥有仓库的相应权限。
• Jira 评论中能正常识别 @Cursor，测试任务提交后，Agents 区域会显示运行状态。
• 任务结束后能看到完成摘要；代码变更类任务会提供测试说明和可评审的 PR。
• 遇到异常时，能按照身份验证、仓库权限、路由参数、计费与隐私设置的顺序排查，而不是重复提交同一任务。
• 页面中的 Marketplace、提及、提交、运行和完成界面图均能正常加载；如果图片不显示，刷新页面后再核对对应的按钮或状态名称即可。