YouTrackインポート

YouTrackのイシューを、
あなたが選んだエージェントが処理する

スプリントはYouTrackにあります。自分に割り当てられたバグやタスクもそこにあり、説明も、カスタムフィールドも、スクリーンショットも揃っています。必要なのは、そのそれぞれにエージェントを付けることです。自分のマシンで、タスクに合ったCLIで。

AgentsRoomはそれらのイシューを、説明、入力済みのカスタムフィールド、添付ファイルごとプロジェクトのバックログにインポートします。1件ずつがチケットになり、Claude Code、Codex、GitHub Copilot CLI、Cursor、または別のエージェントCLIに任せられます。1チケットに1エージェントです。インポートは読み取るだけで、YouTrackに何かが書き戻されることは一切ありません。

AgentsRoomをダウンロード無料仕組みを見る

YouTrackからエージェントへ

YouTrackプロジェクト

WEB

APP

#Unresolved for: me

バックログ · TODO

WEB-412Claude Code

WEB-415Codex

APP-88Cursor

読み取り専用：書き戻しなし

2つのYouTrackプロジェクト、1つの検索、1チケットに1エージェント。インポートはYouTrackを読むだけで、書き込むことはありません。

YouTrackは、多くのチームが仕事を計画する場所です。アジャイルボード、スプリント、今朝届いたバグ。Claude Code、Codex、そのほかのエージェントCLIは、その仕事が実際に行われる場所として存在感を増しています。その間では、コピー＆ペーストがいつものやり方です。タイトルをプロンプトに、続けて説明を貼り、途中でスクリーンショットをなくします。

YouTrackインポートは、その手順を代わりに引き受けます。Cloudでもセルフホストでも、永続トークンでYouTrackを接続し、プロジェクトを選ぶかどんなYouTrack検索でも入力し、イシューをプレビューしてインポートします。イシューはプロジェクトのバックログのTODO列に普通のチケットとして入り、説明、入力済みのカスタムフィールド、添付ファイルも揃っています。あとはほかのチケットと同じように、それぞれでエージェントを起動するだけです。

これは双方向の同期ではありません。AgentsRoomがYouTrackに送るのは読み取りリクエストだけです。状態の変更も、コメントも、フィールドの更新もありません。エージェントにイシューへコメントさせたり、解決させたりしたいなら、それはYouTrack自身のMCPサーバーの役割で、後で説明するとおり、2つは組み合わせて使えます。

YouTrackインポートでできること

バックログのソースがもう1つ。Jira、Linear、GitHub Issues、GitLab Issues、Azure DevOps、Notionに並びます。

プロジェクト、またはどんなYouTrack検索でも

一覧からプロジェクトを1つ選べば（数十件あるときは検索欄も使えます）、検索は自動で書かれます：project: ABC #Unresolved。あるいは、アジャイルボードやスプリントのフィルターも含め、YouTrackで使える検索を何でも入力し、for: meを追加すれば自分のイシューだけに絞れます。

1件のイシューを、IDで

必要なのは、いま渡されたバグだけですか？ TODO列のインポートボタンで、ABC-123またはイシューのリンクを貼り付けてください。そのイシューだけが列の一番上に入り、保存済みのインポートには影響しません。

説明もカスタムフィールドも一緒に

インポートはイシューのMarkdownの説明を残し、チームが入力したカスタムフィールドを最大8つまとめた短いコンテキストブロックを加えます。優先度、状態、担当者、サブシステム、見積もり、または独自のフィールドです。エージェントはチームが書いたとおりのイシューを読めます。

エージェントが開ける添付ファイル

イシューに添付されたファイルはYouTrackにログインしないと見られないため、リンクだけではエージェントの役に立ちません。インポートはそれらを、接続したインスタンスからのみ、あなたのコンピューターにダウンロードしてチケットに添付します。1件のイシューにつき最大10個、1個あたり8 MBまでです。

意味の通る種類と状態

Typeフィールドがチケットの種類を決めます。Bug、Cosmetics、Exception、Usability Problemはバグに、Performance Problemはパフォーマンスのチケットに、FeatureとMeta Issueは機能になり、種類はタグとして残ります。完了かどうかはYouTrackの「解決済み」フラグから読み取ります。そのため、プロジェクトのどの解決済み状態にあるイシューも、状態の名前にかかわらず完了として入ります。

読み取り専用、トークンはあなたのマシンに

インポートが送るのは読み取りリクエストだけです。永続トークンはインスタンスのアドレスとともにあなたのコンピューターで暗号化され、私たちのサーバーに届くことはありません。

仕組み

4つのステップ。最初の2つはマシンごとに1回だけです。

1
永続トークンを作成する
YouTrackでプロフィールを開き、続いてAccount Securityを開いて、YouTrackスコープを付けた永続トークンを作成します。トークンはperm:で始まります。
2
YouTrackを接続する
プロジェクトのバックログで「チケットをインポート」をクリックし、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のインポートは別のニーズに応えます。ほかのチケットと並べてイシューをボードに置き、1件のイシューに1つのエージェントを、自分のマシンで、自分で選んだCLIで動かすことです。どのエージェントにもYouTrackへの書き込み権限を与えることはありません。2つは排他的ではありません。イシューをインポートして作業を計画・実行しつつ、エージェント自身がイシューにコメントしたり解決したりすべきときは、そのエージェントにYouTrackのMCPサーバーを渡しましょう。

知っておくべきこと

1台のコンピューターにつき1つのYouTrackインスタンスです（Cloudまたはセルフホスト）。2つ目のインスタンスからインポートするには、1つ目の代わりにそのインスタンスを接続します。
一方向のみ：チケットがここで完了しても、YouTrackには何も戻りません。イシューは自分で解決するか、エージェントにYouTrackのMCPサーバーを渡してください。
トークンは接続したコンピューターに残ります。別のマシンでは、そこでインポートを再実行する前に、もう一度YouTrackを接続します。
1回のインポートで最大500件のイシュー、1件のイシューにつき8 MBまでの添付ファイルを最大10個です。
コメント、イシュー間のリンク、履歴はインポートされません。チケットが持つのは、タイトル、説明、カスタムフィールドのブロック、種類のタグ、ファイルです。
YouTrackの接続と検索の作成はデスクトップで行います。スマホからは、インポートの再実行と、IDを指定した1件のイシューの取り込みができます。どちらもあなたのコンピューター上で実行されるので、コンピューターの電源が入っている必要があります。

よくある質問

ほかのことを質問する

これはYouTrackのMCPサーバーと同じものですか？

いいえ。YouTrackのMCPサーバーは、1つのエージェントに、セッションの中からYouTrackを読み書きするツールを与えます。AgentsRoomのインポートは、エージェントが動き出す前にイシューをプロジェクトのバックログに取り込むので、計画を立て、1件ずつ別のエージェントに任せ、ボードで進み具合を追えます。両方を使うこともできます。作業の整理にはインポートを、イシューにコメントしたり解決したりすべきエージェントにはMCPサーバーを。

Claude CodeはYouTrackを使えますか？

はい、2つの方法があります。セッションの中では、JetBrainsのドキュメントにあるとおり、claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack に続けてインスタンスのアドレスと/mcpを指定し、YouTrackのMCPサーバーを追加します。するとエージェントが自分でイシューを検索し、読み、更新できるようになります。セッションの前には、イシューをAgentsRoomにインポートし、1件ずつ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で実行されます。