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 をインストールするには、次の手順に従います。
Atlassian Marketplace の Jira 向け Claude Agent のリスト に移動して、[今すぐ入手] を選択します。
アプリをインストールする Jira Cloud サイトを選択します。
インストールを確認します。
インストールが完了すると [設定] 画面に移動するので、ここで Jira 向け Claude Agent をセットアップします。また、アプリは [設定] > [アプリ] > [アプリの管理] からいつでも確認できます。
必要な API キーとアクセス トークンを作成します。
Jira 向け Claude Agent を設定するには、2 つの認証情報が必要です。
Claude Managed Agents API キー — Anthropic 用
GitHub 個人用アクセス トークン — GitHub サービス アカウント用
Claude API キーを作成する
API キーを作成するには、次の手順に従います。
Anthropic Console をオープンし、使用するワークスペースに切り替えます。
[設定] > [API キー] に移動します。
[Create new API key (新しい API キーを作成)] を選択します。
キーにはわかりやすい名前を付けてください。例:
claude-agent-for-jira。API キーを保存してコピーします。これを Jira の構成画面に貼り付けます。
GitHub の個人用アクセス トークンを作成する
GitHub の個人用アクセス トークンを作成するには、次の手順に従います。
マシンのユーザー アカウントを使用して GitHub にサインインします。
[設定] > [開発者設定] > [個人用アクセス トークン] の順に移動します。
マシン アカウントの新しいトークンを作成する。
組織のポリシーに応じて、クラシックまたはきめ細かなトークンを使用します。
わかりやすい名前を付けます。例:
claude-agent-for-jira-service-token。最低限、リポジトリのコンテンツ (読み取り/書き込み) およびプル リクエスト (読み取り/書き込み) を付与します。
きめ細かいトークンを使用する場合、リポジトリを所有する組織にスコープを設定し、エージェントに変更させるリポジトリを明示的に許可します。
トークンを生成してコピーします。
後でエージェントに追加のリポジトリへのアクセス権を付与するには、GitHub の設定で GitHub の個人用アクセス トークンのリポジトリ権限をアップデートします。
Jira 向け Claude Agent を構成する
Jira 向け Claude Agent を構成するには、次の手順に従います。
Jira で、[設定] > [アプリ] > [アプリの管理] の順に移動します。
Jira 向け Claude Agent を見つけて、[設定] を選択します。
Claude Managed Agent API キーを追加する — Claude Managed Agent API キーを [CMA] フィールドに貼り付け、[Create agent (エージェントを作成)] を選択します。Jira は Anthropic の Managed Agents API を呼び出し、既定のエージェントと環境を作成します。エージェントには、コード作成タスク用のシステムプロンプト、組み込みツール、および GitHub へのアクセスが事前設定されているため、コードの読み書きやプル リクエストのオープンを行うことができます。確認するには、Anthropic コンソールを開き、[Managed Agents] に移動して新しいエージェントを確認し、[環境] に移動して使用されている環境を確認します。
GitHub トークンを追加する — GitHub の個人用アクセス トークンを [GitHub token (GitHub トークン)] フィールドに貼り付けて、[保存] を選択します。
両方のトークンが検証されて保存されると、Jira 向け Claude Agent を使用できるようになります。
認証情報は、アトラシアンの Forge キーバリュー ストアに保存され、保存時に暗号化されます。これらは、Anthropic で Managed Agent セッションを作成および実行し、サービス アカウントに代わって GitHub にアクセスするためにのみ使用されます。
Jira 向け Claude Agent に作業を割り当てる
設定が完了すると、任意の Jira 作業項目から 2 つの方法で Jira 向け Claude Agent に作業を依頼できます。
エージェントを担当者として追加する
Jira 向け Claude Agent に作業を割り当てるには、次の手順に従います。
エージェントに作業してもらいたい Jira の作業項目をオープンする。
作業項目に [概要]、[説明]、および [リポジトリ] が入力されていることを確認する。
[担当者] フィールドで、Jira 向け Claude Agent を選択する。
割り当て後、新しいエージェント セッションが開始されます。作業項目の要約、説明、およびリポジトリ リンクが Anthropic に送信されます。エージェントの作業の進行につれて、作業項目のエージェント セッション パネルにアクティビティが表示されます。
エージェントが処理を完了すると、通常、変更を GitHub リポジトリにプッシュし、サービス アカウントからプル リクエストの下書きをオープンします。
コメントでエージェントをメンションする
コメントで Jira 向け Claude Agent をトリガーするには、次の手順に従います。
エージェントに処理してもらいたい作業項目をオープンする。
[アクティビティ] セクションで、タスクを説明するコメントを追加します。
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 で監視できるように、セッション状態を保持します。保持される状態には、イベント履歴、ツール呼び出しのトレース、コンテナーのチェックポイント、マウントされたファイルなどが含まれます。
この内容はお役に立ちましたか?