jira-automation

Rube MCP による Jira の自動化

Rube MCP 経由で Composio の Jira ツールキットを使用して、Jira の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/jira

前提条件

• Rube MCP が接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット jira を指定した RUBE_MANAGE_CONNECTIONS 経由で、Jira への接続が有効である必要があります
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加してください。API キーは不要です。エンドポイントを追加するだけで使用できます。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット jira を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Jira OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

基本的なワークフロー

1. 課題の検索とフィルタリング

使用する場面：ユーザーが JQL を使って課題を検索する場合や、プロジェクトの課題を閲覧する場合

ツールの呼び出し順序：

1. JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST - JQL クエリで検索します［必須］
2. JIRA_GET_ISSUE - 特定の課題の詳細を取得します［任意］

主なパラメーター：

• jql：JQL クエリ文字列（例：project = PROJ AND status = "In Progress"）
• maxResults：ページごとの最大結果数（デフォルトは 50、最大 100）
• startAt：ページネーションのオフセット
• fields：返すフィールド名の配列
• issueIdOrKey：GET_ISSUE 用の「PROJ-123」のような課題キー

注意点：

• JQL のフィールド名は大文字と小文字が区別され、Jira の設定と一致している必要があります
• カスタムフィールドには表示名ではなく、customfield_10001 のような ID を使用します
• 結果はページネーションされます。続きがあるかどうかを確認するには、total と startAt + maxResults を比較してください

2. 課題の作成と編集

使用する場面：ユーザーが新しい課題を作成する場合や、既存の課題を更新する場合

ツールの呼び出し順序：

1. JIRA_GET_ALL_PROJECTS - プロジェクトキーを探すため、プロジェクト一覧を取得します［前提条件］
2. JIRA_GET_FIELDS - 利用可能なフィールドとその ID を取得します［前提条件］
3. JIRA_CREATE_ISSUE - 新しい課題を作成します［必須］
4. JIRA_EDIT_ISSUE - 既存の課題のフィールドを更新します［任意］
5. JIRA_ASSIGN_ISSUE - 課題をユーザーに割り当てます［任意］

主なパラメーター：

• project：プロジェクトキー（例：'PROJ'）
• issuetype：課題タイプ名（例：'Bug'、'Story'、'Task'）
• summary：課題のタイトル
• description：課題の説明（Atlassian Document Format またはプレーンテキスト）
• issueIdOrKey：編集する課題のキー

注意点：

• 課題タイプと必須フィールドはプロジェクトによって異なります。GET_FIELDS を使用して確認してください
• カスタムフィールドには表示名ではなく、正確なフィールド ID が必要です
• リッチコンテンツを含む場合、説明には Atlassian Document Format（ADF）が必要になることがあります

3. スプリントとボードの管理

使用する場面：ユーザーがアジャイルボード、スプリント、バックログを操作する場合

ツールの呼び出し順序：

1. JIRA_LIST_BOARDS - すべてのボードを一覧表示します［前提条件］
2. JIRA_LIST_SPRINTS - ボードのスプリントを一覧表示します［必須］
3. JIRA_MOVE_ISSUE_TO_SPRINT - 課題をスプリントに移動します［任意］
4. JIRA_CREATE_SPRINT - 新しいスプリントを作成します［任意］

主なパラメーター：

• boardId：LIST_BOARDS で取得したボード ID
• sprintId：移動操作に使用するスプリント ID
• name：作成するスプリントの名前
• startDate/endDate：ISO 形式のスプリント日付

注意点：

• ボードとスプリントは Jira Software 固有の機能です（Jira Core では利用できません）
• ボードごとにアクティブにできるスプリントは一度に 1 つだけです

4. コメントの管理

使用する場面：ユーザーが課題にコメントを追加する場合や、コメントを表示する場合

ツールの呼び出し順序：

1. JIRA_LIST_ISSUE_COMMENTS - 既存のコメントを一覧表示します［任意］
2. JIRA_ADD_COMMENT - 課題にコメントを追加します［必須］

主なパラメーター：

• issueIdOrKey：「PROJ-123」のような課題キー
• body：コメント本文（リッチテキスト用の ADF をサポート）

注意点：

• コメントの書式設定には ADF（Atlassian Document Format）を使用できます
• メンションにはユーザー名ではなく、アカウント ID を使用します

5. プロジェクトとユーザーを管理する

使用する場面：プロジェクトの一覧表示、ユーザーの検索、プロジェクトのロール管理を行いたい場合

ツールの順序：

1. JIRA_GET_ALL_PROJECTS - すべてのプロジェクトを一覧表示します［任意］
2. JIRA_GET_PROJECT - プロジェクトの詳細を取得します［任意］
3. JIRA_FIND_USERS / JIRA_GET_ALL_USERS - ユーザーを検索します［任意］
4. JIRA_GET_PROJECT_ROLES - プロジェクトのロールを一覧表示します［任意］
5. JIRA_ADD_USERS_TO_PROJECT_ROLE - ユーザーをロールに追加します［任意］

主なパラメーター：

• projectIdOrKey：プロジェクトキー
• query：FIND_USERSで使用する検索テキスト
• roleId：ロール操作に使用するロールID

注意点：

• ユーザー操作ではアカウントIDを使用します（メールアドレスや表示名ではありません）
• プロジェクトのロールはグローバル権限とは異なります

よく使われるパターン

JQL構文

よく使われる演算子：

• project = "PROJ" - プロジェクトで絞り込みます
• status = "In Progress" - ステータスで絞り込みます
• assignee = currentUser() - 現在のユーザーの課題
• created >= -7d - 過去7日間に作成された課題
• labels = "bug" - ラベルで絞り込みます
• priority = High - 優先度で絞り込みます
• ORDER BY created DESC - 結果を並べ替えます

結合演算子：

• AND - 両方の条件
• OR - いずれかの条件
• NOT - 条件を否定します

ページネーション

• startAt と maxResults パラメーターを使用します
• 残りのページを確認するには、レスポンスの total を確認します
• startAt + maxResults >= total となるまで続けます

既知の注意点

フィールド名：

• カスタムフィールドでは、customfield_10001 のようなIDを使用します
• フィールドIDと名前を確認するには、JIRA_GET_FIELDSを使用します
• JQLのフィールド名は、APIのフィールド名と異なる場合があります

認証：

• Jira Cloudではユーザー名ではなくアカウントIDを使用します
• 接続でサイトURLが正しく設定されている必要があります

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
課題を検索（JQL）	JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST	jql, maxResults
課題を取得	JIRA_GET_ISSUE	issueIdOrKey
課題を作成	JIRA_CREATE_ISSUE	project, issuetype, summary
課題を編集	JIRA_EDIT_ISSUE	issueIdOrKey, fields
課題を割り当て	JIRA_ASSIGN_ISSUE	issueIdOrKey, accountId
コメントを追加	JIRA_ADD_COMMENT	issueIdOrKey, body
コメントを一覧表示	JIRA_LIST_ISSUE_COMMENTS	issueIdOrKey
プロジェクトを一覧表示	JIRA_GET_ALL_PROJECTS	(none)
プロジェクトを取得	JIRA_GET_PROJECT	projectIdOrKey
ボードを一覧表示	JIRA_LIST_BOARDS	(none)
スプリントを一覧表示	JIRA_LIST_SPRINTS	boardId
スプリントに移動	JIRA_MOVE_ISSUE_TO_SPRINT	sprintId, issues
スプリントを作成	JIRA_CREATE_SPRINT	name, boardId
ユーザーを検索	JIRA_FIND_USERS	query
フィールドを取得	JIRA_GET_FIELDS	(none)
フィルターを一覧表示	JIRA_LIST_FILTERS	(none)
プロジェクトのロール	JIRA_GET_PROJECT_ROLES	projectIdOrKey
プロジェクトのバージョン	JIRA_GET_PROJECT_VERSIONS	projectIdOrKey

---

Composio によって提供