很多团队在 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=组织/仓库。只有真的需要的时候，再指定分支或模型，然后点击“Sa ve”。

看这张界面，要注意两个地方：评论里得保留 @Cursor 的提及，后面才是任务和参数；左下角的“Sa ve”才是真正提交的按钮。如果参数值匹配不到仓库，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、提及、提交、运行和完成界面图都能正常加载；如果图片不显示，刷新页面之后再核对对应的按钮或状态名称就行。