Skip to main content
Glama
deenesjakoruzh
rui-branco

Jira MCP Server

by rui-branco
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

Jira MCPサーバー

Model Context Protocol (MCP)サーバーで、JiraチケットのコンテキストをClaude Codeに直接取り込みます。開発環境を離れることなく、説明、コメント、添付ファイル、リンクされたFigmaデザインを含む完全なチケット情報を取得できます。

概要

開発タスクに取り組む際、Jiraとコードエディタの間でコンテキストを切り替えると、フローが中断され、時間が無駄になります。このMCPサーバーは、以下の機能でこれを解決します。

  • チケットコンテキストの完全取得 - 説明、コメント、ステータス、メタデータを即座に取得

  • 添付ファイルのダウンロード - 画像の添付ファイルをダウンロードし、インラインで表示

  • Figmaデザインの自動取得 - リンクされたFigma URLを自動検出し、画像としてエクスポート

  • 自然言語クエリの有効化 - Claude Codeから直接JQLを使用してチケットを検索

Related MCP server: JIRA MCP Server

機能

機能

説明

チケット詳細の全表示

サマリー、説明、ステータス、優先度、担当者、報告者、スプリント、親チケット

コメント

作成者とタイムスタンプ付きの全コメント

添付ファイル

画像添付ファイル（PNG, JPG, GIF, WebP）の自動ダウンロード

リンクされた課題

関連チケットとその関係性を表示

Figma統合

チケットにリンクされたFigmaデザインを自動検出してエクスポート

JQL検索

強力なクエリを使用してJiraインスタンス全体を検索

インストール

前提条件

  • Node.js 18以上

  • Claude Code CLI

  • APIアクセス権を持つJira Cloudアカウント

ステップ 1: Claude Codeに追加

claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp

ステップ 2: Jira APIトークンの取得

  1. Atlassian APIトークンにアクセス

  2. **「APIトークンを作成」**をクリック

  3. ラベルを入力（例: "Claude Code MCP"）

  4. **「作成」**をクリック

  5. トークンをコピー（二度と表示されないため注意）

ステップ 3: 認証情報の構成

認証情報を設定してセットアップを実行します：

npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"

パラメータ

説明

例

Email

Atlassianアカウントのメールアドレス

john@company.com

API Token

ステップ2で作成したトークン

ATATT3xFfGF0...

Base URL

JiraインスタンスのURL

https://company.atlassian.net

または、対話形式で実行（各値の入力を求められます）：

npx @rui.branco/jira-mcp setup

ステップ 4: 検証

Claude Codeを再起動し、/mcpを実行してサーバーが接続されていることを確認します。

代替手段: 手動インストール

手動でインストールする場合：

git clone https://github.com/rui-branco/jira-mcp.git ~/.config/jira-mcp
cd ~/.config/jira-mcp && npm install
node setup.js

その後、Claude Codeに追加します：

claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.js

使用方法

チケットの取得

> Get ticket PROJ-123

# Returns full ticket with description, comments, attachments, and Figma designs

チケットの検索

> Search for my open tickets

# Uses JQL: assignee = currentUser() AND status != Done

メンション付きコメントの追加

@FirstName LastName構文を使用して、コメント内でユーザーにメンションします：

> Add a comment to PROJ-123: "@John Doe Please review this implementation"

# The mention is automatically resolved and the user gets notified

出力例

# PROJ-123: Implement user authentication

Status: In Progress | Type: Story | Priority: High
Assignee: John Doe | Reporter: Jane Smith

## Description
Implement OAuth2 authentication flow...

## Comments (2)
### Jane Smith - Jan 15, 2025
Please ensure we support Google SSO...

## Attachments (1)
- mockup.png (image/png, 245KB)
  [Image displayed inline]

## Figma Designs (1)
### Auth Flow Design - Login Screen
- Exported 3 image(s):
  - Login Form: ~/.config/figma-mcp/exports/...
  - Error States: ~/.config/figma-mcp/exports/...
  - Success State: ~/.config/figma-mcp/exports/...

Figma統合

このMCPは、チケットの説明やコメント内のFigma URLを自動的に検出します。figma-mcpが構成されている場合：

  • Figmaリンクが自動的に取得されます

  • 大きなフレームは読みやすさのためにセクションに分割されます

  • 画像は鮮明さのために2倍のスケールでエクスポートされます

  • すべての画像がClaude Code内でインライン表示されます

Figma統合を有効にするには：

  1. figma-mcpをインストールして構成

  2. Claude Codeを再起動

  3. チケットを取得するとFigmaリンクが自動取得されます

APIリファレンス

ツール

ツール

説明

パラメータ

jira_get_myself

現在認証されているユーザーのaccountIdと情報を取得（チケット割り当てに使用）

なし

jira_get_ticket

キーでチケットを取得（説明、コメント、添付ファイル、Figmaデザインを含む）

issueKey (必須), downloadImages, fetchFigma

jira_search

JQLを使用してチケットを検索

jql (必須), maxResults

jira_add_comment

チケットにコメントを追加（@メンション対応）

issueKey (必須), comment (必須)

jira_reply_comment

引用とメンション付きで特定のコメントに返信

issueKey (必須), commentId (必須), reply (必須)

jira_edit_comment

既存のコメントを編集（@メンション対応）

issueKey (必須), commentId (必須), comment (必須)

jira_delete_comment

コメントを削除（取り消し不可）

issueKey (必須), commentId (必須)

jira_transition

名前またはIDでチケットステータスを変更（中間ステップを自動処理）

issueKey (必須), targetStatus または transitionId

jira_update_ticket

チケットフィールドを更新（サマリー、説明、担当者、優先度、ラベル）

issueKey (必須), およびオプションのフィールドパラメータ

Confluenceツール

このMCPは、同じAtlassian認証情報を使用してConfluenceも公開します。Atlassian Cloudでは、Jira用に構成したAPIトークンがConfluenceでも機能し、ConfluenceのベースURLは<jiraBaseUrl>/wikiとして導出されるため、追加のセットアップは不要です。構成済みのインスタンスに対して、以下のconfluence_*ツールを使用してください。

Confluenceが別のホストにあるサーバー/データセンター環境の場合は、config.json内のインスタンスにconfluenceBaseUrlを明示的に設定してください。

ツール

説明

パラメータ

confluence_get_spaces

グローバルスペースを一覧表示 (key, name, id)

instance

confluence_get_space

説明とホームページを含む単一のスペースを取得

spaceKey (必須), instance

confluence_create_space

新しいグローバルスペースを作成

spaceKey (必須), name (必須), description, instance

confluence_update_space

スペースの名前や説明を更新

spaceKey (必須), name, description, instance

confluence_delete_space

スペースを削除（Cloudでは非同期）

spaceKey (必須), instance

confluence_search

CQLテキスト検索 (text ~ "<query>" AND type = <type>)

query (必須), spaceKey, type, limit, instance

confluence_get_recent_pages

直近N日間に変更されたページ

sinceDays (デフォルト30), spaceKey, limit, instance

confluence_get_space_root_pages

childTypes.pageを持つスペース内のトップレベルページ

spaceKey (必須), limit, instance

confluence_get_page_children

ページの直接の子ページ

pageId (必須), limit, instance

confluence_get_page

body.view, body.storageおよび（デフォルトで）v2 body.atlas_doc_formatをマージしたフルページ

pageId (必須), includeAdf, instance

confluence_get_comments

ページ上のコメントを一覧表示

pageId (必須), limit, instance

confluence_add_comment

フッターコメントを追加（デフォルトでプレーンテキストをストレージXHTMLにラップ）

pageId (必須), body (必須), format (text/storage), instance

confluence_update_page

タイトル/本文を更新（未指定の場合はバージョンを自動インクリメント）

pageId (必須), title, body (ストレージXHTML), version, instance

confluence_create_page

親を指定してページを作成

spaceKey, title, body (ストレージXHTML) (すべて必須), parentId, instance

confluence_delete_page

ページを削除

pageId (必須), instance

confluence_get_labels

ページ上のラベルを一覧表示

pageId (必須), instance

confluence_add_label

ページにラベルを追加

pageId (必須), label (必須), instance

confluence_remove_label

ページからラベルを削除

pageId (必須), label (必須), instance

confluence_list_attachments

ページ上の添付ファイルを一覧表示

pageId (必須), limit, instance

confluence_upload_attachment

ディスクまたはbase64コンテンツからファイルをアップロード

pageId (必須), filePath または fileContent+fileName, comment, instance

confluence_download_attachment

添付ファイルをファイル名でローカルの添付ファイルディレクトリにダウンロード

pageId (必須), filename (必須), instance

なぜconfluence_get_pageでADFを使用するのか？ v1のbody.atlas_doc_format展開は、最新のCloudページでは信頼性が低く、テーブルセルの背景色や一部の新しいノードタイプは、v2の/api/v2/pages/<id>?body-format=atlas_doc_formatエンドポイントでしか保持されません。そのため、confluence_get_pageは両方のリクエストを並行して実行し、v2のADF本文をv1のレスポンスにマージします。これにより、呼び出し元はbody.view、body.storage、body.atlas_doc_formatを一度に取得できます。

構成

構成は~/.config/jira-mcp/config.jsonに保存されます：

{
  "email": "your@email.com",
  "token": "YOUR_API_TOKEN",
  "baseUrl": "https://company.atlassian.net"
}

エラーハンドリング

サーバーは明確なエラーメッセージを提供します：

エラー

意味

Figma API rate limit exceeded

Figmaリクエストが多すぎます。数分待ってください

Figma access denied

Figmaトークンまたはファイル権限を確認してください

Figma not configured

figma-mcpをインストールして構成してください

セキュリティ

  • APIトークンはローカルの~/.config/jira-mcp/config.jsonに保存されます

  • 構成ファイルは.gitignoreによりgitから除外されます

  • トークンはJira/Figma API以外にはログ記録や送信されません

  • 添付ファイルは~/.config/jira-mcp/attachments/にダウンロードされます

ライセンス

MIT

関連

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
Not graded
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
7moRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Jira MCP Server

    SunWooBang
    A
    license
    C
    quality
    D
    maintenance
    Connects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.
    1
    98
    1
    MIT

  • JIRA MCP Server

    rajsodhi-2
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude AI to interact with JIRA for project management and issue tracking, supporting JQL queries, comprehensive issue details retrieval with subtasks and linked issues, and release planning analysis.
    MIT

  • Atlassian Jira MCP Server

    aashari
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI assistants like Claude to Jira projects, enabling natural language queries and operations for issue management, project tracking, comments, and workflows through the Jira REST API.
    14,799
    72
    ISC

  • Simple Jira MCP

    timohaa
    A
    license
    Not graded
    quality
    A
    maintenance
    Provides Jira Cloud integration for AI agents, enabling them to search issues with JQL, retrieve detailed issue information, and create new tickets. It supports multiple Jira configurations and provides tools for managing attachments and comments through natural language.
    MIT

View all related MCP servers

Related MCP Connectors

  • Atlassian Rovo MCP Server

    Connect to Atlassian Jira, Confluence, and Compass to search, create, and manage your work.

  • Rootr

    Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.

  • Fathom MCP Server

    Connect Claude to Fathom meeting recordings, transcripts, and summaries

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rui-branco/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server