你的 YouTrack 议题，
交给你选的代理处理
冲刺在 YouTrack 里。分配给你的缺陷和任务都在那里，带着描述、自定义字段和截图。你想要的，是每一个都有一个代理在处理，就在你自己的机器上，用最适合这项任务的 CLI。
AgentsRoom 把这些议题导入项目的 backlog，连同它们的描述、已填写的自定义字段和附件。每个议题都变成一张工单，你把它交给 Claude Code、Codex、GitHub Copilot CLI、Cursor 或其他代理 CLI，一张工单一个代理。导入只读取：任何内容都不会写回 YouTrack。
两个 YouTrack 项目，一个搜索，一张工单一个代理：导入读取 YouTrack，从不写入。
很多团队用 YouTrack 规划工作：敏捷看板、冲刺、今天早上进来的 bug。而越来越多的工作，是在 Claude Code、Codex 和其他代理 CLI 里完成的。两者之间，常见的做法是复制粘贴：把标题贴进提示词，再贴上描述，截图在路上丢了。
YouTrack 导入替你完成这一步。你用一个永久令牌连接你的 YouTrack，Cloud 版或自托管版都行，选择一个项目或输入任意 YouTrack 搜索，预览议题，然后导入。它们作为普通工单落到项目 backlog 的 TODO 列，带着描述、已填写的自定义字段和附件，你像对待其他任何工单一样，在每张上启动一个代理。
这不是双向同步。AgentsRoom 只向 YouTrack 发送读取请求：不改状态，不留评论，不更新任何字段。如果你想让代理评论某个议题或解决它，那是 YouTrack 自己的 MCP 服务器要做的事，而且两者可以配合使用，下文会说明。
YouTrack 导入能做什么
backlog 又多了一个来源，与 Jira、Linear、GitHub Issues、GitLab Issues、Azure DevOps 和 Notion 并列。
一个项目，或任意 YouTrack 搜索
从列表中选一个你的项目，项目有几十个时还有搜索框，搜索会替你写好：project: ABC #Unresolved。或者输入任何在 YouTrack 中有效的搜索，包括敏捷看板或冲刺的筛选条件，再加上 for: me 只保留你的议题。
单个议题，按 ID 导入
只需要刚分给你的那个 bug？用 TODO 列的导入按钮粘贴 ABC-123 或议题链接。它会单独进来，放在列的顶部，不会动到已保存的导入。
描述和自定义字段一并带上
导入保留议题的 Markdown 描述，并加上一个简短的上下文块，列出团队填写的自定义字段，最多八个：优先级、状态、负责人、子系统、估算或你自己的字段。代理读到的议题，就是团队写下的样子。
代理能打开的附件
附在议题上的文件要登录 YouTrack 才能看到，所以给代理一个链接毫无用处。导入只从你连接的实例下载它们到你的电脑上，并附到工单里：每个议题最多 10 个，每个 8 MB。
说得通的类型和状态
Type 字段决定工单类型：Bug、Cosmetics、Exception 和 Usability Problem 变成缺陷，Performance Problem 变成性能工单，Feature 和 Meta Issue 变成功能，类型本身保留为一个标记。是否完成，看的是 YouTrack 的“已解决”标志，所以处于你项目中任何已解决状态的议题，无论这个状态叫什么，进来时都是已完成。
只读，令牌留在你的机器上
导入只发送读取请求。永久令牌和你的实例地址一起在你的电脑上加密保存，绝不会到达我们的服务器。
工作原理
四个步骤。前两步每台机器只做一次。
- 1
创建永久令牌
在 YouTrack 中打开你的个人资料，再进入 Account Security，创建一个带 YouTrack 权限范围的永久令牌。它以 perm: 开头。
- 2
连接你的 YouTrack
在项目的 backlog 中点击「导入工单」，选择 YouTrack。输入你平时打开 YouTrack 用的地址（yourteam.youtrack.cloud 或你自己的服务器；粘贴某个议题或看板的链接也可以）和令牌。
- 3
选择并预览
选一个项目或输入一个搜索，然后点击「预览」。按 ID 或标题搜索列表，勾选你想要的议题并导入，一次最多 500 个。
- 4
把每张工单交给一个代理
这些议题现在是 TODO 里的工单，每张都带有指回 YouTrack 的链接。分配一个代理和一个模型，如果想让它有自己的分支，就勾选「为此任务在独立的工作树中编码」，然后把工单拖到「开发」。之后点「重新导入」，看板就会重新同步。
JetBrains 和代理 CLI 本身已经能做什么
YouTrack 有自己的 MCP 服务器，由 JetBrains 在 2025 年 10 月发布。它在你的实例地址后加上 /mcp 处响应（YouTrack Cloud 上是 https://yourteam.youtrack.cloud/mcp），接受永久令牌或 OAuth。对于 Claude Code，JetBrains 的文档给出的是 claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack，后面跟上这个地址；任何支持通过 HTTP 使用 MCP 的代理 CLI 都可以用同样的方式连接。
它的工具可以搜索议题和文章、创建和更新它们、添加评论和附件、管理标签和链接以及记录工时，权限就是令牌背后那个账户的权限。JetBrains 建议审查每一个会修改数据的工具调用，而在地址中加上 readOnlyTools=true 就只保留读取类工具。
AgentsRoom 导入满足的是另一种需求：议题放在看板上，和你其余的工单在一起，每个议题一个代理，在你自己的机器上，用你选的 CLI，而且不给其中任何一个代理写入 YouTrack 的权限。两者并不互斥：导入议题来规划和推进工作，当某个代理需要自己评论或解决它的议题时，再给它 YouTrack 的 MCP 服务器。
需要知道的事
- 每台电脑一个 YouTrack 实例，Cloud 版或自托管版。要从第二个实例导入，就连接它来替换第一个。
- 只有一个方向：即使工单在这里已经交付，也不会有任何内容回到 YouTrack。自己解决议题，或者给代理 YouTrack 的 MCP 服务器。
- 令牌留在连接它的那台电脑上。在另一台机器上，要先重新连接 YouTrack，才能在那里重新导入。
- 每次导入最多 500 个议题，每个议题最多 10 个附件，每个 8 MB。
- 评论、议题之间的链接和历史记录不会被导入：工单带的是标题、描述、自定义字段块、类型标记和文件。
- 连接 YouTrack 和编写搜索都在桌面端完成。在手机上你可以重新导入，或者按 ID 导入单个议题；两者都在你的电脑上运行，电脑必须开着。
常见问题
问我们其他问题这和 YouTrack 的 MCP 服务器是一回事吗？
Claude Code 能用 YouTrack 吗？
代理完成后，AgentsRoom 会更新议题吗？
可以只导入我的议题，或者只导入当前冲刺吗？
可以只导入刚分配给我的那个议题吗？
我的 YouTrack 令牌会离开我的电脑吗？
自托管的 YouTrack 能用吗？
哪些代理 CLI 可以处理导入的议题？
你可能还会喜欢
工单导入
把你的 Jira、Linear、GitHub Issues、GitLab Issues、Azure DevOps、YouTrack 或 Notion 工单放到同一个 backlog 上，在你自己的机器上把每一张交给 Claude Code、Codex、Cursor 或任意代理 CLI。只读。
Jira 导入
把 Jira Cloud 议题导入 AgentsRoom，在你自己的机器上把每一个交给 Claude Code、Codex、Cursor 或任意代理 CLI。按项目或 JQL，包含附件。只读。
任务管理
用拖放方式编排 AI 代理的可视化看板。在「待办事项」中创建任务，拖到「开发」即可自动派生一个 Claude 代理，并通过「待定」和「完成」列追踪完成进度。以待办驱动的并行 AI 编程开发。
Git worktree
给每个 AI 代理或工单一个独立的 git worktree，开箱即可构建（依赖已安装、.env 已复制），然后在同一个窗口里审查、提交并合并它。
MCP 服务器
MCP 服务器只需声明一次，就能交给 Claude Code、Codex 和所有代理 CLI。从官方 MCP 注册表中挑选，把密钥放在密钥管理器里，用一个“连接”按钮登录 Notion、Linear 等 OAuth 服务器。
把你的 YouTrack 议题交给你的代理
下载 AgentsRoom，把你的仓库作为项目打开，然后在它的 backlog 中点击「导入工单」，选择 YouTrack。
配套应用：随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。
