Jira MCP Server for Cursor
커서용 Jira MCP 서버
Jira와 통합된 TypeScript 기반 MCP 서버로, Cursor가 Jira 티켓과 상호 작용할 수 있습니다.
특징
Jira 티켓 목록
티켓 세부 정보 받기
티켓에 대한 코멘트를 받으세요
새로운 티켓 만들기
티켓에 댓글 추가
티켓 상태 업데이트
커서 통합을 위한 전체 MCP 프로토콜 지원
Related MCP server: JIRA MCP Server
설정
종속성 설치:
지엑스피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=3000Jira API 토큰을 받으려면:
"API 토큰 만들기"를 클릭하세요
토큰을 복사하여
.env파일에 붙여넣으세요.
개발
개발 서버를 실행합니다.
npm run dev빌드하고 실행
프로젝트를 빌드하세요:
npm run build서버를 시작합니다:
npm start커서 통합
이 MCP 서버를 Cursor와 함께 사용하려면 두 가지 옵션이 있습니다.
옵션 1: 명령 기반 통합(권장)
프로젝트를 빌드하세요:
npm run build커서 설정 열기:
커서 메뉴를 클릭하세요
"설정"을 선택하세요(또는 키보드 단축키를 사용하세요)
"확장" 또는 "통합" 섹션으로 이동합니다.
MCP 구성을 추가합니다.
{
"mcpServers": {
"jira": {
"command": "node",
"args": ["/path/to/jira-mcp-cursor/dist/server.js"]
}
}
}/path/to/jira-mcp-cursor 프로젝트의 절대 경로로 바꾸세요.
옵션 2: HTTP 기반 통합(대안)
MCP 서버를 시작합니다(아직 실행 중이 아니면):
npm start커서 설정 열기:
커서 메뉴를 클릭하세요
"설정"을 선택하세요(또는 키보드 단축키를 사용하세요)
"확장" 또는 "통합" 섹션으로 이동합니다.
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 toolsadd_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Hosted Airtable MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Opinionated sprint tracker. Read/update tickets, sprints, velocity from Claude/Cursor/Zed.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseBqualityDmaintenanceA TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.1126MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.-
- FlicenseNot gradedqualityDmaintenanceModel 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-
- FlicenseAqualityDmaintenanceA 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-