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. **"Create API token"**을 클릭합니다.

  3. 라벨을 입력합니다 (예: "Claude Code MCP").

  4. **"Create"**를 클릭합니다.

  5. 토큰을 복사합니다 (다시 볼 수 없으므로 주의하세요).

3단계: 자격 증명 구성

자격 증명으로 설정을 실행합니다:

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

매개변수

설명

예시

이메일

Atlassian 계정 이메일

john@company.com

API 토큰

2단계에서 생성한 토큰

ATATT3xFfGF0...

기본 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