Jira Cloud について
Jira Cloud MCP Serverは、MCPクライアントからJira Cloudの課題、プロジェクト、ボード、スプリント、フィルターを操作するサーバーです。インスタンスやプロジェクトの情報、カスタムフィールド一覧、ツール文書もリソースとして提供します。
主な機能
- 01課題の作成と管理
- 02JQL検索とフィルター管理
- 03プロジェクト、ボード、スプリントの管理
- 04結果参照を使った一括操作
- 05課題の指標と件数の分析
- 06インスタンスとカスタムフィールドのリソース提供
活用シーン
- 01課題やスプリント割り当ての更新
- 02JQLによる課題分析
- 03プロジェクトとボードの概要確認
- 04課題タイプ別カスタムフィールドの確認
MCP 対応
Jira Cloud向けのMCPサーバーです。Jira操作をツールとして、インスタンス、プロジェクト、ボード、カスタムフィールド、文書情報をリソースとして提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @aaronsb/jira-cloud-mcpJIRA_API_TOKENシークレットJira API token (generate at https://id.atlassian.com/manage/api-tokens)JIRA_EMAILAtlassian account email addressJIRA_HOSTJira instance URL (e.g., https://your-team.atlassian.net)ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
9掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| jql | string | いいえ | JQL クエリ文字列。create と execute_jql で必須です。構文例は jira://tools/manage_jira_filter/documentation を参照してください。 |
| name | string | いいえ | フィルター名。create で必須です。 |
| expand | array | いいえ | レスポンスに含める追加フィールド。 |
| startAt | integer | いいえ | ページネーションのオフセット(0 起点)。 |
| filterId | string | いいえ | フィルター ID。get、update、delete、execute_filter で必須です。 |
| favourite | boolean | いいえ | お気に入りとしてマークします。 |
| operation | enum | はい | 実行する操作get | create | update | delete | list | execute_filter | execute_jql |
| maxResults | integer | いいえ | 返す項目の最大数。 |
| description | string | いいえ | フィルターの説明。 |
| sharePermissions | array | いいえ | フィルターの共有権限。 |
詳細
Jira Cloud MCP サーバー
Jira Cloud インスタンスとやり取りするための Model Context Protocol サーバーです。
インストール
Claude Desktop(ワンクリック)
jira-cloud-mcp.mcpb をダウンロードして開くと、Claude Desktop が Jira の認証情報を入力するよう求めます。
Claude Code
claude mcp add jira-cloud -e JIRA_API_TOKEN=your-token -e JIRA_EMAIL=your-email -e JIRA_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/jira-cloud-mcp
手動(任意の MCP クライアント)
{
"mcpServers": {
"jira-cloud": {
"command": "npx",
"args": ["-y", "@aaronsb/jira-cloud-mcp"],
"env": {
"JIRA_API_TOKEN": "your-api-token",
"JIRA_EMAIL": "your-email",
"JIRA_HOST": "https://your-team.atlassian.net"
}
}
}
}
認証情報
Atlassian Account Settings で API トークンを生成します。
ツール
| ツール | 説明 |
|---|---|
manage_jira_issue | 課題の取得、作成、更新、削除、移動、トランジション、コメント追加、リンク、または階層のたどり |
manage_jira_filter | JQL クエリを使用した課題の検索、または保存済みフィルターの管理 |
manage_jira_project | プロジェクトの一覧表示、またはプロジェクトの設定とメタデータの取得 |
manage_jira_board | ボードの一覧表示、またはボードの詳細と設定の取得 |
manage_jira_sprint | スプリントの管理:作成、開始、終了、および課題のスプリントへの割り当て |
queue_jira_operations | 複数の操作を結果参照($0.key)およびエラー処理戦略とともに一括実行 |
analyze_jira_issues | JQL で選択した課題について、指標、正確な件数、データキューブ分析を算出 |
各ツールは operation パラメーターを受け取ります(operations 配列を受け取る queue_jira_operations と、jql および metrics を受け取る analyze_jira_issues を除く)。ツールごとのドキュメントは、MCP リソース jira://tools/{tool_name}/documentation で確認できます。
詳しいツールの説明、ワークスペースのパターン、設計原則については、docs/tools.md を参照してください。
MCP リソース
| リソース | 説明 |
|---|---|
jira://instance/summary | インスタンスレベルの統計 |
jira://projects/distribution | プロジェクト分布の概要 |
jira://projects/{key}/overview | ステータス別件数を含むプロジェクトの概要 |
jira://boards/{id}/overview | スプリント情報を含むボードの概要 |
jira://issue-link-types | 利用可能な課題リンクタイプ |
jira://custom-fields | カスタムフィールドのカタログ(起動時に自動検出) |
jira://custom-fields/{project}/{issueType} | コンテキスト固有のカスタムフィールド |
jira://analysis/recipes | 分析クエリのパターンと計算 DSL のリファレンス |
jira://tools/{name}/documentation | ツールごとのドキュメント |
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。