YouTrack 匯入

你的 YouTrack 議題，
交給你選的代理處理

衝刺在 YouTrack 裡。分配給你的缺陷和任務都在那裡，帶著描述、自定義欄位和截圖。你想要的，是每一個都有一個代理在處理，就在你自己的機器上，用最適合這項任務的 CLI。

AgentsRoom 把這些議題匯入專案的 backlog，連同它們的描述、已填寫的自定義欄位和附件。每個議題都變成一張工單，你把它交給 Claude Code、Codex、GitHub Copilot CLI、Cursor 或其他代理 CLI，一張工單一個代理。匯入唯讀取：任何內容都不會寫回 YouTrack。

下載 AgentsRoom免費看看它怎麼工作

從 YouTrack 到你的代理

YouTrack 專案

WEB

APP

#Unresolved for: me

Backlog · TODO

WEB-412Claude Code

WEB-415Codex

APP-88Cursor

唯讀：不寫回任何內容

兩個 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 伺服器是一回事嗎？

不是。YouTrack 的 MCP 伺服器給單個代理提供在會話內讀取和修改 YouTrack 的工具。AgentsRoom 匯入則在任何代理啟動之前，把議題放到專案的 backlog 上，這樣你可以規劃它們，把每一個交給不同的代理，並在看板上跟進。兩者可以一起用：匯入用來組織工作，MCP 伺服器給需要評論或解決自己議題的代理。

Claude Code 能用 YouTrack 嗎？

能，有兩種方式。在會話內，按 JetBrains 文件所示，用 claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack 後面跟上你的執行個體地址和 /mcp，新增 YouTrack 的 MCP 伺服器：代理隨後就能自己搜尋、讀取和更新議題。在會話之前，把議題匯入 AgentsRoom，再把每一個交給一個 Claude Code 代理：描述、自定義欄位和檔案會隨任務一起到達代理。

代理完成後，AgentsRoom 會更新議題嗎？

不會。匯入只傳送讀取請求：不改狀態，不留評論，不更新任何欄位。工單在這裡交付後，由你自己在 YouTrack 裡解決議題，或者讓代理透過 YouTrack 的 MCP 伺服器去做。

可以只匯入我的議題，或者只匯入當前衝刺嗎？

可以，用搜尋：加上 for: me 只保留分配給你的議題，並像在 YouTrack 裡那樣使用看板或衝刺的篩選條件。搜尋會隨專案一起儲存，之後點「重新匯入」就會重放它。

可以只匯入剛分配給我的那個議題嗎？

可以。用 TODO 列的匯入按鈕，貼上它的 ID（ABC-123）或連結。它會進到 TODO 的頂部，不改變已儲存的匯入，之後還可以從工單單獨重新整理它。

我的 YouTrack 令牌會離開我的電腦嗎？

不會。它和你的執行個體地址一起加密儲存在連線它的那台電腦上，絕不會到達我們的伺服器。附件只從你連線的執行個體下載，所以令牌絕不會被傳送到其他主機。

自託管的 YouTrack 能用嗎？

能。輸入你自己伺服器的地址，而不是 youtrack.cloud 地址，並使用在該伺服器上建立的永久令牌。YouTrack Cloud 的地址也可以，包括較早的 myjetbrains.com/youtrack 地址。

哪些代理 CLI 可以處理匯入的議題？

AgentsRoom 支援的全部 19 個代理 CLI（Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 15 個）。匯入的議題就是一張普通工單：它在你分配的代理和模型上執行，在共享檢出裡，或者在它自己的 git worktree 裡。