Sitelet https://cursor.com/ja/docs/integrations/jira
Skip to main content

Command Palette

Search for a command to run...

連携機能

Jira

Cursor の Jira 連携を使うと、Jira の作業項目を Cursor に割り当てるか、Jira で @Cursor をメンションして、Cloud Agents で作業できます。

はじめ方

要件

Jira 連携をインストールする前に、以下を満たしていることを確認してください。

  • Rovo が有効になっている Jira 商用クラウド
  • アプリをインストールする Jira サイトの管理者アクセス権
  • 接続する Cursor チームの管理者アクセス権
  • リポジトリへのアクセスとプルリクエストに使用する GitHub、GitLab、Azure DevOps、または Bitbucket が Cursor に接続されていること

インストール

  1. Cursor 管理者として、Cursor 連携に移動します

  2. Jira の横にある 接続 をクリックします

  3. Atlassian Marketplace の Cursor アプリの掲載ページに進みます

  4. 今すぐ入手 をクリックします

  5. Cursor をインストールする Jira サイトを選択し、確認 をクリックします

  6. アプリを確認し、今すぐ入手 をクリックします

  7. インストールが完了すると、Cursor Jira アプリの設定ページに移動します。Atlassian からインストール通知が届くまで数分待ってから、Cursor に接続 ボタンをクリックします。

  8. Jira サイトを Cursor チームに接続します

    • サービスアカウントでエージェントを実行する代わりにユーザーレベル認証を有効にする場合 (チームメンバーがエージェントをより詳細に確認・管理できるようになります) は、個別認証を必須にする トグルをオンにします。

  9. Cursor で残りの Cloud Agent のセットアップを完了します。

    • GitHub、GitLab、Azure DevOps、または Bitbucket に接続する
    • 使用量ベースの料金を有効にする
    • プライバシー設定を確認する
    • デフォルトのリポジトリ、モデル、ベースブランチを選択する (Cursor ダッシュボードの Cloud Agents 設定)

  10. Jira に戻り、作業項目から Cursor を使い始めます

    • ユーザーレベル認証を有効にした場合は、各ユーザーが以下の追加設定を行う必要があります

認証モード

_個別認証を必須にする_トグルを有効にすると、Cursor Jira 連携の管理者ダッシュボードで、Jira による Cloud Agents の認証方法を選択できます。

モード仕組み使用する設定
サービスアカウント認証Cloud Agents はサービスアカウントで実行されます。ルーティング、モデル、リポジトリ、デフォルトには、チームの Cloud Agent 設定のみを使用します。
ユーザーレベル認証すべての Cloud Agents が各ユーザーのアカウントで実行されます。ルーティング、モデル、リポジトリ、デフォルトには、各ユーザーの Cloud Agent 設定を使用します。また、ユーザーは自分のアカウントから実行中のエージェントを確認できます。

各ユーザーのアカウントを接続するには:

  1. Jira の作業項目でエージェントを起動します
  2. アカウント接続を促すプロンプトが表示されます
  3. リンクを開き、Jira アカウントをチームに関連付けられた Cursor アカウントに接続します
  4. Cursor で残りの Cloud Agent のセットアップを完了します:
    • まだリポジトリプロバイダーを接続していない場合は、GitHub、GitLab、Azure DevOps、または Bitbucket を接続します
    • デフォルトのリポジトリ、モデル、ベースブランチを選択します (Cursor ダッシュボードの My Settings にある Cloud Agents 設定)

使用方法

Jiraの作業項目を開き、Cursorに割り当てるか、コメントで@Cursorをメンションします。Cursorは、作業項目のタイトル、説明、コメント、利用可能なリポジトリ設定をもとにCloud Agentを起動します。

Cursorには、バグの修正、機能の追加、テストの更新、または作業項目に記載されたタスクの調査を依頼できます。

作業項目を委任する

チケットにタスクが明確に記載されている場合は、Jira の作業項目を Cursor に割り当てます。

  1. Jira の作業項目を開きます
  2. 担当者フィールドをクリックします
  3. Cursor を選択します
  4. 作業項目から開始された Cloud Agent を確認します

Cursor をメンションする

具体的な指示を追加したい場合は、Jira のコメントで @Cursor をメンションします。同じコメントでリポジトリ、ブランチ、モデルを指定することもできます。

例:

  • @Cursor please investigate this regression
  • @Cursor repo=acme/backend branch=release fix this before the release cut
  • @Cursor model=gpt-5.6-sol and update the related tests

追加の指示

Jira の作業項目から Rovo チャットを開き、Cursor との会話を続けます。

ステータス更新と引き継ぎ

Cloud Agent が開始されると、Jira の作業項目にエージェントのステータスが表示されます。Cursor は作業の進捗を投稿し、タスクが完了すると概要を返します。

Cursor がプルリクエストを作成した場合、完了時の更新には確認用の PR へのリンクが表示されます。

設定

ダッシュボード -> Cloud Agents の チーム設定 または My Settings で、デフォルト設定とプライバシーオプションを管理できます。

設定

デフォルトモデル

Jira の作業項目またはコメントでモデルが指定されていない場合に使用されます。利用可能なオプションについては、設定を参照してください。

リポジトリの選択

Cursor は、以下に基づいてリポジトリを選択します。

  1. 明示的な値: Jira のコメントまたは作業項目内の repo、branch、model の値
  2. 作業項目の内容: タイトル、説明、コメントに含まれるリポジトリ名、サービス名、キーワード
  3. ルーティングルール: カスタムのキーワードとリポジトリのマッピング
  4. 直近のエージェントのアクティビティ: 最近使用したリポジトリ
  5. デフォルトリポジトリ: 一致するものが見つからない場合のフォールバック

特定のリポジトリを使用するには、コメントに指定します。例: @Cursor repo=acme/mobile-app fix the login bug。有効にしているモードに応じて、チームのサービスアカウントまたはユーザーアカウントにこのリポジトリへのアクセス権が必要です。アクセス権がない場合、Cloud Agent の起動に失敗します。

ベースブランチ

Cloud Agent の開始元となるブランチです。空欄のままにすると、リポジトリのデフォルトブランチが使用されます (推奨) 。

ブランチ名のプレフィックス

Cloud Agents が作成するブランチ名に付けるプレフィックス。

オプション

@Cursor へのメンション使用時に、以下のオプションで Cloud Agent の挙動をカスタマイズできます。

オプション説明例
repoリポジトリを指定repo=acme/web-app
branchベースブランチを指定branch=main
modelモデルを指定model=opus

Cursor はコードブロック内のオプションを無視し、プロンプト内のコードは記述したとおりに残します。

ルーティングルール

ルーティングルールでは、特定のリポジトリに自動的に対応付けるキーワードを定義できます。Jiraの作業項目またはコメントに特定のキーワードが含まれている場合、CursorはCloud Agentを対応するリポジトリにルーティングします。

ルーティングルールを使用すると、どのプロジェクト、作業項目、キーワード、その他のデータに基づいて、各作業項目で使用するリポジトリをエージェントに指定できます。

ルーティングルールの設定

  1. ダッシュボード -> Cloud Agents に移動する
  2. Routing Rules セクションを見つける
  3. キーワードとリポジトリのマッピングを追加する

ルールの例

キーワードリポジトリ
frontendacme/web-app
mobileacme/mobile-app
apiacme/backend-services
docsacme/documentation

これらのルールを設定すると:

  • Fix the frontend nav bug というタイトルの作業項目は acme/web-app にルーティングされます
  • @Cursor update the mobile onboarding flow というコメントは acme/mobile-app にルーティングされます
  • @Cursor add rate limiting to the api というコメントは acme/backend-services にルーティングされます

ルーティングの仕組み

Cursor は、次の順序で Jira の作業項目とコメントを評価します。

  1. 明示的な値: Jira のコメントまたは作業項目で指定された repo、branch、model の値
  2. 作業項目の内容: タイトル、説明、コメントに含まれるリポジトリ名、サービス名、キーワード
  3. ルーティングルール: カスタムのキーワードとリポジトリのマッピング
  4. 直近のエージェントのアクティビティ: 最近使用したリポジトリ
  5. デフォルトリポジトリ: 一致するものがない場合のフォールバック

プライバシー

Cloud Agents はプライバシーモードに対応しています。

プライバシーモードの詳細を確認するか、プライバシー設定を管理してください。

権限

インストール時に、Jira には Cursor app が要求する権限が表示されます。Cursor はこれらの権限を使用して、次のことを行います。

  • Cloud Agent を開始または管理する Jira ユーザーを特定する
  • 作業項目 のフィールド、説明、コメント、関連するコンテキストを読み取る
  • ステータス更新、完了概要、プルリクエストへのリンクを投稿する
  • 作業項目 が Cursor に割り当てられた場合、または @Cursor がメンションされた場合にイベントを受信する

app をインストールする前に、Atlassian Marketplace で権限の確認画面を確認してください。

よくある質問

対応している Jira サイトは？

Cursor Jira 連携は、Rovo が有効になっている Atlassian 商用クラウドサイトをサポートしています。Atlassian HIPAA、FedRAMP、Government Cloud のインスタンスには対応していません。

従量課金は必要ですか？

はい。Cloud Agents を使用するには従量課金が必要です。Cursor で Cloud Agent をセットアップする際に、従量課金を有効にしてください。

Jira 連携をインストールできるのは誰ですか？

初回セットアップは、Jira 管理者と Cursor チーム管理者の両方の権限を持つユーザーが行う必要があります。

ユーザーは各自の Cursor アカウントを接続する必要がありますか？

選択する認証モードによって異なります。サービスアカウント認証では、すべての Cloud Agent がサービスアカウントで実行され、チーム設定が使用されます。ユーザーレベル認証では、各 Jira ユーザーのアカウントを Cursor に接続します。ユーザーは Jira から実行中の Cloud Agent を Cursor ダッシュボードで確認でき、ルーティング、モデル、リポジトリ、デフォルトには各ユーザーの設定が使用されます。

Cursor で PR を作成する前に、ほかに必要な設定はありますか？

GitHub、GitLab、Azure DevOps、または Bitbucket を Cursor に接続し、Cloud Agent の設定にチームで使用するリポジトリ、モデル、ベースブランチが含まれていることを確認してください。

ユーザーはCursorとの会話をどのように続けられますか？

Jira 作業項目 からRovo chatを開き、Cursorとの会話を続けます。または、CursorでCloud Agentを開き、そこで会話を続けます。

免責事項

Cursorは誤った内容を生成する場合があります。コードとレスポンスは必ず再確認してください。

プライバシーポリシー

Cursorによるお客様のデータの収集、使用、保護については、プライバシーポリシーをご覧ください。