Jira MCP 서버

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

특징

• 접근 가능한 모든 Jira 프로젝트를 가져옵니다.

• 특정 Jira 문제에 대한 세부 정보 가져오기

• JQL(Jira Query Language)을 사용하여 문제 검색

• 새로운 Jira 이슈 생성

• 이슈에 댓글 추가

• 문제에 대해 사용 가능한 전환 가져오기

• 새로운 지위로의 전환 문제

Related MCP server: Jira MCP Server

설치

필수 조건

• 파이썬 3.9 이상

• Jira 인스턴스(클라우드, 서버 또는 데이터 센터)

• uv (선택 사항이지만 종속성 관리를 위해 권장됨)

가상 환경 활성화(권장)

지엑스피1

uv 사용(권장)

pip 사용하기

구성

환경 변수

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

• JIRA_SERVER_URL : Jira 서버의 URL

• JIRA_AUTH_METHOD : 인증 방법('basic_auth' 또는 'token_auth')

• JIRA_USERNAME : 기본 인증을 위한 사용자 이름

• JIRA_PASSWORD : 기본 인증을 위한 비밀번호

• JIRA_TOKEN : API 토큰 또는 개인 액세스 토큰

환경 파일(지역 개발)

구성과 함께 루트 디렉토리에 .env 파일을 만들 수도 있습니다.

용법

명령줄

도커

Claude 데스크톱 통합

Claude Desktop과 함께 이 서버를 사용하려면:

1. 위의 방법 중 하나를 사용하여 서버를 설치하세요.

2. Claude Desktop에서:

   • 설정 -> 개발자로 이동하세요

   • 구성 편집을 클릭하세요

   • 선택한 편집기에서 JSON 구성을 엽니다.

   • 다음 JSON을 추가합니다. ( NOTE : 사용되는 환경 변수는 토큰 인증을 위한 것이며 다른 인증 방식에서는 작동하지 않습니다.)

3. 이제 Claude에게 다음과 같은 질문을 하여 Jira와 상호 작용할 수 있습니다.

   • "Jira에서 내 모든 프로젝트를 보여주세요"

   • "PROJECT-123 문제에 대한 세부 정보를 얻으세요"

   • "PROJECT에 '로그인 문제 해결' 요약과 함께 새 버그를 만듭니다."

   • "나에게 할당된 모든 열린 버그 찾기"

입증

서버는 여러 가지 인증 방법을 지원합니다.

기본 인증

사용자 이름과 비밀번호를 사용하는 Jira Server/Data Center의 경우:

API 토큰(Jira Cloud)

API 토큰을 사용하는 Jira Cloud의 경우:

개인 액세스 토큰(Jira 서버/데이터 센터)

PAT를 사용하는 Jira Server/Data Center(8.14+)의 경우:

사용 가능한 도구

1. get_projects : 접근 가능한 모든 Jira 프로젝트를 가져옵니다.

2. get_issue : 키로 특정 Jira 이슈에 대한 세부 정보를 가져옵니다.

3. search_issues : JQL을 사용하여 Jira 이슈를 검색합니다.

4. create_issue : 새로운 Jira 이슈를 생성합니다.

5. add_comment : Jira 이슈에 댓글을 추가합니다.

6. get_transitions : Jira 이슈에 사용 가능한 워크플로 전환을 가져옵니다.

7. transition_issue : Jira 이슈를 새로운 상태로 전환합니다.

특허

MIT