你的 Jira 议题，
交给你选的代理处理
冲刺是在 Jira 里规划的。分配给你的工单都在那里，带着规格说明、截图和验收标准。你想要的，是每一个都有一个代理在处理，就在你自己的机器上，用最适合这项任务的 CLI。
AgentsRoom 把这些议题导入项目的 backlog，连同它们的描述、类型、标签和附件。每个议题都变成一张工单，你把它交给 Claude Code、Codex、GitHub Copilot CLI、Cursor 或其他代理 CLI，一张工单一个代理。导入只读取：任何内容都不会写回 Jira。
两个 Jira 项目，一个 JQL 查询，一张工单一个代理：导入读取 Jira，从不写入。
很多团队在 Jira 里规划工作：backlog、冲刺、今天早上分给你的议题。而越来越多的工作，是在 Claude Code、Codex 和其他代理 CLI 里完成的。两者之间，常见的做法是复制粘贴：把摘要贴进提示词，再贴上描述，截图在路上丢了。
Jira 导入替你完成这一步。你用 Atlassian 邮箱和一个 API 令牌连接你的 Jira Cloud 站点，选择一个项目或写一个 JQL 查询，预览议题，然后导入。它们作为普通工单落到项目 backlog 的 TODO 列，描述已转换成 Markdown，附件也已下载，你像对待其他任何工单一样，在每张上启动一个代理。
这不是双向同步。AgentsRoom 只向 Jira 发送读取请求：不做状态流转，不留评论，不改任何字段。如果你想让代理评论某个议题，或者把它移到 Done，那是 Atlassian 自己的 MCP 服务器要做的事，而且两者可以配合使用，下文会说明。
Jira 导入能做什么
backlog 又多了一个来源，与 Linear、GitHub Issues 和 Notion 并列。
一个项目，或你自己的 JQL
从列表中选一个项目，查询会自动替你填好；项目有几十个时还有搜索框。或者自己写 JQL：assignee = currentUser()、某个冲刺、某个组件、某个标签。只要 Jira 能搜索到，导入就能带进来。
单个议题，按编号导入
只需要刚分给你的那个议题？用 TODO 列的导入按钮粘贴 PROJ-123 或 Jira 链接。它会单独进来，放在列的顶部，不会动到已保存的导入。
可读的描述
Jira 把描述存成结构化文档，而不是文本。导入会把它们转换成 Markdown（标题、列表、代码块、表格、链接），这样代理读到的是写出来时的规格说明，而不是原始数据。
代理打得开的附件
议题的附件要登录 Jira 才能看到，所以给代理一个链接毫无用处。导入会把它们下载到你的电脑上，附到工单里：截图、PDF 规格说明、导出文件。
说得通的类型和状态
Bug、Story、Task、Epic：已知的议题类型会对应到工单类型，Jira 类型还会保留为标签，你们自己的叫法不会丢。状态跟随 Jira 在各个工作流之间共用的状态类别，所以 Done 的议题进来时就是已完成。
只读，令牌留在你的机器上
到达 Jira 的只有读取请求。API 令牌在你的电脑上加密保存，绝不会到达我们的服务器；只有查询会跟着项目去到你的其他机器，你在那里再粘贴一次令牌。
工作原理
四个步骤。前两步每台机器只做一次。
- 1
创建一个 API 令牌
在你的 Atlassian 账户中打开 Security，再进入 API tokens，创建一个令牌。要用经典令牌：带作用域的令牌可能导致项目列表返回为空。
- 2
连接你的 Jira 站点
在项目的 backlog 中点击「导入工单」，选择 JIRA。输入你的站点地址（只写团队名也可以）、Atlassian 邮箱和令牌。
- 3
选择并预览
选一个项目或写一个 JQL 查询，然后点击「预览」。按编号或标题搜索列表，勾选你想要的议题并导入，一次最多 500 个。
- 4
把每张工单交给一个代理
这些议题现在是 TODO 里的工单，每张都带有指回 Jira 的链接。分配一个代理和一个模型，如果想让它有自己的分支，就勾选「为此任务在独立的工作树中编码」，然后把工单拖到 In Progress。之后点「重新导入」，看板就会重新同步。
Atlassian 和代理 CLI 本身已经能做什么
Atlassian 为 Jira 和 Confluence 提供了一个官方远程 MCP 服务器，地址是 https://mcp.atlassian.com/v2/mcp，用 OAuth 登录。Atlassian 为 Claude Code 给出的文档是 claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp，再用 /mcp 登录；为 Codex 给出的是 codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp。之后代理就能在会话中使用工具来搜索、读取、创建和更新议题。
Jira 还允许你在经办人字段里把工作项分配给一个代理：Atlassian 自己的 Rovo 代理，以及从其他平台连接进来的代理，比如 GitHub Copilot 和 Cursor。代理处理这个工作项，并在那里报告进展，运行在承载它的平台上，而不是你电脑上的终端里。
AgentsRoom 导入满足的是另一种需求：议题放在看板上，和你其余的工单在一起，每个议题一个代理，在你自己的机器上，用你选的 CLI，包括那些完全没有 Jira 集成的 CLI。两者并不互斥：导入议题来规划和推进工作，当某个代理需要自己评论或流转它的议题时，再给它 Atlassian 的 MCP 服务器。
需要知道的事
- 仅支持 Jira Cloud。不支持 Jira Server 和 Data Center。
- 只有一个方向：任何内容都不会回到 Jira，即使这边的工单已经交付。自己流转议题，或者给代理 Atlassian 的 MCP 服务器。
- 令牌留在连接它的那台电脑上。在另一台机器上，看板按钮会显示「重新连接」，并带有「JIRA 未连接」标记，直到你在那里也粘贴令牌。
- 每次导入最多 500 个议题，每个议题最多 10 个附件，每个 8 MB 以内。
- 优先级、经办人、评论、组件、版本、史诗链接和故事点不会被导入：工单带的是摘要、描述、类型、标签和文件。
- 连接 Jira 和编写查询都在桌面端完成。在手机上你可以重新导入，或者按编号导入单个议题；两者都在你的电脑上运行，电脑必须开着。
常见问题
这和 Atlassian 的 MCP 服务器是一回事吗？
不是。Atlassian 的 MCP 服务器在支持 MCP 的 CLI 上，给单个代理提供在会话内读取和修改 Jira 的工具。AgentsRoom 导入则在任何代理启动之前，把议题放到项目的 backlog 上，这样你可以规划它们，把每一个交给不同的代理，并在看板上跟进。两者可以一起用：导入用来组织工作，MCP 服务器给需要评论或关闭自己议题的代理。
代理完成后，AgentsRoom 会更新 Jira 议题吗？
不会。导入只发送读取请求：不做状态流转，不留评论，不改任何字段。这边的工单交付后，你自己在 Jira 里移动议题，或者让代理通过 Atlassian 的 MCP 服务器去做。正因为只申请读取权限，导入才能适用于任何工作流，不管它的流转和条件是什么样的。
可以只导入分配给我的议题吗？
可以，用 JQL：assignee = currentUser() AND statusCategory != Done 会带进你能看到的所有项目中你未完成的议题。加上 project = ABC、某个冲刺或某个标签来缩小范围。查询会随项目一起保存，之后点「重新导入」就会重放它。
可以只导入刚分配给我的那个议题吗？
可以。用 TODO 列的导入按钮，粘贴它的编号（PROJ-123）或 Jira 链接。它会落到 TODO 的顶部，不会改动已保存的导入，之后还可以从工单上单独刷新它。
我的 Jira API 令牌会离开我的电脑吗？
不会。它加密保存在连接它的那台电脑上，绝不会到达我们的服务器。你的账户里只保存导入查询（站点和 JQL），这样导入会跟着项目去到你的其他机器，你在那里再粘贴一次令牌即可。
哪些代理 CLI 可以处理导入的 Jira 议题？
AgentsRoom 支持的全部 17 个代理 CLI（Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 13 个）。导入的议题就是一张普通工单：它在你分配的代理和模型上运行，在共享检出里，或者在它自己的 git worktree 里。
支持 Jira Server 或 Data Center 吗？
目前不支持。导入通过 Atlassian API 令牌与 Jira Cloud REST API 通信，而 Jira Server 和 Data Center 并不以同样的方式提供它。自托管 Jira 的用户仍然可以给代理一个支持其安装方式的 Jira MCP 服务器。
你可能还会喜欢
工单导入
把你的 Jira、Linear、GitHub Issues 或 Notion 工单放到同一个 backlog 上，在你自己的机器上把每一张交给 Claude Code、Codex、Cursor 或任意代理 CLI。只读。
Linear 导入
把你的 Linear 议题导入 AgentsRoom，把每一个交给 Claude Code、Codex 或任意代理 CLI。多个工作区、分配给我的、团队、项目、状态。只读。
任务管理
用拖放方式编排 AI 代理的可视化看板。在 TODO 中创建任务，拖到 In Progress 即可自动派生一个 Claude 代理，并通过 Pending 和 Done 列追踪完成进度。以待办驱动的并行 AI 编程开发。
Git worktree
给每个 AI 代理或工单一个独立的 git worktree，开箱即可构建（依赖已安装、.env 已复制），然后在同一个窗口里审查、提交并合并它。
MCP 服务器
MCP 服务器只需声明一次，就能交给 Claude Code、Codex 和所有代理 CLI。从官方 MCP 注册表中挑选，把密钥放在密钥管理器里，用一个“连接”按钮登录 Notion、Linear 等 OAuth 服务器。
把你的 Jira 议题交给你的代理
下载 AgentsRoom，把你的仓库作为项目打开，然后在它的 backlog 中点击「导入工单」，选择 JIRA。
配套应用：随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。