Skip to main content
Glama
Jira MCP Server for Cursor

Jira MCP Server for Cursor

by kornbed

커서용 Jira MCP 서버

Jira와 통합된 TypeScript 기반 MCP 서버로, Cursor가 Jira 티켓과 상호 작용할 수 있습니다.

특징

  • Jira 티켓 목록

  • 티켓 세부 정보 받기

  • 티켓에 대한 코멘트를 받으세요

  • 새로운 티켓 만들기

  • 티켓에 댓글 추가

  • 티켓 상태 업데이트

  • 커서 통합을 위한 전체 MCP 프로토콜 지원

Related MCP server: JIRA MCP Server

설정

  1. 종속성 설치:

지엑스피1

  1. .env.example 기반으로 .env 파일을 만들고 Jira 자격 증명을 입력합니다.

JIRA_HOST=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
PORT=3000

Jira API 토큰을 받으려면:

  1. https://id.atlassian.com/manage/api-tokens 에 로그인하세요

  2. "API 토큰 만들기"를 클릭하세요

  3. 토큰을 복사하여 .env 파일에 붙여넣으세요.

개발

개발 서버를 실행합니다.

npm run dev

빌드하고 실행

프로젝트를 빌드하세요:

npm run build

서버를 시작합니다:

npm start

커서 통합

이 MCP 서버를 Cursor와 함께 사용하려면 두 가지 옵션이 있습니다.

옵션 1: 명령 기반 통합(권장)

  1. 프로젝트를 빌드하세요:

npm run build
  1. 커서 설정 열기:

    • 커서 메뉴를 클릭하세요

    • "설정"을 선택하세요(또는 키보드 단축키를 사용하세요)

    • "확장" 또는 "통합" 섹션으로 이동합니다.

  2. MCP 구성을 추가합니다.

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-cursor/dist/server.js"]
    }
  }
}

/path/to/jira-mcp-cursor 프로젝트의 절대 경로로 바꾸세요.

옵션 2: HTTP 기반 통합(대안)

  1. MCP 서버를 시작합니다(아직 실행 중이 아니면):

npm start
  1. 커서 설정 열기:

    • 커서 메뉴를 클릭하세요

    • "설정"을 선택하세요(또는 키보드 단축키를 사용하세요)

    • "확장" 또는 "통합" 섹션으로 이동합니다.

  2. MCP 구성을 추가합니다.

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000",
      "capabilities": [
        "list_tickets",
        "get_ticket",
        "get_comments",
        "create_ticket",
        "update_status",
        "add_comment"
      ]
    }
  }
}

커서에서 Jira 사용

MCP 서버를 구성한 후에는 Cursor에서 Jira 명령을 직접 사용할 수 있습니다.

  • /jira list - 티켓을 나열합니다

  • /jira view TICKET-123 - 티켓 세부 정보 보기

  • /jira comments TICKET-123 - 티켓 댓글 받기

  • /jira create - 새 티켓을 만듭니다.

  • /jira comment TICKET-123 - 댓글 추가

  • /jira status TICKET-123 - 티켓 상태 업데이트

MCP 프로토콜 지원

서버는 Cursor에 필요한 MCP(Model-Client-Protocol)를 구현합니다.

  • 명령 기반 통합을 위한 Stdio 통신

  • Jira 작업을 위한 도구 등록

API 엔드포인트

티켓 목록

JQL 쿼리로 필터링하여 선택적으로 Jira 티켓 목록을 검색합니다.

엔드포인트: GET /api/tickets

쿼리 매개변수:

매개변수

유형

필수의

설명

제이큐엘

끈

아니요

티켓을 필터링하기 위한 Jira 쿼리 언어(JQL) 문자열

요청 예시:

GET /api/tickets?jql=project=TEST+AND+status=Open

응답 예시:

TEST-123: Example ticket (Open)
TEST-124: Another ticket (In Progress)

티켓 받기

특정 티켓에 대한 자세한 정보를 검색합니다.

엔드포인트: GET /api/tickets/:id

경로 매개변수:

매개변수

유형

필수의

설명

ID

끈

예

Jira 티켓 ID(예: TEST-123)

요청 예시:

GET /api/tickets/TEST-123

응답 예시:

Key: TEST-123
Summary: Example ticket
Status: Open
Type: Task
Description:
Detailed ticket description

티켓 코멘트 받기

특정 티켓에 대한 모든 댓글을 검색합니다.

엔드포인트: GET /api/tickets/:id/comments

경로 매개변수:

매개변수

유형

필수의

설명

ID

끈

예

Jira 티켓 ID(예: TEST-123)

요청 예시:

GET /api/tickets/TEST-123/comments

응답 예시:

[3/20/2024, 10:00:00 AM] John Doe:
Comment text
---

[3/20/2024, 9:30:00 AM] Jane Smith:
Another comment
---

티켓 생성

새로운 Jira 티켓을 만듭니다.

엔드포인트: POST /api/tickets

요청 본문:

매개변수

유형

필수의

설명

요약

끈

예

티켓 요약

설명

끈

예

티켓 설명

프로젝트 키

끈

예

프로젝트 키(예: TEST)

이슈 유형

끈

예

문제 유형(예: 작업, 버그)

요청 예시:

POST /api/tickets
Content-Type: application/json

{
  "summary": "New feature request",
  "description": "Implement new functionality",
  "projectKey": "TEST",
  "issueType": "Task"
}

응답 예시:

Created ticket: TEST-124

댓글 추가

기존 티켓에 새로운 댓글을 추가합니다.

엔드포인트: POST /api/tickets/:id/comments

경로 매개변수:

매개변수

유형

필수의

설명

ID

끈

예

Jira 티켓 ID(예: TEST-123)

요청 본문:

매개변수

유형

필수의

설명

몸

끈

예

댓글 텍스트

요청 예시:

POST /api/tickets/TEST-123/comments
Content-Type: application/json

{
  "body": "This is a new comment"
}

응답 예시:

Added comment to TEST-123

업데이트 상태

기존 티켓의 상태를 업데이트합니다.

엔드포인트: POST /api/tickets/:id/status

경로 매개변수:

매개변수

유형

필수의

설명

ID

끈

예

Jira 티켓 ID(예: TEST-123)

요청 본문:

매개변수

유형

필수의

설명

전환 ID

끈

예

수행할 전환의 ID

요청 예시:

POST /api/tickets/TEST-123/status
Content-Type: application/json

{
  "transitionId": "21"
}

응답 예시:

Updated status of TEST-123

티켓 검색

텍스트 검색을 사용하여 지정된 프로젝트 전반의 티켓을 검색합니다.

엔드포인트: GET /api/tickets/search

쿼리 매개변수:

매개변수

유형

필수의

설명

검색텍스트

끈

예

티켓에서 검색할 텍스트

프로젝트 키

끈

예

검색할 프로젝트 키의 쉼표로 구분된 목록

최대 결과

숫자

아니요

반환할 최대 결과 수(기본값: 50)

요청 예시:

GET /api/tickets/search?searchText=login+bug&projectKeys=TEST,PROD&maxResults=10

응답 예시:

Found 2 tickets matching "login bug"

[TEST] TEST-123: Login page bug
Status: Open (Updated: 3/20/2024, 10:00:00 AM)
Description:
Users unable to login using SSO
----------------------------------------

[PROD] PROD-456: Fix login performance
Status: In Progress (Updated: 3/19/2024, 3:30:00 PM)
Description:
Login page taking too long to load
----------------------------------------

Available Tools

7 tools
add_commentC

Add a comment to a Jira ticket

Inputs: ticketId (required), comment (required).

create_ticketC

Create a new Jira ticket

Inputs: ticket (required).

get_commentsB

Get comments for a specific Jira ticket

Inputs: ticketId (required).

get_ticketC

Get details of a specific Jira ticket

Inputs: ticketId (required).

list_ticketsB

List Jira tickets assigned to you

Inputs: jql.

search_ticketsB

Search for tickets in specific projects using text search

Inputs: searchText (required), projectKeys (required), maxResults.

update_statusB

Update the status of a Jira ticket

Inputs: ticketId (required), status (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific Jira operations: list_tickets vs. search_tickets differentiate between personal assignment and project-wide text search, while get_ticket vs. get_comments separate ticket details from comment retrieval. No tools appear to overlap in functionality, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., add_comment, create_ticket, get_comments). The verbs are appropriately chosen for each action (add, create, get, list, search, update), creating a predictable and readable naming convention throughout the set.

    Tool Count5/5

    With 7 tools, this server is well-scoped for Jira ticket management. Each tool earns its place by covering essential operations like creating, retrieving, listing, searching, updating status, and managing comments, without being overly sparse or bloated for the domain.

    Completeness4/5

    The tool set provides strong coverage for core Jira ticket workflows, including CRUD-like operations (create, get, list, update_status) and comment management. A minor gap exists in the lack of a tool to update ticket details beyond status (e.g., edit description or fields), but agents can work around this by creating new tickets or using comments.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
      11
      26
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol server that allows AI assistants to interact with Jira, supporting operations like creating tickets and fetching project information directly from the cursor.
      1
      -
    • F
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides tools for interacting with Jira. Enables Cursor and other MCP clients to fetch tickets, manage linked tickets, and update ticket status.
      3
      -