Jira MCP Server
Jira MCP 서버
jira-python 라이브러리를 사용하여 Jira의 REST API와 상호작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Claude Desktop 및 기타 MCP 클라이언트와 통합되어 자연어 명령을 사용하여 Jira와 상호작용할 수 있습니다.
특징
접근 가능한 모든 Jira 프로젝트를 가져옵니다.
특정 Jira 문제에 대한 세부 정보 가져오기
JQL(Jira Query Language)을 사용하여 문제 검색
새로운 Jira 이슈 생성
이슈에 댓글 추가
문제에 대해 사용 가능한 전환 가져오기
새로운 지위로의 전환 문제
Related MCP server: JIRA MCP Tools
설치
필수 조건
파이썬 3.9 이상
Jira 인스턴스(클라우드, 서버 또는 데이터 센터)
uv (선택 사항이지만 종속성 관리를 위해 권장됨)
가상 환경 활성화(권장)
지엑스피1
uv 사용(권장)
# Install uv if you don't have it
pip install uv
# Install the Jira MCP server
uv pip install mcp-server-jirapip 사용하기
pip install mcp-server-jira구성
환경 변수
환경 변수를 사용하여 서버를 구성합니다.
JIRA_SERVER_URL: Jira 서버의 URLJIRA_AUTH_METHOD: 인증 방법('basic_auth' 또는 'token_auth')JIRA_USERNAME: 기본 인증을 위한 사용자 이름JIRA_PASSWORD: 기본 인증을 위한 비밀번호JIRA_TOKEN: API 토큰 또는 개인 액세스 토큰
환경 파일(지역 개발)
구성과 함께 루트 디렉토리에 .env 파일을 만들 수도 있습니다.
JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token용법
명령줄
python -m mcp_server_jira도커
docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jiraClaude 데스크톱 통합
Claude Desktop과 함께 이 서버를 사용하려면:
위의 방법 중 하나를 사용하여 서버를 설치하세요.
Claude Desktop에서:
설정 -> 개발자로 이동하세요
구성 편집을 클릭하세요
선택한 편집기에서 JSON 구성을 엽니다.
다음 JSON을 추가합니다. (
NOTE: 사용되는 환경 변수는 토큰 인증을 위한 것이며 다른 인증 방식에서는 작동하지 않습니다.)
{
"mcpServers": {
"jira": {
"command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv",
"args": [
"--directory",
"<PATH TO JIRA MCP>",
"run",
"mcp-server-jira"
],
"env": {
"JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
"JIRA_AUTH_METHOD": "token_auth",
"JIRA_USERNAME": "<USERNAME>",
"JIRA_TOKEN": "<TOKEN>"
}
}
}
}이제 Claude에게 다음과 같은 질문을 하여 Jira와 상호 작용할 수 있습니다.
"Jira에서 내 모든 프로젝트를 보여주세요"
"PROJECT-123 문제에 대한 세부 정보를 얻으세요"
"PROJECT에 '로그인 문제 해결' 요약과 함께 새 버그를 만듭니다."
"나에게 할당된 모든 열린 버그 찾기"
입증
서버는 여러 가지 인증 방법을 지원합니다.
기본 인증
사용자 이름과 비밀번호를 사용하는 Jira Server/Data Center의 경우:
JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"API 토큰(Jira Cloud)
API 토큰을 사용하는 Jira Cloud의 경우:
JIRA_SERVER_URL="https://your-domain.atlassian.net"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_email@example.com"
JIRA_TOKEN="your_api_token"개인 액세스 토큰(Jira 서버/데이터 센터)
PAT를 사용하는 Jira Server/Data Center(8.14+)의 경우:
JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="token_auth"
JIRA_TOKEN="your_personal_access_token"사용 가능한 도구
get_projects: 접근 가능한 모든 Jira 프로젝트를 가져옵니다.get_issue: 키로 특정 Jira 이슈에 대한 세부 정보를 가져옵니다.search_issues: JQL을 사용하여 Jira 이슈를 검색합니다.create_issue: 새로운 Jira 이슈를 생성합니다.add_comment: Jira 이슈에 댓글을 추가합니다.get_transitions: Jira 이슈에 사용 가능한 워크플로 전환을 가져옵니다.transition_issue: Jira 이슈를 새로운 상태로 전환합니다.
특허
MIT
Available Tools
10 toolsadd_jira_commentC
Add a comment to a Jira issue
Inputs: comment (required), issue_key (required).
create_jira_issueC
Create a new Jira issue. Common issue types include 'Bug', 'Task', 'Story', 'Epic' (capitalization handled automatically)
Inputs: description (required), issue_type (required), project (required), summary (required), +1 more.
create_jira_issuesC
Bulk create new Jira issues. IMPORTANT: For 'issue_type', use the exact case-sensitive types in your Jira instance (common: 'Bug', 'Task', 'Story', 'Epic')
Inputs: field_list (required), prefetch.
create_jira_projectC
Create a new Jira project
Inputs: key (required), assignee, avatarId, categoryId, +8 more.
get_jira_issueC
Get details for a specific Jira issue by key
Inputs: issue_key (required).
get_jira_project_issue_typesB
Get all available issue types for a specific Jira project
Inputs: project_key (required).
get_jira_projectsB
Get all accessible Jira projects
Inputs: no named parameters.
get_jira_transitionsC
Get available workflow transitions for a Jira issue
Inputs: issue_key (required).
search_jira_issuesC
Search for Jira issues using JQL (Jira Query Language)
Inputs: jql (required), max_results.
transition_jira_issueC
Transition a Jira issue to a new status
Inputs: issue_key (required), transition_id (required), comment, fields.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Every tool has a clearly distinct purpose targeting specific Jira resources and actions. The tools cover different operations like creation, retrieval, searching, and transitions without overlap, making it easy for an agent to select the right tool for each task.
All tool names follow a consistent verb_noun pattern with 'jira' as a prefix (e.g., create_jira_issue, get_jira_projects). The naming is uniform across all tools, using snake_case and clear action verbs, which enhances predictability and readability.
With 10 tools, this server is well-scoped for Jira operations, covering core functionalities like issue management, project handling, and workflow transitions. Each tool serves a specific purpose without redundancy, making the count appropriate for the domain.
The tool set provides comprehensive coverage for key Jira workflows, including CRUD operations for issues and projects, searching, and transitions. A minor gap is the lack of tools for updating or deleting issues or projects, which agents might need to work around, but core operations are well-covered.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- FlicenseDqualityDmaintenanceA Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.33-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.1-
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.72TypeScriptMIT
- AlicenseCqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with Jira Cloud instances, providing capabilities for issue management, project listing, and JQL search.12MIT