jira-automation

Rube MCP による Jira の自動化

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

前提条件

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

セットアップ

Rube MCP の入手：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。実際の MCP 認証と Jira サイト／アカウントのスコープを確認してください。エンドポイントを設定しただけではアクセスは確立されません。

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：1 ページあたりの最大結果数（デフォルトは 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 が使用されます
• JIRA_GET_FIELDS を使用して、フィールド ID と名前を確認します
• 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

使用する場面

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

例

ユーザーのリクエスト：

Rube MCP（Composio）を介して Jira タスクを自動化する：課題、プロジェクト、スプリント、ボード、コメント、ユーザー。

制限事項

• 上記のスコープに明確に該当するタスクに限り、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、停止して確認してください。