Jira 向け Claude Agent をセットアップする

Jira 向け Claude Agent (ベータ版) は、Jira Cloud と Anthropic の Claude Managed Agents の統合です。独自の Anthropic アカウントおよび GitHub 組織をすでに所有している、または所有する計画があるチーム向けに設計されています。Jira のエージェントは、HIPAA および FedRAMP インスタンスではサポートされていません。

Jira 向け Claude Agent を使用して、次のことを実行できます。

  • Jira 作業項目のコーディング作業を Claude Managed Agent に割り当てる

  • エージェントにコードの記述、ブランチのプッシュ、GitHub プル リクエストのオープンを許可する

  • Jira をエージェント主導の作業のハブとして維持する

Jira 向け Claude Agent をインストールする前に、次の要件を満たしていることを確認してください。

  • Jira Cloud の管理者アクセス権 — Jira Cloud サイトに Marketplace アプリをインストールできる必要があります。

  • Anthropic アカウント — API キー、エージェント、環境を作成する権限を含む、Claude Console および Claude Managed Agents へのアクセス権が必要です。エージェントのセットアップ ドキュメントを参照

  • GitHub の組織およびサービス アカウント — リポジトリの読み取り、新しいブランチのプッシュ、およびプル リクエストのオープンが可能な個人用アクセス トークンが必要です。アクセスを拡大する前に動作を確認したい場合は、小規模なテスト用リポジトリから開始してください。


Jira 向け Claude Agent をインストールする

Jira 向け Claude Agent をインストールするには、次の手順に従います。

  1. Atlassian Marketplace の Jira 向け Claude Agent のリスト に移動して、[今すぐ入手] を選択します。

  2. アプリをインストールする Jira Cloud サイトを選択します。

  3. インストールを確認します。

インストールが完了すると [設定] 画面に移動するので、ここで Jira 向け Claude Agent をセットアップします。また、アプリは [設定] > [アプリ] > [アプリの管理] からいつでも確認できます。


必要な API キーとアクセス トークンを作成します。

Jira 向け Claude Agent を設定するには、2 つの認証情報が必要です。

  • Claude Managed Agents API キー — Anthropic 用

  • GitHub 個人用アクセス トークン — GitHub サービス アカウント用

Claude API キーを作成する

API キーを作成するには、次の手順に従います。

  1. Anthropic Console をオープンし、使用するワークスペースに切り替えます。

  2. [設定] > [API キー] に移動します。

  3. [Create new API key (新しい API キーを作成)] を選択します。

  4. キーにはわかりやすい名前を付けてください。例: claude-agent-for-jira

  5. API キーを保存してコピーします。これを Jira の構成画面に貼り付けます。

GitHub の個人用アクセス トークンを作成する

GitHub の個人用アクセス トークンを作成するには、次の手順に従います。

  1. マシンのユーザー アカウントを使用して GitHub にサインインします。

  2. [設定] > [開発者設定] > [個人用アクセス トークン] の順に移動します。

  3. マシン アカウントの新しいトークンを作成する。

    • 組織のポリシーに応じて、クラシックまたはきめ細かなトークンを使用します。

    • わかりやすい名前を付けます。例: claude-agent-for-jira-service-token

    • 最低限、リポジトリのコンテンツ (読み取り/書き込み) およびプル リクエスト (読み取り/書き込み) を付与します。

    • きめ細かいトークンを使用する場合、リポジトリを所有する組織にスコープを設定し、エージェントに変更させるリポジトリを明示的に許可します。

  4. トークンを生成してコピーします。

後でエージェントに追加のリポジトリへのアクセス権を付与するには、GitHub の設定で GitHub の個人用アクセス トークンのリポジトリ権限をアップデートします。


Jira 向け Claude Agent を構成する

Jira 向け Claude Agent を構成するには、次の手順に従います。

  1. Jira で、[設定] > [アプリ] > [アプリの管理] の順に移動します。

  2. Jira 向け Claude Agent を見つけて、[設定] を選択します。

  3. Claude Managed Agent API キーを追加する — Claude Managed Agent API キーを [CMA] フィールドに貼り付け、[Create agent (エージェントを作成)] を選択します。Jira は Anthropic の Managed Agents API を呼び出し、既定のエージェントと環境を作成します。エージェントには、コード作成タスク用のシステムプロンプト、組み込みツール、および GitHub へのアクセスが事前設定されているため、コードの読み書きやプル リクエストのオープンを行うことができます。確認するには、Anthropic コンソールを開き、[Managed Agents] に移動して新しいエージェントを確認し、[環境] に移動して使用されている環境を確認します。

  4. GitHub トークンを追加する — GitHub の個人用アクセス トークンを [GitHub token (GitHub トークン)] フィールドに貼り付けて、[保存] を選択します。

両方のトークンが検証されて保存されると、Jira 向け Claude Agent を使用できるようになります。

認証情報は、アトラシアンの Forge キーバリュー ストアに保存され、保存時に暗号化されます。これらは、Anthropic で Managed Agent セッションを作成および実行し、サービス アカウントに代わって GitHub にアクセスするためにのみ使用されます。


Jira 向け Claude Agent に作業を割り当てる

設定が完了すると、任意の Jira 作業項目から 2 つの方法で Jira 向け Claude Agent に作業を依頼できます。

エージェントを担当者として追加する

Jira 向け Claude Agent に作業を割り当てるには、次の手順に従います。

  1. エージェントに作業してもらいたい Jira の作業項目をオープンする。

  2. 作業項目に [概要]、[説明]、および [リポジトリ] が入力されていることを確認する。

  3. [担当者] フィールドで、Jira 向け Claude Agent を選択する。

割り当て後、新しいエージェント セッションが開始されます。作業項目の要約、説明、およびリポジトリ リンクが Anthropic に送信されます。エージェントの作業の進行につれて、作業項目のエージェント セッション パネルにアクティビティが表示されます。

エージェントが処理を完了すると、通常、変更を GitHub リポジトリにプッシュし、サービス アカウントからプル リクエストの下書きをオープンします。

コメントでエージェントをメンションする

コメントで Jira 向け Claude Agent をトリガーするには、次の手順に従います。

  1. エージェントに処理してもらいたい作業項目をオープンする。

  2. [アクティビティ] セクションで、タスクを説明するコメントを追加します。

  3. Jira 向け Claude エージェントに @メンションします。例: @Claude Agent for Jira

エージェントをメンションすると、作業項目の要約、説明、リポジトリ リンク、およびコメントを追加の指示として使用して、新しいエージェント セッションが開始されます。エージェントの処理が完了したら、作成されたプル リクエストと Jira コメントをレビューしてください。


アトラシアンと Claude Managed Agents の連携方法

データとその行き先

  • Jira からアトラシアンのサービスへ — 作業項目で Jira 向け Claude Agent を呼び出すと、Jira は作業項目の要約と説明 (および関連するリポジトリのコンテキスト) を、アトラシアンの対話型 AI サービスと Claude Agent for Jira Forge アプリを介して送信します。

  • アトラシアンから GitHub へ — Jira 向け Claude Agent は、お客様の Claude API キーを使用して Anthropic のインフラストラクチャ内に Managed Agent セッションを作成し、お客様の GitHub トークンを使用して、お客様が管理するサービス アカウントからコードの読み書きやプル リクエストのオープンを行います。

利用規約と責任

Anthropic のサービス利用規約に同意し、ご自身の API キーを用意する必要があります。Claude Managed Agents におけるお客様のデータの処理および保持方法には、Anthropic の利用規約が適用されます。

お客様が管理する範囲

  • GitHub サービス アカウントがアクセスできるリポジトリ

  • どの Jira 作業項目をエージェントに割り当てるか

  • Anthropic の Console におけるセッションとファイルの保持期間

Jira 向け Claude Agent では、ゼロデータ保持 (ZDR) はサポートされていません。Claude Managed Agents はステートフルな製品です。Anthropic は長時間実行されるエージェントを継続して実行し、Anthropic Console で監視できるように、セッション状態を保持します。保持される状態には、イベント履歴、ツール呼び出しのトレース、コンテナーのチェックポイント、マウントされたファイルなどが含まれます。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。