Integrations

Connects to Atlassian's Jira platforms (Cloud, Server, or Data Center) using various authentication methods including Basic Auth, API tokens, and Personal Access Tokens.
Provides tools for interacting with Jira's REST API, enabling project browsing, issue management (viewing, creating, searching), commenting on issues, and transitioning issues through workflows.

Jira MCP 서버

jira-python 라이브러리를 사용하여 Jira의 REST API와 상호작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Claude Desktop 및 기타 MCP 클라이언트와 통합되어 자연어 명령을 사용하여 Jira와 상호작용할 수 있습니다.

특징

접근 가능한 모든 Jira 프로젝트를 가져옵니다.
특정 Jira 문제에 대한 세부 정보 가져오기
JQL(Jira Query Language)을 사용하여 문제 검색
새로운 Jira 이슈 생성
이슈에 댓글 추가
문제에 대해 사용 가능한 전환 가져오기
새로운 지위로의 전환 문제

설치

필수 조건

파이썬 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-jira

pip 사용하기

pip install mcp-server-jira

구성

환경 변수

환경 변수를 사용하여 서버를 구성합니다.

JIRA_SERVER_URL : Jira 서버의 URL
JIRA_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-jira

Claude 데스크톱 통합

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude Desktop 및 기타 MCP 클라이언트를 통해 Jira 프로젝트, 이슈, 코멘트 및 워크플로를 관리할 수 있도록 자연어 명령을 사용하여 Jira의 REST API와 상호 작용할 수 있는 모델 컨텍스트 프로토콜 서버입니다.

Jira MCP Server