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

# Jira 認証情報

AtlassianのJira APIトークンを設定して、Jinba FlowのワークフローからJiraのイシューとプロジェクト進捗を管理します。

## 前提条件

* Jira Cloudサイトにアクセスできるatlassianアカウント
* APIトークンの作成権限（すべてのAtlassianアカウントで利用可能）

## Jira APIトークンの作成

<Warning>
  **「個人」APIトークンを作成してください。「組織」APIキーではありません。** この2つは
  別物で、Jiraで使えるのは一方だけです：

  * ✅ **個人APIトークン** —
    [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
    で作成。Jiraのデータにアクセスできます。
  * ❌ **組織APIキー** — 管理コンソール（`admin.atlassian.com/o/<org>/api-keys`）で作成。
    組織管理スコープ（`manage:org`, `*:admin`）しか持たず、**Jira課題の作成・取得は一切できません**。
    どれだけスコープにチェックを入れても `401 Unauthorized` になります。
</Warning>

1. [id.atlassian.com](https://id.atlassian.com) でAtlassianアカウントにサインイン
2. **セキュリティ** → **APIトークン** に移動
3. **APIトークンを作成** をクリック
4. ラベル（例: `Jinba Flow`）を入力して **作成** をクリック
5. 生成されたトークンをコピー（一度しか表示されません）

直接リンク: [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)

<Note>
  **クラシックトークン（接頭辞 `ATATT…`）を推奨します** — アカウントの全権限を持ち、
  スコープ設定が不要です。スコープ付きトークン（`ATCTT…`）も動作し、`api.atlassian.com`
  ゲートウェイ経由で自動ルーティングされますが、必要なスコープを自分で付与する必要があります。
  どちらの場合も `base_url` はサイトURL（`https://your-domain.atlassian.net`）のままにしてください。
</Note>

## Jinba Flowへの設定

1. Jinba Flowのワークスペース設定を開く
2. **シークレット** セクションに移動
3. **Jira** を見つけて **追加** をクリック
4. APIトークンを入力：
   * **APIトークン**: Atlassianからコピーしたトークン
5. **保存** をクリック

## Jiraステップの設定

各Jiraツールのステップには、シークレットに加えて以下の設定フィールドが必要です：

| フィールド       | 説明                     | 例                                   |
| ----------- | ---------------------- | ----------------------------------- |
| `base_url`  | JiraサイトのURL            | `https://your-domain.atlassian.net` |
| `email`     | Atlassianアカウントのメールアドレス | `you@example.com`                   |
| `api_token` | 保存したJiraシークレットを選択      | —                                   |

## JiraサイトURLの確認方法

Jira CloudのベースURLは `https://<your-domain>.atlassian.net` の形式です。Jiraボードを表示している際のブラウザのアドレスバーで確認できます。

## ユーザーのアカウントIDの確認方法

Jiraはユーザーを名前やメールアドレスではなく`accountId`で識別します。アカウントIDを確認するには：

1. ユーザーのJiraプロフィールを開く
2. URLにアカウントIDが表示されます: `.../jira/people/<accountId>`

または、`JIRA_SEARCH_ISSUES`やJiraのユーザー検索APIを使用してプログラムからアカウントIDを検索できます。