YouTrack クラウド 2025.3 ヘルプ

リモート MCP サーバー

モデルコンテキストプロトコル(MCP)は、チャットボットなどのアプリや AI ツールが YouTrack などの他のサービスと一貫性と安全性を保ちながら通信できるようにする新しい標準規格です。YouTrack MCP サーバーは、これらのツールが自身のアカウント権限を使用して YouTrack の課題をリアルタイムで読み取り、更新できるようにします。MCP サーバーには、課題やコメントなどを検索、作成、更新するためのツールが組み込まれています。

YouTrack はローカルクライアントとリモートクライアントへの接続をサポートしているため、AI ツールでサポートされている接続タイプを自由に使用できます。

リモート MCP クライアント接続

このタイプの接続は、HTTP を使用して通信できるクラウドベースのアプリケーションに適しています。例: n8n や OpenAI の Agent Kit などの自動化ツール、Zapier や Make などの統合プラットフォーム、Claude Code や Cursor などのコーディングエージェント。

リモート MCP クライアントに接続するには:

  1. YouTrack アカウントの永久トークンを生成し、スコープとして YouTrack を選択してください。具体的な手順については、永久トークンを作成するを参照してください。

  2. AI ツールの設定に次の変数を入力します。

    変数

    説明

    MCP エンドポイント

    YouTrack サイトのベース URL を入力し、その後に /mcp エンドポイントを入力します。例: https://my-company.youtrack.cloud/mcp

    HTTP ヘッダー

    リモート MCP クライアントへの HTTP リクエストのヘッダーで使用する認証トークンを指定します。例: Authorization: Bearer <token> ここで、<token> の値は、YouTrack アカウント用に生成した永久トークンです。

Claude Code への接続方法を示すサンプルコマンドを以下に示します。コマンドを使用する際は、プレースホルダーを YouTrack サイトのベース URL と永久トークンに置き換えてください。

claude mcp add --transport http YouTrack <your-youtrack-base-URL>/mcp --header "Authorization: Bearer <token>"

ローカル MCP クライアント接続

このタイプの接続は、mcp-remote プロキシを使用してコンピューターから直接接続するローカル AI ツールやチャットアプリに適しています。JetBrains Junie、または stdio(英語) または SSE トランスポートのみをサポートするその他のツールを使用する場合は、この設定を使用してください。

ローカル MCP クライアントに接続するには:

  1. YouTrack アカウントの永久トークンを生成し、スコープとして YouTrack を選択してください。具体的な手順については、永久トークンを作成するを参照してください。

  2. AI ツールの構成に次の参照を追加します。

    { "mcpServers": { "youtrack": { "command": "npx", "args": [ "mcp-remote", "<your-youtrack-base-URL>/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer <token>" } } } }
    • <your-youtrack-base-URL> の場合、YouTrack サイトのベース URL を入力します。

    • <token> の場合は、YouTrack アカウント用に生成された永久トークンを貼り付けます。

あるいは、認証ヘッダーの値を環境変数として設定し、次のコマンドを使用して接続を確立することもできます。

npx mcp-remote <your-youtrack-base-URL>/mcp --header Authorization:${AUTH_HEADER}
  • 環境変数を AUTH_HEADER="Bearer <token>" に設定します。<token> プレースホルダーを、YouTrack アカウント用に生成された永久トークンに置き換えます。

  • <your-youtrack-base-URL> の場合、YouTrack サイトのベース URL を入力します。

AI ツール

YouTrack の MCP サーバーには、課題、プロジェクト、ユーザー、時間管理に役立つツールがいくつか組み込まれています。インストールは不要で、すぐに使用できます。

課題

課題ツールを使用すると、YouTrack で課題を検索、作成、更新、管理できます。新しいタスクの作成、関連する課題のリンク、コメントの追加、進捗状況の更新など、課題データを直接管理できます。

名前

説明

サンプルプロンプト

search_issues

YouTrack のクエリ言語を使用して課題を検索します。クエリでは、属性フィルター、キーワード、フリーテキストを組み合わせることができます。

一致する課題の基本情報(課題 ID、概要、プロジェクト、解決状況、報告者、作成日時、更新日時など)を返します。詳細については、get_issue を使用してください。レスポンスは、指定されたオフセットと制限に基づいてページ分割されます。

モバイルアプリプロジェクトで自分に割り当てられたすべての未解決のバグを見つけます。

get_issue_fields_schema

指定されたプロジェクトのカスタムフィールドの JSON スキーマを返します。create_issue および update_issue アクションに関連するカスタムフィールドと値を提供するために使用する必要があります。

Web サイト再設計プロジェクトで課題を作成するために必要なフィールドはどれですか ?

create_issue

指定されたプロジェクトに新しい課題を作成します。get_issue_fields_schema を使用して、対象プロジェクトにおける customFields とその可能な値を調べましょう。重要: 課題の作成には一部のフィールドが必須となる場合があります。作成された課題の ID と、Web ブラウザーで課題を開くための URL を返します。課題の詳細を取得するには、get_issue を使用してください。

バックエンド API プロジェクトに、概要が「認証タイムアウトの修正」、優先度が「高」の新しい課題を作成し、@alex に割り当てます。

create_draft_issue

指定されたプロジェクトに新しい課題の下書きを作成します。下書きの課題は現在のユーザーのみに表示され、update_issue を使用して編集できます。課題の下書きに割り当てられた ID と、Web ブラウザーで下書きを開くための URL を返します。

「ホームページのヒーローセクションを修正する」という概要で、マーケティングサイトプロジェクトでドラフトの課題を開始します。

update_issue

既存の課題とそのフィールドを更新します。また、課題にスターを付けたり、投票を追加したりすることもできます。

課題 WEB-132 の状態を「進行中」に変更し、「フロントエンド」というラベルを追加して更新します。

get_issue

課題または課題ドラフトの詳細情報(概要、説明、URL、プロジェクト、報告者(ユーザー名)、タグ、投票、カスタムフィールドなど)を返します。customFields 出力プロパティは、タイプ、状態、担当者、優先度、サブシステムなど、より重要な課題の詳細を提供します。カスタムフィールドとその可能な値の全リストについては、get_issue_fields_schema を使用してください。

課題 ID BACK-249 の詳細をすべて表示します。

change_issue_assignee

課題内の担当者フィールドの値を指定されたユーザーに設定します。

課題 DEV-102 を @julia に再割り当てします。

add_issue_comment

指定された課題に新しいコメントを追加します。Markdown をサポートします。

課題 APP-56 にコメントを追加します: 「素晴らしい進歩です。終了する前に API ドキュメントを含めてください。」

get_issue_comments

課題コメントのリストとそれぞれの詳細情報を返します。レスポンスは、指定されたオフセットおよび / または制限に基づいてページ分けされます。

課題 UX-87 のすべてのコメントを一覧表示します。

get_saved_issue_searches

現在のユーザーがお気に入りとしてマークした保存済みの検索を返します。出力された検索クエリは search_issues で使用できます。レスポンスは指定されたオフセットおよび/または制限に基づいてページ分割されます。

保存した検索を表示します。

manage_issue_tags

課題にタグを追加または削除します。名前を指定した場合、指定された名前に一致する最初のタグが追加されます。一致するタグが見つからない場合は、類似のタグの候補を含むエラーメッセージが返されます。成功すると、更新された課題の ID と、更新された課題タグのリストが返されます。

課題 API-144 に「urgent」タグを追加します。

link_issues

指定されたリンクタイプで 2 つの課題をリンクします。対象となるすべての課題リンクタイプについて、更新されたリンク数を返します。

課題 DOCS-12 を課題 DEV-99 に「関連」としてリンクします。

プロジェクト

プロジェクトツールは、YouTrack 内のプロジェクトの探索と管理に役立ちます。プロジェクト名でプロジェクトを検索したり、詳細な設定を取得したり、課題の作成や下書きといったアクションの準備をしたりするのに使用できます。

名前

説明

サンプルプロンプト

find_projects

指定された部分文字列(大文字と小文字は区別されません)を含むプロジェクト名を検索します。get_project のプロジェクト選択に役立つ最小限の情報(ID と名前)を返します。レスポンスは、指定されたオフセットおよび/または制限に基づいてページ分割されます。

名前に「CRM」が含まれるすべてのプロジェクトを検索します。

get_project

特定のプロジェクトの完全な詳細を取得します。

「顧客ポータル」プロジェクトの詳細を入手してください。

グループ

これらのツールを使うと、ユーザーグループやプロジェクトチームを検索・調査できます。グループ名でグループを一覧表示したり、特定のグループの全メンバーを表示したりして、チームの構造を把握できます。

名前

説明

サンプルプロンプト

find_user_groups

指定された部分文字列(大文字と小文字は区別されません)を含む名前を持つユーザーグループまたはプロジェクトチームを検索します。応答は、指定されたオフセットおよび/または制限に基づいてページ区切りされます。

「デザイン」という単語を含むすべてのグループを一覧表示します。

get_user_group_members

指定されたグループまたはプロジェクトチームのメンバーであるユーザーを一覧表示します。プロジェクトチームは、基本的に特定のプロジェクトに常に関連付けられたグループです。レスポンスは、指定されたオフセットおよび/または制限に基づいてページ区切りされます。

QA エンジニアグループのメンバーのリストを表示します。

ユーザー

ユーザーツールは、YouTrack 内のユーザー情報へのアクセスを提供します。メールアドレスやユーザー名で特定のユーザーを検索したり、現在認証されているアカウントの詳細を取得したりすることが簡単にできます。これらのツールは、ID の確認、所有権の追跡、現在のユーザーに基づいたアクションのパーソナライズなどが必要な自動化や統合に特に役立ちます。

名前

説明

サンプルプロンプト

find_user

ユーザー名またはメールアドレスでユーザーを検索します。一致したユーザーのプロファイルデータを返します。これには、ユーザー名、フルネーム、メールアドレス、ローカルタイムゾーンが含まれます。

メールアドレス alex.rocha@company.com を持つユーザーを検索します。

get_current_user

現在認証されているユーザー (私) に関する詳細 (ユーザー名、メール、フルネーム、タイムゾーン) を返します。

アカウントの詳細を表示します。

タイムトラッキング

タイムトラッキングツールを使用すると、特定の課題に関連する作業項目を記録および管理できます。これにより、チームは開発、テスト、その他のプロジェクト活動に費やした時間を正確に記録できます。

名前

説明

サンプルプロンプト

log_work

指定された課題に作業項目(所要時間)を追加します。所要時間(分)、日付(オプション)、作業タイプ、説明、作業項目の属性(オプション)を指定できます。get_project を使用して、対象プロジェクトの workTypes および workItemAttributesSchema を取得します。

課題 DEV-203 に「支払いモジュールのリファクタリング」という説明で 90 分間の作業を記録します。

カスタム AI ツール

ここに記載されている定義済みの AI ツールに加えて、独自のカスタム AI ツールをスクリプト化してアプリパッケージに追加することもできます。カスタムツールは、他の YouTrack ユーザーが AI クライアントから MCP サーバーに接続する際に利用可能になります。

カスタム AI ツールの構築方法については、YouTrack および Hub の開発者ポータルのドキュメントを参照してください。

省略可能なパラメーター

YouTrack の MCP サーバーは、AI ツールと YouTrack サイトの連携方法を管理するためのオプションパラメーターをいくつかサポートしています。パラメーターを 1 つ以上設定するには、接続の MCP エンドポイント URL に対応するクエリパラメーターを含めてください。

パラメーター

説明

ツール

MCP サーバーが tools/list 要求に対して返すツール名のコンマ区切りリスト。例: /mcp?tools=search_issues,get_issue

このパラメーターを使用すると、特にコストのかかるリクエストの場合に、AI クォータが意図せず過剰に使用されるのを防ぐことができます。

無視ツール

tools/list 応答から除外するツール名のコンマ区切りリスト。例: /mcp?ignoreTools=find_user,manage_issue_tags

このパラメーターを使用すると、特にコストのかかるリクエストの場合に、AI クォータが意図せず過剰に使用されるのを防ぐことができます。

カスタムツールパッケージ

MCP サーバーで利用可能なカスタムツールのコンマ区切りリスト。セキュリティ上の理由から、カスタムツールは名前で明示的にリクエストする必要があります。例: /mcp?customToolPackages=app-name1,app-name2app-name1app-name2 は、カスタムツールを定義するアプリの名前です。

ツール出力スキーマを有効にする

true の場合、サーバーはツールの出力を記述する JSON スキーマを返します。バージョン 2025-06-18 以上の MCP クライアントは、この出力をツール呼び出しの LLM コンテキストに追加できます。例: /mcp?enableToolOutputSchema=true

YouTrack MCP サーバー用のすべての定義済み AI ツールは出力スキーマを返します。出力スキーマはカスタムツールでもサポートされています。

2025 年 10 月 30 日

関連ページ:

永久トークンの管理

YouTrack クラウドでは、永久トークンにより、開発者は OAuth 2.0 認証フローを実装しなくても、スクリプトとアプリケーションで RESTAPI 呼び出しを使用して安全に操作にアクセスして実行できます。永久トークンは、ユーザーアカウントに付与されたアクセス許可を持つサービスへのアクセスを許可します。このページでは、ユーザープロファイルで実行される永久トークンを使用した操作について説明します。永久トークンを使用した RESTAPI 呼び出しのサンプルについては、永久トークン認証を参照し...

モデルコンテキストプロトコル (MCP)

Junie をモデルコンテキストプロトコル(MCP)サーバーに接続できます。これにより、ファイルシステム、生産性ツール、データベースなどのデータソースやツールを操作するための実行可能機能が Junie に提供されます。サポートされているトランスポートタイプ現在、Junie は、標準入出力 (標準入出力) トランスポートタイプを使用する MCP サーバーのみをサポートしています。MCP サーバーの入手先ユースケースや設定に応じて、様々なローカルおよびリモート MCP サーバーをご利用いただけます。ま...

カスタム MCP ツール

定義済みの MCP ツールに加えて、独自のツールを作成し、YouTrack のユーザーが AI クライアントから YouTrack MCP サーバーに接続するときにそのツールにアクセスできるようにすることができます。YouTrack にカスタム MCP ツールを追加するには、カスタムアプリパッケージに追加してください。そうすることで、YouTrack ユーザーは AI クライアントを操作する際にそのツールを活用できるようになります。カスタムアプリの作成方法については、アプリクイックスタートガイド...

タスク管理

JetBrains IDE は、タスク管理プラグインによる YouTrack とのネイティブ統合をサポートしています。このプラグインは、デフォルトで IntelliJ IDEA、PhpStorm、PyCharm、RubyMine、WebStorm、AppCode、CLion、Rider、MPS にインストールされ、有効になっています。このプラグインの機能を拡張したり、YouTrack 統合プラグインで追加機能のロックを解除したりすることができます。YouTrack 統合プラグインをすでに使用している...