yandex-tracker-mcp

設定ファイルのパス：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

uvx を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Docker を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

uvx を使用する場合：

claude mcp add yandex-tracker uvx yandex-tracker-mcp@latest \
  -e TRACKER_TOKEN=your_tracker_token_here \
  -e TRACKER_CLOUD_ORG_ID=your_cloud_org_id_here \
  -e TRACKER_ORG_ID=your_org_id_here \
  -e TRANSPORT=stdio

Docker を使用する場合：

claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=your_tracker_token_here -e TRACKER_CLOUD_ORG_ID=your_cloud_org_id_here -e TRACKER_ORG_ID=your_org_id_here -e TRANSPORT=stdio ghcr.io/aikts/yandex-tracker-mcp:latest"

設定ファイルのパス：

• プロジェクト固有：プロジェクトディレクトリ内の .cursor/mcp.json
• グローバル：~/.cursor/mcp.json

uvx を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Docker を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

設定ファイルのパス：

• ~/.codeium/windsurf/mcp_config.json

アクセス方法：Windsurf Settings → Cascade tab → Model Context Protocol (MCP) Servers → "View raw config"

uvx を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Docker を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

設定ファイルのパス：

• ~/.config/zed/settings.json

アクセス方法：Cmd+,（macOS）または Ctrl+,（Linux/Windows）、またはコマンドパレットから「zed: open settings」

注： MCP をサポートするには、Zed Preview バージョンが必要です。

uvx を使用する場合：

{
  "context_servers": {
    "yandex-tracker": {
      "source": "custom",
      "command": {
        "path": "uvx",
        "args": ["yandex-tracker-mcp@latest"],
        "env": {
          "TRACKER_TOKEN": "your_tracker_token_here",
          "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
          "TRACKER_ORG_ID": "your_org_id_here"
        }
      }
    }
  }
}

Docker を使用する場合：

{
  "context_servers": {
    "yandex-tracker": {
      "source": "custom",
      "command": {
        "path": "docker",
        "args": [
          "run", "--rm", "-i",
          "-e", "TRACKER_TOKEN",
          "-e", "TRACKER_CLOUD_ORG_ID",
          "-e", "TRACKER_ORG_ID",
          "ghcr.io/aikts/yandex-tracker-mcp:latest"
        ],
        "env": {
          "TRACKER_TOKEN": "your_tracker_token_here",
          "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
          "TRACKER_ORG_ID": "your_org_id_here"
        }
      }
    }
  }
}

設定ファイルのパス：

• ワークスペース：プロジェクトディレクトリ内の .vscode/mcp.json
• グローバル：VS Code の settings.json

オプション 1：ワークスペース設定（セキュリティ上推奨）

.vscode/mcp.json を作成します：

uvx を使用する場合：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tracker-token",
      "description": "Yandex Tracker Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cloud-org-id",
      "description": "Yandex Cloud Organization ID"
    },
    {
      "type": "promptString",
      "id": "org-id",
      "description": "Yandex Tracker Organization ID (optional)"
    }
  ],
  "servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "${input:tracker-token}",
        "TRACKER_CLOUD_ORG_ID": "${input:cloud-org-id}",
        "TRACKER_ORG_ID": "${input:org-id}",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Docker を使用する場合：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tracker-token",
      "description": "Yandex Tracker Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cloud-org-id",
      "description": "Yandex Cloud Organization ID"
    },
    {
      "type": "promptString",
      "id": "org-id",
      "description": "Yandex Tracker Organization ID (optional)"
    }
  ],
  "servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "${input:tracker-token}",
        "TRACKER_CLOUD_ORG_ID": "${input:cloud-org-id}",
        "TRACKER_ORG_ID": "${input:org-id}",
        "TRANSPORT": "stdio"
      }
    }
  }
}

オプション 2：グローバル設定

VS Code の settings.json に追加します：

uvx を使用する場合：

{
  "github.copilot.chat.mcp.servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Docker を使用する場合：

{
  "github.copilot.chat.mcp.servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

その他の MCP 対応クライアントでは、標準の MCP サーバー設定形式を使用します：

uvx を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Docker を使用する場合：

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

• queues_get_all：利用可能な Yandex Tracker のキューをすべて一覧表示します

  • パラメーター：
    • fields（省略可能）：レスポンスに含めるフィールド（例：["key", "name"]）。必要なフィールドのみを選択して、コンテキストウィンドウの使用量を最適化できます。指定しない場合は、利用可能なすべてのフィールドを返します。
    • page（省略可能）：返すページ番号。指定しない場合は、すべてのページを自動的に取得します。
    • per_page（省略可能）：1 ページあたりの項目数（デフォルト：100）
  • フィールドを選択して含めた、ページ分割されたキュー情報を返します
  • TRACKER_LIMIT_QUEUES の制限を適用します

• queue_get_tags：指定したキューのタグをすべて取得します

  • パラメーター：queue_id（文字列。例："SOMEPROJECT" のようなキューキー）
  • 指定したキューで利用可能なタグの一覧を返します
  • TRACKER_LIMIT_QUEUES の制限を適用します

• queue_get_versions：特定のキューのすべてのバージョンを取得します

  • パラメーター：queue_id（文字列、"SOMEPROJECT" のようなキューキー）
  • 指定したキューで利用可能なバージョンのリストを、名前、説明、日付、ステータスなどの詳細とともに返します
  • TRACKER_LIMIT_QUEUES の制限を適用します

• queue_create_version：特定のキューに新しいバージョンを作成します

  • パラメーター：
    • queue_id（文字列、必須）："SOMEPROJECT" のようなキューキー
    • name（文字列、必須）：バージョン名
    • description（文字列、任意）：バージョンの説明
    • start_date（日付、任意）：YYYY-MM-DD 形式のバージョン開始日
    • due_date（日付、任意）：YYYY-MM-DD 形式のバージョン期日
  • 作成したバージョンを、名前、説明、日付、ステータスなどの詳細とともに返します
  • TRACKER_LIMIT_QUEUES の制限を適用します

• queue_get_fields：特定のキューのフィールドを取得します

  • パラメーター：
    • queue_id（文字列、必須）："SOMEPROJECT" のようなキューキー
    • include_local_fields（ブール値、任意、デフォルト：true）：キュー固有のローカルフィールドを含めるかどうか
  • グローバルフィールドのリストと、任意でローカル（キュー固有）フィールドを返します
  • include_local_fields が true の場合、両方の種類のフィールドを取得するために並列リクエストを実行します
  • schema.required プロパティは、フィールドが必須かどうかを示します
  • issue_create ツールで課題を作成する前に、利用可能なフィールドと必須フィールドを確認するために使用します
  • TRACKER_LIMIT_QUEUES の制限を適用します

• queue_get_metadata：特定のキューに関する詳細なメタデータを取得します

  • パラメーター：
    • queue_id（文字列、必須）："SOMEPROJECT" のようなキューキー
    • expand（文字列の配列、任意）：レスポンス内で展開するフィールド。利用可能なオプション：all、projects、components、versions、types、team、workflows、fields、issueTypesConfig
  • 名前、説明、デフォルトのタイプ／優先度、および任意で展開されたデータを含むキュー情報を返します
  • issue_close ツールに必要な、各課題タイプで利用可能な解決状況を取得するには、expand: ["issueTypesConfig"] を使用します
  • TRACKER_LIMIT_QUEUES の制限を適用します

これらのツールは統合された Yandex Tracker Entities API を使用します。entity_type パラメーターには project、portfolio、または goal を指定します。

• entity_get：id または数値の shortId でエンティティを取得します。追加の fields をリクエストしたり、attachments を展開したりすることもできます
• entities_search：名前の部分文字列または任意のフィールドフィルターでエンティティを検索します。フィールド選択、並べ替え、ルートのみのフィルタリング、ページベースのページネーションにも対応します
• entity_get_events：相対カーソルナビゲーション（from_id または selected）を使用して、エンティティのイベント履歴を取得します
• entity_create：エンティティを作成します。fields.summary は必須で、同じリクエストでリンクを作成することもできます
• entity_update：エンティティのフィールドとリンクを更新し、説明コメントを追加します。コレクションフィールドは set、add、remove などの Tracker 演算子に対応しています
• entity_delete：エンティティと、任意で関連するボードを削除します
• entities_bulk_update：同じタイプの複数のエンティティを一括更新する処理を開始します

共通のフィールドキーには、summary、description、lead、teamUsers、clients、followers、start、end、tags、parentEntity、entityStatus、teamAccess があります。日付は Tracker API が想定する形式を使用する必要があります。

TRACKER_READ_ONLY=true の場合、書き込みツールは利用できません。

• boards_list：現在のユーザーが利用できるすべてのボードを一覧表示します
• board_get：ボード ID を指定して、ボードの列と自動フィルター設定を取得します
• board_get_sprints：ボードに関連付けられたすべてのスプリントを一覧表示します
• sprint_get：ステータス、アーカイブフラグ、予定日／実績日を含む 1 つのスプリントを取得します

• filter_get：数値 ID を指定して保存済みの課題フィルターを取得します
• filter_find_issues：ページ／ページあたりの件数とレスポンスフィールドを指定して、保存済みフィルターを実行します
• filter_create：Tracker クエリまたはフィールド値の条件から保存済みフィルターを作成します
• filter_update：保存済みフィルターの名前、条件、表示フィールド、並べ替え、グループ化、またはフォルダーを更新します

TRACKER_READ_ONLY=true の場合、filter_create と filter_update は使用できません。issues_find と issues_count では、query の代わりに filter_id も指定できます。

• users_get_all：組織に登録されているユーザーアカウントの情報を取得します

  • パラメーター：
    • per_page（任意）：1 ページあたりのユーザー数（デフォルト：50）
    • page（任意）：取得するページ番号（デフォルト：1）
  • ログイン名、メールアドレス、ライセンス状態、組織の詳細を含む、ページ分けされたユーザー一覧を返します
  • 外部ユーザーかどうか、退職状態、通知設定などのユーザーメタデータも含まれます

• user_get：ログイン名または UID を指定して、特定のユーザーの情報を取得します

  • パラメーター：user_id（文字列。ユーザーログイン名「john.doe」や UID「12345」など）
  • ログイン名、メールアドレス、ライセンス状態、組織の詳細など、ユーザーの詳細情報を返します
  • ユーザーのログイン名と数値のユーザー ID の両方に対応しており、柔軟に識別できます

• user_get_current：現在認証されているユーザーの情報を取得します

  • パラメーターは不要です
  • 現在の認証トークンに紐づくユーザーの詳細情報を返します
  • 認証済みユーザーのログイン名、メールアドレス、表示名、組織の詳細が含まれます

• users_search：ログイン名、メールアドレス、または本名（名、姓、またはその両方）でユーザーを検索します

  • パラメーター：login_or_email_or_name（文字列。検索するユーザーのログイン名、メールアドレス、または本名）
  • クエリに複数のユーザーが一致した場合は複数のユーザーを、一致するユーザーがいない場合は空のリストを返します。一致が 1 人の場合はそのユーザーを返します
  • 本名の検索には、類似度しきい値 80％ のあいまい検索を使用します
  • ログイン名とメールアドレスの完全一致は、あいまいな名前の一致より優先されます

• get_global_fields：Yandex Tracker で利用可能なすべてのグローバルフィールドを取得します
  • 課題で使用できるグローバルフィールドの完全な一覧を返します
  • フィールドのスキーマ、型情報、設定が含まれます

• get_statuses：利用可能なすべての課題ステータスを取得します

  • 割り当て可能な課題ステータスの完全な一覧を返します
  • ステータス ID、名前、タイプ情報が含まれます

• get_issue_types：利用可能なすべての課題タイプを取得します

  • 課題の作成や更新に使用できる課題タイプの完全な一覧を返します
  • タイプ ID、名前、設定の詳細が含まれます

• get_priorities：利用可能なすべての課題優先度を取得します

  • 課題に割り当て可能な優先度の完全な一覧を返します
  • 優先度キー、名前、順序情報が含まれます

• get_resolutions：利用可能なすべての課題解決方法を取得します

  • 課題を終了するときに使用できる解決方法の完全な一覧を返します
  • 解決方法のキー、名前、説明、順序情報が含まれます

• issue_get：ID を指定して課題の詳細情報を取得します
  • パラメーター：
    • issue_id（文字列、形式：「QUEUE-123」）
    • include_description（ブール値、任意、デフォルト：true）：結果に課題の説明を含めるかどうか。説明は大きくなる場合があるため、必要な場合のみ使用してください。
  • ステータス、担当者、説明などを含む課題データ全体を返します

• issue_get_comments：Issue のすべてのコメントを取得します

  • パラメーター：issue_id（string）
  • 戻り値：メタデータ付きのコメントの時系列リスト

• issue_add_comment：Issue にコメントを追加します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • text（string、必須）：コメント本文（Tracker がサポートする Markdown 形式）
    • summonees（string の配列、任意）：呼び出すユーザー（ログイン名または ID）。ユーザーへのメンション／呼び出しには API でこの方法を使用します（通知は本文中の @login ではなく、このフィールドによって送信されます）。
    • maillist_summonees（string の配列、任意）：呼び出すメーリングリスト（メールアドレス）
    • markup_type（string、任意）：YFM（Markdown）には md を使用します
    • is_add_to_followers（boolean、任意、デフォルト：true）：コメントの作成者をフォロワーに追加します
  • 戻り値：作成されたコメントオブジェクト

• issue_update_comment：Issue の既存のコメントを更新します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • comment_id（int、必須）：コメント ID
    • text（string、必須）：新しいコメント本文（Tracker がサポートする Markdown 形式）
    • summonees（string の配列、任意）：呼び出すユーザー（ログイン名または ID）
    • maillist_summonees（string の配列、任意）：呼び出すメーリングリスト（メールアドレス）
    • markup_type（string、任意）：YFM（Markdown）には md を使用します
  • 戻り値：更新されたコメントオブジェクト

• issue_delete_comment：Issue からコメントを削除します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • comment_id（int、必須）：コメント ID
  • 戻り値：null（成功）

• issue_add_link：Issue と別の Issue の間にリンクを作成します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）：現在の Issue
    • relationship（string、必須）：issue_id とリンク先の Issue の関係を表すリンクの種類。次のいずれか：relates、is dependent by、depends on、is subtask for、is parent task for、duplicates、is duplicated by、is epic of、has epic
    • issue（string、必須）：リンク先の Issue の ID またはキー（例："TEST-123"）
  • 戻り値：作成されたリンクオブジェクト

• issue_delete_link：Issue と別の Issue の間のリンクを削除します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • link_id（int、必須）：リンク ID（issue_get_links によって返されます）
  • 戻り値：null（成功）

• issue_get_links：関連する Issue のリンクを取得します

  • パラメーター：issue_id（string）
  • 戻り値：関連、ブロック、または重複する Issue へのリンク

• issue_get_worklogs：作業ログのエントリーを取得します

  • パラメーター：
    • issue_ids（string の配列、必須）
    • start_date_from（date、任意）：作業開始日の下限（この日付を含む）（YYYY-MM-DD）
    • start_date_to（date、任意）：作業開始日の上限（この日付を含む）（YYYY-MM-DD）
    • timezone（string、任意、デフォルト UTC）：start の日付を比較する際に使用する IANA タイムゾーン（例：Europe/Moscow）
  • Issue ごとに相対ページネーションの全ページを取得し、createdAt ではなく作業ログの start フィールドでフィルタリングします
  • 戻り値：Tracker が返す ISO 8601 形式の期間をそのまま返します。週単位の値は Tracker の仕様を維持する必要があります。P6W は42暦日ではなく30稼働日です

• issue_add_worklog：Issue に作業ログのエントリーを追加します（費やした時間を記録します）

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • duration（string、必須）：ISO-8601 形式の期間（例：PT1H30M）
    • comment（string、任意）：作業ログのコメント
    • start（datetime、任意）：作業開始日時（タイムゾーンが指定されていない場合は UTC とみなされます）
  • 戻り値：作成された作業ログのエントリー

• issue_update_worklog：課題の作業ログエントリー（作業時間の記録）を更新します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • worklog_id（int、必須）：作業ログエントリー ID
    • duration（string、任意）：ISO-8601 形式の期間（例：PT1H30M）
    • comment（string、任意）：作業ログのコメント
    • start（datetime、任意）：作業開始日時（タイムゾーンが指定されていない場合は UTC として扱われます）
  • 更新された作業ログエントリーを返します

• issue_delete_worklog：課題の作業ログエントリー（作業時間の記録）を削除します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）
    • worklog_id（int、必須）：作業ログエントリー ID
  • 戻り値：null（成功）

• issue_get_attachments：課題の添付ファイルを取得します

  • パラメーター：issue_id（string、形式："QUEUE-123"）
  • 指定した課題の添付ファイルのメタデータを含むリストを返します

• issue_download_attachment：添付ファイルを MCP の埋め込みバイナリーリソースとしてダウンロードします

  • パラメーター：issue_get_attachments が返す issue_id、attachment_id、file_name
  • TRACKER_MAX_ATTACHMENT_BYTES の転送上限を適用します

• issue_upload_attachment：Base64 エンコードされたコンテンツを課題の添付ファイルとしてアップロードします

  • パラメーター：issue_id、file_name、content_base64、および任意の mime_type
  • TRACKER_READ_ONLY=true の場合は利用できません

• issue_delete_attachment：ID を指定して課題の添付ファイルを削除します

  • TRACKER_READ_ONLY=true の場合は利用できません

• issue_get_checklist：課題のチェックリスト項目を取得します

  • パラメーター：issue_id（string、形式："QUEUE-123"）
  • テキスト、ステータス、担当者、期限の情報を含むチェックリスト項目のリストを返します

• issue_get_transitions：課題で可能なステータス遷移を取得します

  • パラメーター：issue_id（string、形式："QUEUE-123"）
  • 課題に対して実行可能な遷移のリストを返します
  • 各遷移には、ID、表示名、遷移先のステータス情報が含まれます

• issue_get_changelog：課題の変更履歴（変更ログ）を取得します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）：課題キー
    • per_page（integer、任意、デフォルト：50）：1 ページあたりのエントリー数
    • cursor（string、任意）：前回の呼び出しで返された next_cursor の値です。次のページを取得するには、この値を渡します（カーソルページネーション）
    • field（string、任意）：フィールドキー（例：status）で変更ログを絞り込みます
    • type（string、任意）：変更タイプ（ステータス遷移の場合は IssueWorkflow など）で絞り込みます
  • entries（ステータス遷移とフィールド編集。誰が何を from → to に変更したか、いつ変更したかの情報、コメントの変更、実行されたトリガーを含む）と next_cursor（次のページを取得するため cursor として渡します。これ以上ページがない場合は null）を含むオブジェクトを返します

• issue_execute_transition：課題のステータス遷移を実行します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）：課題キー
    • transition_id（string、必須）：実行する遷移の ID。重要：issue_get_transitions ツールが返す ID のいずれかである必要があります
    • comment（string、任意）：遷移の実行時に追加する任意のコメント
    • fields（object、任意）：遷移中に設定する追加フィールドの辞書です。一般的なフィールドには、課題を終了する際の resolution（例：'fixed'、'wontFix'）、再割り当てのための assignee などがあります
  • 遷移の実行後、新しいステータスで可能な遷移のリストを返します
  • 使用上の注意：まず issue_get_transitions を呼び出して利用可能な遷移を取得し、返された遷移 ID のいずれかを渡す必要があります。任意の遷移 ID は使用しないでください。

• issue_close：解決内容を指定して課題をクローズします（便利なツール）

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）：課題キー
    • resolution_id（string、必須）：クローズ時に設定する解決 ID（例：'fixed'、'wontFix'、'duplicate'）
    • comment（string、任意）：課題のクローズ時に追加するコメント（任意）
  • 'done' ステータスへのトランジションを自動的に検索し、指定した解決内容で実行します
  • 新しい（クローズ済み）ステータスで利用可能なトランジションの一覧を返します
  • 使用上の注意：クローズする前に、必ず次の操作を行ってください。
    1. issue_get を呼び出して課題の type フィールドを取得します
    2. expand: ["issueTypesConfig"] を指定して get_queue_metadata を呼び出し、利用可能な解決内容を取得します
    3. 課題のタイプに一致する issueTypesConfig エントリーから解決内容を選択します。課題のタイプごとに有効な解決内容が異なります

• issue_create：キューに新しい課題を作成します

  • パラメーター：
    • queue（string、必須）：課題を作成するキューのキー（例：'MYQUEUE'）
    • summary（string、必須）：課題のタイトル／概要
    • type（int、任意）：課題タイプ ID（get_issue_types ツールから取得）
    • description（string、任意）：課題の説明
    • assignee（string または int、任意）：担当者のログイン名または UID
    • priority（string、任意）：優先度キー（get_priorities ツールから取得）
    • fields（object、任意）：課題の作成時に設定する追加フィールド。重要：課題を作成する前に、必ず queue_get_fields を呼び出して利用可能なフィールドを取得してください（デフォルトではグローバルフィールドとローカルフィールドの両方が返されます）。schema.required=true のフィールドは必須です。このマップのキーにはフィールドの id プロパティを使用してください（例：{"fieldId": "value"}）
  • 標準の課題フィールドをすべて含む、新しく作成された課題オブジェクトを返します
  • TRACKER_LIMIT_QUEUES の制限に従います

• issue_update：既存の課題を更新します

  • パラメーター：
    • issue_id（string、必須、形式："QUEUE-123"）：更新する課題キー
    • summary（string、任意）：新しい課題のタイトル／概要
    • description（string、任意）：新しい課題の説明
    • markup_type（string、任意）：説明文のマークアップタイプ（YFM マークアップには 'md' を使用）
    • parent（IssueUpdateParent、任意）：id（string）および／または key（string、例：'QUEUE-123'）を含む親課題参照
    • sprint（IssueUpdateSprint の配列、任意）：スプリントの割り当て。id（int）フィールドを含むオブジェクトの配列
    • type（IssueUpdateType、任意）：id（string）および／または key（string、例：'bug'、'task'）を含む課題タイプ
    • priority（IssueUpdatePriority、任意）：id（string）および／または key（string、例：'critical'、'normal'）を含む優先度
    • followers（IssueUpdateFollower の配列、任意）：フォロワー。id（string、ユーザー ID またはログイン名）を含むオブジェクトの配列
    • project（IssueUpdateProject、任意）：primary（int、メインプロジェクトの shortId）と、任意の secondary（int の配列）を含むプロジェクト
    • tags（string の配列、任意）：課題タグ
    • version（int、任意）：楽観的ロックに使用する課題バージョン。変更は現在のバージョンに対してのみ行われます
    • fields（object、任意）：更新する追加フィールド。利用可能なフィールドを確認するには queue_get_fields を使用してください
  • 標準の課題フィールドをすべて含む、更新後の課題オブジェクトを返します
  • 指定されたフィールドのみが更新され、省略されたフィールドは変更されません
  • TRACKER_LIMIT_QUEUES の制限に従います

• issue_move：課題を別のキューに移動します

  • パラメーター：
    • issue_id（string、必須、形式：「QUEUE-123」）：移動する課題キー
    • queue（string、必須）：移動先のキューキー（例：'MYQUEUE'）
    • notify（boolean、任意、デフォルト true）：課題のフィールドで参照されているユーザーに通知します
    • notify_author（boolean、任意、デフォルト false）：課題の作成者に通知します
    • move_all_fields（boolean、任意、デフォルト false）：移動先のキューに一致するバージョン、コンポーネント、プロジェクトがある場合は引き継ぎます。一致するものがない場合はクリアされます
    • initial_status（boolean、任意、デフォルト false）：課題のステータスを初期値にリセットします（移動先のキューで異なるワークフローが使用されている場合に使用します）
  • 移動先のキューで新しいキーが付与された、更新後の課題オブジェクトを返します（例：TASKS-1 → NEWQUEUE-42）
  • MCP クライアントがエリシテーションに対応している場合、移動の実行前にユーザーにブール値フラグの確認を求めます。拒否またはキャンセルすると移動は中止されます。エリシテーションに対応していないクライアントでは、渡された値を使用して処理を続行します
  • TRACKER_LIMIT_QUEUES の制限を適用します

• issues_find：Yandex Tracker Query Languageを使用して課題を検索します

  • パラメーター：
    • query（任意）：Yandex Tracker Query Language の構文を使用したクエリ文字列
    • filter_id（任意）：保存済みフィルター ID。query とは同時に指定できません
    • include_description（boolean、任意、デフォルト：false）：課題の結果に課題の説明を含めるかどうかを指定します。サイズが大きくなることがあるため、必要な場合にのみ使用してください
    • fields（文字列のリスト、任意）：応答に含めるフィールド。必要なフィールドのみを選択することで、コンテキストウィンドウの使用量を最適化できます。指定しない場合、利用可能なすべてのフィールドを返します
    • page（任意）：ページネーションに使用するページ番号（デフォルト：1）
    • per_page（任意）：1ページあたりの項目数（デフォルト：100）。結果がコンテキストウィンドウを超える場合、減らされることがあります
  • 1ページあたり、指定された数までの課題を返します

• issues_count：Yandex Tracker Query Languageを使用して、クエリに一致する課題の数をカウントします

  • パラメーター：
    • query（任意）：Yandex Tracker Query Language の構文を使用したクエリ文字列
    • filter_id（任意）：保存済みフィルター ID。query とは同時に指定できません
  • 指定された条件に一致する課題の合計数を返します
  • フィールドフィルタリング、日付関数、論理演算子、複雑な式など、クエリ言語のすべての機能に対応しています
  • 課題データ全体を取得せずに、分析やレポート作成、課題の分布の把握を行うのに便利です