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

# Atlassian

> Atlassian Jira と Confluence を CloudThinker に接続して課題追跡、ナレッジベース、プロジェクト管理を行う

Atlassian 組織を接続して、CloudThinker エージェントが Jira 課題の追跡、Confluence ナレッジの検索、インシデント対応とコードレビュー中のチケットコンテキストの取得を行えるようにします。CloudThinker は Atlassian の **Rovo MCP サーバー** を経由してドメイン許可リストにより接続します。

***

## 前提条件

* いずれかのプラン（Free、Standard、Premium、Enterprise）の **Atlassian Cloud** 組織。
* Atlassian Administration で CloudThinker ドメインを追加するための **Organization Admin** ロール。

<Info>
  Atlassian AI 設定でドメインを追加できるのは Organization Admin のみです。追加後、すべてのワークスペースメンバーが既存の権限の範囲内でこの連携を使用できます。
</Info>

***

## セットアップ

<Steps>
  <Step title="Atlassian Administration を開く">
    [admin.atlassian.com](https://admin.atlassian.com) → **Apps → AI settings → Rovo MCP server** に移動します。
  </Step>

  <Step title="CloudThinker ドメインを追加する">
    **Add domain** をクリックして以下を入力します：

    ```
    https://app.cloudthinker.io/**
    ```

    **Save** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/GO078to2qMKOXjFU/images/atlassian-integration.png?fit=max&auto=format&n=GO078to2qMKOXjFU&q=85&s=ecd87846f4782ae0d0202c02f0cf65c0" alt="Rovo MCP サーバーの許可リストに CloudThinker ドメインが表示された Atlassian AI 設定" width="3024" height="1716" data-path="images/atlassian-integration.png" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Atlassian AI 設定 — Rovo MCP サーバーのドメイン許可リスト</p>
  </Step>

  <Step title="IP 許可リストを設定する（該当する場合）">
    組織が IP 許可リストを適用している場合は、**Atlassian Administration** で許可リストを設定します（AI 設定ではありません）。信頼済みドメインであっても、リクエストは許可された IP から送信される必要があります。

    保存後、CloudThinker は Atlassian 連携の **Connected** ステータスを表示します。
  </Step>
</Steps>

***

## 接続の詳細

| フィールド         | 説明                                          | 値                                |
| ------------- | ------------------------------------------- | -------------------------------- |
| **許可されたドメイン** | Rovo MCP サーバーの許可リストに追加された CloudThinker ドメイン | `https://app.cloudthinker.io/**` |
| **接続タイプ**     | 認証メカニズム                                     | Rovo MCP サーバーのドメイン許可リスト          |

***

## 必要な権限

* ドメインのセットアップ中にドメインを追加するには **Organization Admin** ロールが必要です。
* 接続後、エージェントは**認可ユーザーの既存の権限**で動作します — CloudThinker はユーザーが参照できない Jira プロジェクトや Confluence スペースにはアクセスできません。

<Tip>
  最小権限の原則に従い、Atlassian の権限が CloudThinker に必要なものと完全に一致するユーザーアカウントから接続を認可してください。
</Tip>

***

## エージェントの機能

接続後、エージェントは認可ユーザーの権限の範囲内で Jira および Confluence データにアクセスできます。

| 機能                      | 説明                                |
| ----------------------- | --------------------------------- |
| **Jira 課題の検索**          | プロジェクトとスプリント全体の課題を検索・取得する         |
| **Jira 課題の管理**          | 課題の作成、更新、コメント追加                   |
| **Confluence の検索**      | ページとスペースを検索・読み取る                  |
| **プロジェクト・スプリントのコンテキスト** | インシデント対応とコードレビュー中にチケットコンテキストを取得する |

### 接続を確認する

```text theme={null}
@alex list open Jira issues from the PLATFORM project and summarize blockers
```

### プロンプト例

```text theme={null}
@alex find all open Jira issues blocking the current sprint and #report priority and assignee
@alex search Confluence for the incident response runbook
@oliver find all open Jira security issues and summarize the critical ones
```

***

## トラブルシューティング

<Accordion title="ドメインが許可リストにない">
  CloudThinker はドメインが保存されていないため接続できません。admin.atlassian.com → Apps → AI settings → Rovo MCP server に戻り、`https://app.cloudthinker.io/**` がリストに表示されていることを確認してください。
</Accordion>

<Accordion title="IP 許可リストがリクエストをブロックしている">
  ブロックされた IP のユーザーは、ドメインが許可リストに登録されていてもアクセス許可エラーが表示されます。Atlassian Administration（AI 設定ではない）で CloudThinker の IP を追加し、リクエストが許可されたアドレスから発信されていることを確認してください。
</Accordion>

<Accordion title="Jira プロジェクトまたは Confluence スペースへのアクセスが拒否された">
  CloudThinker は認可ユーザーの権限で動作します。認可ユーザーがエージェントにアクセスさせたい Jira プロジェクトと Confluence スペースへのアクセス権を持っていることを確認してください。
</Accordion>

<Accordion title="CloudThinker に接続が表示されない">
  ドメイン許可リストの変更が反映されるまで数分かかる場合があります。少し待ってから、CloudThinker の Connections ページを更新してください。
</Accordion>

***

## セキュリティ

* **最小権限** — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
* **デフォルトで読み取り専用** — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
* **認証情報のローテーション** — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
* **オフボーディング時に失効** — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

- **Organization Admin のみ** — Organization Admin のみが CloudThinker ドメインを追加・削除できます。この権限リストを定期的に監査してください。
- **ユーザー範囲のアクセス** — CloudThinker のアクションは認可ユーザーの Atlassian 権限によって制限されます。常に最小権限のアカウントから認可してください。

***

## 関連

<CardGroup cols={2}>
  <Card title="GitGuardian 接続" icon="https://mintcdn.com/cloudthinker/tTYzPaZv-jtM39C4/images/icons/gitguardian.svg?fit=max&auto=format&n=tTYzPaZv-jtM39C4&q=85&s=b89a979a6dd2d28506ae7517286d83e4" href="/ja/guide/connections/gitguardian" width="24" height="24" data-path="images/icons/gitguardian.svg">
    シークレットインシデントを Jira 課題として追跡する
  </Card>

  <Card title="ServiceNow 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/servicenow.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=3fee0d3d5346b20beb018bcf854e968e" href="/ja/guide/connections/servicenow" width="24" height="24" data-path="images/icons/servicenow.svg">
    ITSM インシデント管理
  </Card>
</CardGroup>