Jira Pilot

Jira Pilot ✈️

人とエージェントのための、AI 搭載 Jira CLI および MCP サーバーです。

jira-pilot は、従来の開発者ツールと最新の AI 機能を組み合わせた次世代の CLI です。

• 人向け： 課題、スプリント、ボード、コードを管理するための、使いやすくインタラクティブな CLI です。AI コードレビュー、エピック計画、デイリースタンドアップ、自然言語 JQL も利用できます。
• エージェント向け： AI アシスタント（Claude Desktop、Cursor、Gemini など）が Jira インスタンスを安全に操作できる、14 個のツールを備えた完全準拠の Model Context Protocol（MCP） サーバーです。

---

主な機能

👤 人向けの機能

機能	説明
課題管理	課題の作成、編集、表示、一覧表示、トランジション、担当者設定、コメント追加
作業と時間	新機能： 作業時間の記録（2h 30m）、スプリント管理（開始／完了）、サブタスク
開発者ツール	新機能： PR を開く、ローカルフィルターを保存、git ブランチ連携
パワーツール	新機能： JQL に一致する課題の一括担当者設定、一括ラベル付与、一括トランジション
高度なデータ管理	新機能： 添付ファイルのアップロード、エイリアスによるカスタムフィールドの管理
AI コパイロット	要約、説明文の下書き、アクションの提案、コードレビュー、エピック計画、スタンドアップレポート
インタラクティブウィザード	enquirer による手順ごとのプロンプト — フラグは不要です
豊富な可視化	ダッシュボードの概要、スピナー、整形済みの出力
エクスポート	JSON または Markdown ファイルへの出力、パイプ可能な JSON 出力

🤖 エージェント機能（MCP）

機能	説明
14 個の MCP ツール	list_issues、get_issue、create_issue、update_issue、transition_issue、assign_issue、add_comment、add_worklog、create_subtask、add_attachment、search_users、myself、list_projects、list_sprints
LLM に最適化	トークンを効率的に使用できる、クリーンで構造化された JSON レスポンス
Stdio トランスポート	標準的な MCP stdio サーバー — あらゆる MCP クライアントで動作します

---

🚀 インストール

前提条件

• Node.js 20.0.0 以降

グローバルインストール（推奨）

npm install -g jira-pilot

インストール後、jira コマンドをグローバルに利用できます。

---

⚙️ 設定

ツールを使用する前に、認証情報を設定してください。API トークンは Atlassian Account Settings から取得できます。

初期設定

jira config setup

以下の項目を入力します。

1. Jira サイト URL — 例：https://your-company.atlassian.net
2. メールアドレス — Atlassian アカウントのメールアドレス
3. API トークン — Atlassian で生成したトークン
4. AI を有効化 — AI 機能のオン／オフを切り替えます
5. AI プロバイダー — openai、gemini、anthropic から選択します
6. AI API キー — 選択したプロバイダーの API キー

プロファイルと管理

複数の環境（例：仕事用と個人用、本番環境と開発環境）の認証情報を管理できます。

jira config view              # Show current configuration (keys are masked)
jira config save work         # Save current creds as profile 'work'
jira config use personal      # Switch to profile 'personal'
jira config profiles          # List all saved profiles
jira config delete-profile work
jira config clear             # Remove all stored credentials

カスタムフィールドのエイリアス

コマンドを簡単に使えるよう、カスタムフィールド ID のエイリアスを定義します。

jira config field set points customfield_10011
jira config field list

---

✨ インタラクティブな操作

Jira Pilot は、すべての操作をインタラクティブに行えるよう設計されています。複雑なフラグを覚える必要はありません。

コマンドを実行するだけで、操作方法をご案内します。

1. 選択：矢印キー ↑ ↓ を使って、リスト（プロジェクト、課題タイプ、優先度）を移動します。
2. 絞り込み：入力を始めると、長いリストを絞り込めます（例：特定の担当者を検索）。
3. ウィザード：課題の作成などの複雑な操作は、簡単な手順に分かれています。
4. 確認：破壊的な操作を行う前に、確認を求めます（y/N）。

例：

jira issue create
? Select Project: PROJ - My Project
? Select Issue Type: Bug
? Summary: Login page crashes
? Priority: High
? Assignee: Me

---

🖥️ テキストユーザーインターフェース（TUI）

Jira を、状態が維持されるインタラクティブなターミナルインターフェースで操作できます。

jira tui

主な機能：

• ダッシュボード：自分に割り当てられた作業の概要を表示します。
• 課題ナビゲーター：課題の閲覧、絞り込み、詳細表示を行います。
• カンバンボード：アジャイルボード上の作業を視覚化して管理します。
• インタラクティブ操作：矢印キーを使って行や列を移動します。

ナビゲーションのショートカット：

• ← / → ：タブ（ダッシュボード、課題、ボード）またはボードの列を切り替えます
• ↑ / ↓ ：リストを移動します
• Enter ：選択／詳細を表示します
• Esc / b ：戻ります
• q ：終了します

---

📊 マイダッシュボード

その日の作業を始めるときに、担当作業の概要を確認できます。

jira dashboard

表示される内容：

• 👋 ウェルカムメッセージ：個人に合わせた挨拶です。
• 🔥 高優先度：自分に割り当てられた、すぐに対応が必要な課題です。
• 📋 最近のアクティビティ：最近表示または更新した課題です。
• 🚀 スプリントのステータス：（該当する場合）アクティブなスプリントの進捗状況です。

---

📖 使い方ガイド

📋 課題管理

課題の一覧表示

# List issues assigned to you in active sprints (interactive)
jira issue list

# List with custom JQL
jira issue list --jql "project = PROJ AND priority = High"

# Filter by project, assignee, or status via flags
jira issue list --project PROJ --assignee "john.doe" --status "In Progress"

# Limit results
jira issue list --limit 20

# Natural Language JQL (AI)
jira issue list --ask "high priority bugs assigned to me"

# Export results to file
jira issue list --export json    # Creates issues-TIMESTAMP.json
jira issue list --export md      # Creates issues-TIMESTAMP.md

# Pipeable JSON output (to stdout)
jira issue list --output json | jq .

課題の検索

JQL text ~ "query" を使った簡易テキスト検索：

jira issue search "login bug"
jira issue search "error 500" --project PROJ

課題の詳細表示

jira issue view PROJ-123

表示内容：要約、ステータス、優先度、担当者、説明、コンポーネント、ラベル、日付、バージョン、最近のコメント。

課題の作成

# Interactive wizard (recommended)
jira issue create

# Non-interactive with flags for speed
jira issue create -p PROJ -s "Fix login bug"
jira issue create -p PROJ -t Bug -s "Crash on save" --priority High
jira issue create -p PROJ -t Story -s "Add dark mode" -d "Users want a dark theme" -a me

# With Custom Fields (using Alias or ID)
jira issue create -p PROJ -s "Story" --custom "points=5" --custom "customfield_10022=DevOps"

課題の編集

# Interactive Field Picker
jira issue edit PROJ-123

# Quick Edits
jira issue edit PROJ-123 -s "New Summary" --priority High
jira issue edit PROJ-123 -d "New description"
jira issue edit PROJ-123 --custom "points=8"

課題のステータスを遷移

# Interactive — shows available transitions
jira issue transition PROJ-123

# Direct — specify target status
jira issue transition PROJ-123 --status "In Progress"
jira issue transition PROJ-123 -s Done

割り当て／再割り当て

# Interactive — choose Myself, Unassign, or Search
jira issue assign PROJ-123

# Quick assign
jira issue assign PROJ-123 -a me       # Assign to yourself
jira issue assign PROJ-123 -a none     # Unassign

コメントの追加

# Interactive — prompts for comment text
jira issue comment PROJ-123

# Inline comment
jira issue comment PROJ-123 -m "Fixed in latest build"

その他の操作

# Link Issues
jira issue link PROJ-123 PROJ-456 -t Blocks

# Watchers
jira issue watch PROJ-123
jira issue unwatch PROJ-123

# Attachments
jira issue attach PROJ-123 ./logs/server.log

---

⏱️ 作業と時間

作業ログ

課題ごとの作業時間を自然に記録できます。

# Add worklog
jira issue worklog add PROJ-123 2h "Researching API"
jira issue worklog add PROJ-123 30m "Daily standup"
jira issue worklog add PROJ-123 1d "Implementation"

# List worklogs
jira issue worklog list PROJ-123

サブタスク

# Interactive subtask creation
jira issue subtask PARENT-123

# Quick subtask
jira issue subtask PARENT-123 -s "Implement backend logic" --assignee me

スプリント管理

アジャイルボードを直接管理できます。

# List sprints
jira sprint list --board "My Board"
jira sprint list --board 5 --state active

# List issues in active sprint
jira sprint issues --board 5

# Start/Complete Sprints
jira sprint start 123 --start-date 2023-10-01 --end-date 2023-10-15
jira sprint complete 123

---

👨‍💻 開発者のワークフロー

プルリクエスト

Jira の課題からタイトルと本文をあらかじめ入力した状態で、GitHub PR を開きます。

jira issue pr PROJ-123
# Requires 'gh' CLI to be installed and authenticated

Git 連携

課題の要約をもとに自動で名前を付けたフィーチャーブランチを作成します。

jira git branch PROJ-123
# Creates: feature/PROJ-123-issue-summary-slug

保存済みフィルター

複雑な JQL クエリをローカルに保存して、すぐに呼び出せます。

# Save a filter
jira filter save "My Bugs" "assignee = currentUser() AND issuetype = Bug AND status != Done"

# List saved filters
jira filter list

# Use a saved filter
jira issue list --filter "My Bugs"

# Delete a filter
jira filter delete "My Bugs"

---

⚡ パワーツール（一括操作）

JQL クエリに一致する複数の課題に対して操作を実行します。整理や一括更新に便利です。

一括遷移

複数の課題を新しいステータスに移動します。

jira bulk transition -j "project = PROJ AND status = 'To Do'" -s "In Progress"
# Optional: -y to skip confirmation

一括割り当て

複数の課題をユーザーに割り当てます。

jira bulk assign -j "priority = High AND assignee is EMPTY" --assignee me

ラベルの一括操作

複数の課題にラベルを追加または削除します。

jira bulk label -j "fixVersion = 1.0" --add "release-candidate" --remove "wip"

---

📂 プロジェクトとボード

プロジェクトの一覧表示

jira project list
# Displays: project key, name, lead, and style in a formatted table.

ボードの一覧表示

# List all boards
jira board list

# Filter by project
jira board list -p PROJ

# Filter by type
jira board list -t scrum
jira board list -t kanban

---

🤖 AI 機能

必要条件： config setup で AI を有効にしてください。

課題の要約

コメントを含む長い課題スレッドを、AI が生成した簡潔な要約（TL;DR）にします。

jira ai summarize PROJ-123

課題の説明文の下書き

大まかなメモや箇条書きから、構造化された課題の説明文を生成します。

# Interactive — prompts for your notes
jira ai draft

# Inline with issue type context
jira ai draft -i "login fails, returns 500, only on mobile" -t bug
jira ai draft -i "add dark mode toggle to settings" -t story

次のアクションの提案

課題を分析し、次に何をすべきかについて AI による提案を取得します。

jira ai suggest PROJ-123

返される内容：次にすぐ行うアクション、潜在的なブロッカー、推奨されるステータス遷移、推奨事項。

AI コードレビュー

リンクされた PR やコード変更を、課題の要件に照らして分析します。

jira ai review PROJ-123

設定に githubToken が必要です。

AI エピック計画

エピックを子ストーリー／タスクに分割し、それらを一括作成します。

jira ai plan EPIC-123    # Interactive selection of proposed tasks

AI スタンドアップレポート

最近のアクティビティに基づいて、毎日のスタンドアップレポートを生成します。

jira ai standup

出力：昨日、今日、ブロッカー。

---

🧠 AI エージェントでの使用（MCP）

jira-pilot は Model Context Protocol（MCP） を実装しており、AI アシスタントにプラグアンドプレイで接続できます。

MCP サーバーの起動

jira mcp

利用可能な MCP ツール（14）

完全自律型 Jira エージェントの構築に必要なすべてがそろっています。

1. jira_list_issues：JQL で検索します（上限数を指定できます）
2. jira_get_issue：詳細情報を取得します
3. jira_create_issue：新しい課題を作成します（ADF に対応）
4. jira_update_issue：要約、説明、優先度、担当者を更新します
5. jira_transition_issue：ステータスを変更します
6. jira_assign_issue：担当者を変更します
7. jira_add_comment：コメントを追加します
8. jira_add_worklog：作業時間を記録します
9. jira_create_subtask：サブタスクを作成します
10. jira_add_attachment：ファイルをアップロードします（絶対パス）
11. jira_search_users：ユーザーを検索します
12. jira_myself：現在のユーザーの詳細を取得します
13. jira_list_projects：アクセス可能なプロジェクトを一覧表示します
14. jira_list_sprints：ボードのスプリントを一覧表示します

エージェントの設定（Claude Desktop）

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-pilot", "mcp"]
    }
  }
}

VS Code / Cursor の設定

.vscode/mcp.json または同等のファイルに追加します。

{
  "servers": {
    "jira-pilot": {
      "command": "jira",
      "args": ["mcp"]
    }
  }
}

📝 プロンプト

LLM が Jira を効果的に操作するための事前定義済みテンプレートです。

プロンプト	引数	説明
jira-assist	なし	Jira Pilot のツールを最適に使う方法を LLM に教えるシステムプロンプトです。
jira-summarize-issue	issueKey	課題を取得し、簡潔な要約を作成するよう LLM に指示します。

📦 リソース

コンテキストとして Jira データに直接アクセスできます。

URI	説明
jira://myself	現在認証されているユーザーの詳細情報（機密性の高い個人情報を除く）です。
jira://projects	アクセス可能なすべての Jira プロジェクトの一覧です。

🔍 検証

公式インスペクターを使用して、MCP サーバーの実装を検証できます。

# If running fro source
npx @modelcontextprotocol/inspector node dist/bin/jira.js mcp

# If installed globally (or via npx)
npx @modelcontextprotocol/inspector npx -y jira-pilot mcp

---

📦 CLI コマンドリファレンス

すべてのオプションを確認するには、jira help または jira [command] help を実行します。

jira [command]

Commands:
  config           Configure Jira credentials & profiles
  issue            Manage Jira issues
  project          Manage Jira projects
  board            Manage Jira boards
  sprint           Manage Sprints
  bulk             Bulk operations on Jira issues
  dashboard        Show a quick overview of your Jira activity
  git              Git integration for Jira
  ai               AI Helper commands
  mcp              Start MCP Agent Server (Stdio)

---

🤝 コントリビューション

コントリビューションを歓迎します。プルリクエストの送信方法と開発環境のセットアップについては、CONTRIBUTING.md をご覧ください。

このプロジェクトには Contributor Code of Conduct が適用されます。このプロジェクトに参加することで、その規約に従うことに同意したものとみなされます。

🛡️ セキュリティ

このプロジェクトのセキュリティ脆弱性を発見した場合は、報告方針について SECURITY.md をご確認ください。

📄 ライセンス

ISC