Jira Delivery について
Jira Deliveryは、コーディングエージェント向けのJira Cloud MCPサーバー兼エージェントスキルです。チケットの準備、受け入れ条件に基づくローカルブランチの確認、QA引き継ぎ資料の作成に対応し、書き込みは初期設定で無効です。
主な機能
- 01チケット作業ブリーフの作成
- 02受け入れ条件に基づく変更確認
- 03トレーサビリティマトリクスの生成
- 04QA引き継ぎ、リリースノート、テスト計画の作成
- 05JiraとConfluenceの検索
- 06承認後のチケットへの書き戻し
活用シーン
- 01チケット着手前の阻害要因と次の手順の整理
- 02PR前のブランチと受け入れ条件の照合
- 03QA引き継ぎ資料とテスト計画の準備
- 04チケットの背景情報を得るためのプロジェクト文書検索
MCP 対応
MCPサーバーとしてJira Cloudに接続し、Confluenceの検索も含むチケット準備、変更確認、引き継ぎ用ツールをクライアントに提供します。初期設定では読み取り専用で、書き込みを有効にした場合もプレビューと承認が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y jira-delivery-mcpJIRA_BASE_URLYour Jira Cloud site, e.g. https://your-domain.atlassian.netJIRA_EMAILEmail of the Atlassian account the API token belongs toJIRA_API_TOKENシークレットAtlassian API tokenJIRA_ENABLE_WRITEStrue to register the write tools (comment, transition, assign, link); off by defaultローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
10掲載時のツール一覧 · 4 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| depth | enum | いいえ | basic = issue のみ、full = 親、エピック、リンクされた issue、サブタスク、コメントも含むbasic | full |
| issueKey | string | はい | Jira の課題キー(例:PROJ-123) |
| includeConfluence | boolean | いいえ | Confluence で関連ページも検索し、結果に含めます(full depth が有効になります) |
詳細
Jira Cloud 向けの MCP サーバーとエージェントスキルです。すぐにビルドできるブリーフを用意してチケットに着手し、
PR を作成する前に受け入れ基準に照らしてブランチを確認し、コーディングエージェントから引き継ぎます。
仕組み
1 · チケットに着手する
「ABC-1 に着手します。準備をお願いします。」
コードを1行も書く前に、準備状況、ブロッカー、受け入れ基準、次のステップ、ブランチ名を確認できます。
2 · PR の前に検証する
「PR を作成する前に、ABC-1 に照らしてブランチを確認してください。」
受け入れ基準と完了の定義に照らしたローカルの差分を、ready_for_pr、needs_work、insufficient_evidence のいずれかの判定と、各基準に対応するファイルとともに確認できます。
3 · 引き継ぐ
「ABC-1 に QA 引き継ぎを投稿してください。」
QA の引き継ぎ、リリースノート、テスト計画、レビューに対応します。書き戻しが有効な場合、エージェントはプレビューを表示し、承認を待ちます。
## インストール
Node.js 22+、Jira Cloud の URL、Atlassian のメールアドレス、API トークンが必要です。
Claude Code — サーバーとスキルを含むプラグイン
/plugin marketplace add teransarathchandra/jira-mcp-server
/plugin install jira-delivery@jira-delivery
サイト、メールアドレス、トークンを求められます(トークンは安全なストレージに保存されます)。プラグインを使わない場合:
claude mcp add jira-delivery \
-e JIRA_BASE_URL=https://your-domain.atlassian.net \
-e [email protected] \
-e JIRA_API_TOKEN=your-api-token \
-- npx -y jira-delivery-mcp
Cursor
**Cursor に追加**をクリックして、3つのプレースホルダー値を置き換えるか、以下の JSONを ~/.cursor/mcp.json に追加します。
VS Code(GitHub Copilot エージェントモード)
VS Code にインストール(またはInsiders**)をクリックします。VS Code からサイト、メールアドレス、トークンを求められ、トークンはシークレットとして保存されます。
手動で設定する場合:.vscode/mcp.json に追加します。VS Code では mcpServers ではなく servers を使用します。
{
"servers": {
"jira-delivery": {
"type": "stdio",
"command": "npx",
"args": ["-y", "jira-delivery-mcp"],
"env": { "JIRA_BASE_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "[email protected]", "JIRA_API_TOKEN": "your-api-token" }
}
}
}
Windsurf ·
Claude Desktop · 任意の MCP クライアント
クライアントの MCP 設定に追加します。Windsurf の場合:Settings → MCP Servers、Claude Desktop の場合:claude_desktop_config.json:
{
"mcpServers": {
"jira-delivery": {
"command": "npx",
"args": ["-y", "jira-delivery-mcp"],
"env": { "JIRA_BASE_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "[email protected]", "JIRA_API_TOKEN": "your-api-token" }
}
}
}
⌨️ Codex CLI
~/.codex/config.toml に追加します:
[mcp_servers.jira-delivery]
command = "npx"
args = ["-y", "jira-delivery-mcp"]
env = { JIRA_BASE_URL = "https://your-domain.atlassian.net", JIRA_EMAIL = "[email protected]", JIRA_API_TOKEN = "your-api-token" }
設定を確認する: 3つの変数をエクスポートした状態で npx jira-delivery-mcp doctor を実行すると、ログインを検証し、サイトで必要なカスタムフィールドの ID(受け入れ条件、ストーリーポイント、エピック)を表示します。他のエージェントでは、各リリースにも添付されている jira-delivery スキルを追加できます。
ツール
| ステップ | ツール |
|---|---|
| 開始 | jira_search_issues · jira_get_issue · jira_prepare_work_brief |
| 検証 | delivery_check_changes · delivery_traceability_matrix |
| 引き継ぎ | delivery_generate · jira_add_comment* · jira_update_issue* |
| コンテキスト | confluence_search · confluence_get_page · delivery_project_patterns · delivery_generate_agent_pack |
* JIRA_ENABLE_WRITES=true でオプトインできます。すべてのツールは型付きの structuredContent を返します。ツールリファレンスを参照してください。
デフォルトで安全
- 🔒 ローカルでプライベート — お使いのマシン上で stdio 経由で動作し、Atlassian サイトとのみ通信します。テレメトリーはありません。
- ✋ オプトインしない限り読み取り専用 — オプトインした場合も、すべての書き込みはプレビューされ、承認を待ってから一度だけ送信され、監査されます。
- 🧱 チケットのテキストは信頼できないデータ — データとしてフェンスで囲み、プロンプトインジェクションをスキャンし、指示として扱うことはありません。
- 🗝️ 認証情報はお使いの環境に保持 — ログに記録されることはなく、すべての出力から削除されます。
ドキュメント
使い方 · ツール · 設定 · セキュリティ · トラブルシューティング · 1.x からの移行 · 変更履歴
コントリビューション
Issue とプルリクエストを歓迎します。CONTRIBUTING.mdを参照してください。セキュリティに関する報告:SECURITY.md。
MIT © Teran Sarathchandra
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。