> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# JiraをCognoに連携する

> Jiraを連携すると、Projectごとに選んだJiraプロジェクトで作業し、エージェントが課題を読み取り・更新できます。

![Jira](https://mintcdn.com/genaxis/AWoMBbN1yOTNqJwY/images/integrations/jira.svg?fit=max\&auto=format\&n=AWoMBbN1yOTNqJwY\&q=85\&s=7203b2f011309f7e6f9801251de4894c)

## 概要

| | |
| - | - |
| **方向** | 双方向 — エージェントが課題を読み取り、許可した場合に限り変更します。 |
| **接続方法** | Atlassian OAuth — ワンクリック。 |
| **設定できる人** | viewer以外のワークスペース member。 |
| **必要なもの** | 接続したいJiraサイトにアクセスできるAtlassianアカウント。 |

Jiraを接続すると、Projectごとに作業するJiraプロジェクトを選べます。そのProjectのエージェント実行は、選んだプロジェクトの課題を検索・読み取りでき、許可した場合は作成・編集・コメント・遷移もできます。Projectが選んだJiraプロジェクトの外には届きません。

## 事前確認

* 対象ワークスペースのmemberで、ロールがviewerではない。
* Cognoに使わせたいJiraプロジェクトを閲覧できるAtlassianアカウントにサインインしている。

## CognoでJiraを接続する

**1. Jiraを探す**

**連携** を開き、**Jira** を探します。

**2. Atlassianを認可する**

**接続** を押します。ブラウザでAtlassianの認可画面が開くので、Jiraサイトを選んで承認します。

**3. 接続を確認する**

Cognoに戻るとJiraのページが開きます。接続行にサイト（例: `acme.atlassian.net`）が **接続済み** として表示されます。

## Cognoが使えるJiraプロジェクトを見る

**Jiraプロジェクト** セクションに、この接続で閲覧できるプロジェクトが、名前・キー・種別（**ソフトウェア**・**ビジネス**・**サービス管理**）と、Jiraで開くリンクつきで並びます。一覧を最後に更新した時刻は接続行に表示されます（**最終同期** — または **未同期**）。

Cognoは接続した直後にこの一覧を作り、以後6時間ごとに更新します。今すぐ更新するには、接続行の **⋯** メニューから **プロジェクトを同期** を選びます。更新には数秒かかります。

## ProjectのJiraプロジェクトを選ぶ

Jiraを接続しただけでは、どのProjectにもアクセスは与えられません。Projectごとに自分のJiraプロジェクトを選びます。

**1. Projectの設定を開く**

Projectを開いて設定に進み、**Projectの連携** の中の **Jira** を探します。

**2. Jiraプロジェクトを選ぶ**

**Jira** を展開し、**対象Project** でこのProjectが作業するJiraプロジェクトを選びます。

選択肢は、連携ページの **Jiraプロジェクト** セクションと同じプロジェクトです。

> [!NOTE]
>
> Jiraプロジェクトを1つも選んでいないProjectは、どのJira課題にも届きません。Jiraツールはサイト全体を検索するのではなく、呼び出しを拒否します。

## エージェントツールのアクセスを設定する

**エージェントツール** セクションで、Engine管理の実行がこの接続で行える操作を決めます。機能ごとに **ブロック**、**確認**、**許可** を選びます。変更は次の実行から反映され、接続を解除するとすぐに利用できなくなります。

| 機能 | 許可される操作 | 既定値 |
| - | - | - |
| **Jiraを読み取る** | Projectで選択したJiraプロジェクトの課題・コメント・トランジションの検索と読み取り。 | **許可** |
| **Jiraに書き込む** | Projectで選択したJiraプロジェクトでの課題の作成・編集、コメントの追加、ワークフローの遷移。 | **許可** |

各機能の下にある **ツール** に、その機能が付与するツールがすべて並びます。Workspaceの値が上限です。Projectではこの接続について継承または縮小できますが、広げることはできません。詳しくは [連携](/docs/ja/integrations.md) のTool権限の説明を参照してください。

## 接続を解除する

接続行の **⋯** メニューから **接続を解除** を選び、確認します。

## よくある状態

| State | Meaning | Next action |
| - | - | - |
| **Jiraプロジェクトはまだありません。** | 一覧がまだ作られていないか、アカウントで閲覧できるプロジェクトがない | **プロジェクトを同期** を選び、Jiraのプロジェクト権限を確認します |
| 作ったばかりのプロジェクトが無い | 作成後にまだ更新されていない | **プロジェクトを同期** を選びます |
| **Jiraプロジェクトを読み込めませんでした。** | プロジェクト一覧を読み込めなかった | ページを再読み込みします |
| エージェントが「Jiraプロジェクトが選択されていない」と返す | ProjectのJiraの対象が空 | Projectの設定でJiraプロジェクトを選びます |

## 参照URL

* [Atlassian: 接続済みアプリの管理](https://support.atlassian.com/atlassian-account/docs/manage-your-profile-and-connected-apps/)

## 関連docs

* [連携](/docs/ja/integrations.md)
* [Projects](/docs/ja/projects.md)
* [Troubleshooting](/docs/ja/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.