Skip to main content
Glama
Sign In
jira-mcp

jira-mcp

by Choing-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

@choing.dev/jira-mcp

Jira Cloud & Confluence를 AI 에이전트에서 바로 사용할 수 있게 해주는 MCP (Model Context Protocol) 서버입니다.

Claude, Cursor 등 MCP를 지원하는 AI 도구에서 JQL 검색, 이슈 생성/수정/전환, 댓글 작성, Confluence 페이지 생성까지 자연어로 수행할 수 있습니다.

주요 기능

도구

설명

jql_search

JQL로 이슈 검색 (v3 페이지네이션 지원)

get_issue

이슈 상세 조회

create_issue

이슈 생성 (Task, Bug, Story, Epic 등)

update_issue

이슈 필드 수정 (제목, 설명, 담당자, 라벨 등)

get_transitions

가능한 상태 전환 목록 조회

transition_issue

이슈 상태 전환 (예: To Do → In Progress)

add_comment

이슈에 댓글 추가

list_projects

프로젝트 목록 조회

get_myself

현재 사용자 정보 조회

confluence_create_page

Confluence 페이지 생성

Related MCP server: jiri-mcp

빠른 시작

1. 환경변수 설정

export JIRA_INSTANCE_URL="https://your-domain.atlassian.net"
export JIRA_USER_EMAIL="your-email@example.com"
export JIRA_API_KEY="your-api-token"

API 토큰 발급: Atlassian API 토큰 관리에서 발급받을 수 있습니다.

2. 설치 및 실행

npx @choing.dev/jira-mcp

또는 글로벌 설치:

npm install -g @choing.dev/jira-mcp
jira-mcp

AI 도구 설정

Cursor

.cursor/mcp.json 파일에 추가:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@choing.dev/jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@example.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@choing.dev/jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@example.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

도구 상세

jql_search

JQL 쿼리로 이슈를 검색합니다. Jira REST API v3의 POST /search/jql을 사용합니다.

"내 프로젝트의 진행 중인 버그를 검색해줘"
→ jql_search { jql: "project = PROJ AND status = 'In Progress' AND issuetype = Bug" }

파라미터

필수

설명

jql

O

JQL 쿼리 문자열

maxResults

최대 결과 수 (기본: 50)

fields

반환할 필드 목록

nextPageToken

다음 페이지 토큰

expand

추가 정보 (changelog, renderedFields 등)

get_issue

이슈 키 또는 ID로 상세 정보를 조회합니다.

"PROJ-123 이슈 내용 보여줘"
→ get_issue { issueIdOrKey: "PROJ-123" }

create_issue

새 이슈를 생성합니다.

"PROJ 프로젝트에 로그인 버그 이슈 만들어줘"
→ create_issue { projectKey: "PROJ", issueType: "Bug", summary: "로그인 실패 버그" }

파라미터

필수

설명

projectKey

O

프로젝트 키

issueType

O

이슈 유형 (Task, Bug, Story, Epic)

summary

O

이슈 제목

description

이슈 설명 (텍스트 → ADF 자동 변환)

assignee

담당자 계정 ID

labels

라벨 목록

priority

우선순위 (Highest, High, Medium, Low, Lowest)

parentKey

상위 이슈 키 (하위 작업 생성 시)

customFields

커스텀 필드 객체

update_issue

이슈 필드를 수정합니다. description은 ADF(Atlassian Document Format) 객체입니다.

"PROJ-123 제목을 '수정된 제목'으로 바꿔줘"
→ update_issue { issueIdOrKey: "PROJ-123", summary: "수정된 제목" }

get_transitions / transition_issue

이슈 상태를 전환합니다. 먼저 get_transitions로 가능한 전환을 확인한 후 transition_issue를 호출합니다.

"PROJ-123을 In Progress로 변경해줘"
→ get_transitions { issueIdOrKey: "PROJ-123" }
→ transition_issue { issueIdOrKey: "PROJ-123", transitionId: "21" }

add_comment

이슈에 댓글을 추가합니다. 텍스트를 입력하면 ADF 형식으로 자동 변환됩니다.

"PROJ-123에 '확인 완료' 댓글 달아줘"
→ add_comment { issueIdOrKey: "PROJ-123", body: "확인 완료" }

list_projects

접근 가능한 Jira 프로젝트 목록을 조회합니다.

"내 프로젝트 목록 보여줘"
→ list_projects {}

get_myself

현재 인증된 사용자 정보를 조회합니다. 담당자 배정 시 accountId 확인에 유용합니다.

confluence_create_page

Confluence에 새 페이지를 생성합니다. Confluence REST API v2를 사용합니다.

"TEAM 스페이스에 회의록 페이지 만들어줘"
→ confluence_create_page { spaceKey: "TEAM", title: "2026-03-10 회의록", bodyHtml: "<h2>안건</h2><p>...</p>" }

개발

# 의존성 설치
npm install

# 개발 모드 (tsx)
npm run dev

# 빌드
npm run build

# 빌드 후 실행
npm start

환경변수

변수

필수

설명

JIRA_INSTANCE_URL

O

Jira 인스턴스 URL (예: https://your-domain.atlassian.net)

JIRA_USER_EMAIL

O

Atlassian 계정 이메일

JIRA_API_KEY

O

Atlassian API 토큰

기술 스택

  • TypeScript – 타입 안전한 코드

  • MCP SDK (@modelcontextprotocol/sdk) – Model Context Protocol 구현

  • Jira REST API v3 – 이슈, 프로젝트, 전환 관리

  • Confluence REST API v2 – 페이지 생성

  • stdio 전송 – MCP 클라이언트와 표준 입출력 통신

라이선스

MIT © choing.dev

Available Tools

10 tools
add_commentA

이슈에 댓글을 추가합니다. 텍스트를 입력하면 ADF 형식으로 자동 변환됩니다.

Inputs: body (required), issueIdOrKey (required).

confluence_create_pageB

Confluence에 새 페이지를 생성합니다. Confluence REST API v2를 사용합니다. bodyHtml에는 간단한 HTML(h2, p, ul, li, table)을 사용하세요.

Inputs: title (required), bodyHtml (required), spaceKey (required).

create_issueC

새 이슈를 생성합니다. 프로젝트 키, 이슈 유형, 요약은 필수입니다.

Inputs: summary (required), issueType (required), projectKey (required), labels, +5 more.

get_issueB

이슈 ID 또는 키로 이슈 상세 정보를 조회합니다. REST API v3를 사용합니다.

Inputs: issueIdOrKey (required), expand, fields, failFast, +1 more.

get_myselfA

현재 인증된 사용자 정보를 조회합니다. 계정 ID 확인에 유용합니다.

Inputs: no named parameters.

get_transitionsA

이슈의 가능한 상태 전환 목록을 조회합니다. transition_issue 호출 전에 이 도구로 전환 ID를 확인하세요.

Inputs: issueIdOrKey (required).

jql_searchA

JQL(Jira Query Language)로 이슈를 검색합니다. REST API v3의 POST /search/jql 을 사용합니다.

Inputs: jql (required), expand, fields, maxResults, +1 more.

list_projectsA

접근 가능한 Jira 프로젝트 목록을 조회합니다.

Inputs: query, startAt, maxResults.

transition_issueA

이슈 상태를 전환합니다. 먼저 get_transitions로 유효한 전환 ID를 확인하세요.

Inputs: issueIdOrKey (required), transitionId (required).

update_issueA

이슈 필드를 수정합니다. description은 ADF 형식 객체입니다. get_issue로 현재 ADF를 확인 후 수정하세요.

Inputs: issueIdOrKey (required), labels, summary, assignee, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct action or resource: search, get, create, update, transition, comment, projects, and user info are clearly separated. get_transitions and transition_issue are complementary rather than overlapping, with descriptions explicitly guiding the intended workflow.

    Naming Consistency4/5

    Most tools follow a clear verb_noun snake_case pattern like get_issue, create_issue, and list_projects. jql_search is a minor outlier (should be search_jql), and confluence_create_page mixes a namespace prefix with the otherwise consistent pattern.

    Tool Count5/5

    Ten tools is well-scoped for a Jira integration, covering search, issue lifecycle, transitions, comments, projects, and user lookup without unnecessary bloat. The Confluence page creation tool is slightly out of place, but the overall count remains appropriate and manageable.

    Completeness4/5

    The core Jira workflow is well covered: search, create, read, update, transition, comment, project listing, and user identity are all present. Minor gaps like deleting issues, managing attachments/links, and Confluence read/update operations are acceptable for a typical Jira automation surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers