Jira MCP 서버

Jira의 REST API와 통합을 제공하는 모델 컨텍스트 프로토콜 서버로, AI 어시스턴트가 Jira 이슈를 프로그래밍 방식으로 관리할 수 있도록 해줍니다.

특징

이 서버는 Jira 문제를 관리하기 위한 도구를 제공합니다.

• 새로운 이슈 생성(작업, 에픽, 하위 작업)

• 선택적 상태 필터링을 사용하여 문제 나열

• 기존 문제 업데이트(요약, 설명, 상태)

• 자세한 문제 정보를 얻으세요

• 문제 삭제

• 이슈에 댓글 추가

Related MCP server: JIRA MCP Server

설정

필수 조건

1. API 액세스가 가능한 Jira 계정

2. Jira API 토큰( Atlassian 계정 설정 에서 생성 가능)

설치

1. 종속성 설치:

지엑스피1

2. 서버를 빌드하세요:

npm run build

구성

1. 작업 디렉토리에 .jira-config.json 파일을 만듭니다.

{
  "projectKey": "YOUR_PROJECT_KEY"
}

2. Jira 자격 증명을 사용하여 MCP 서버를 구성하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

사용 가능한 도구

이슈 생성

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

• 필수 매개변수:

  • working_dir: .jira-config.json이 포함된 디렉토리

  • 요약: 호 제목

  • 설명: 문제 설명

  • 유형: 이슈 유형(작업, 에픽 또는 하위 작업)

목록_문제

프로젝트의 문제를 나열합니다

• 필수 매개변수:

  • working_dir: .jira-config.json이 포함된 디렉토리

• 선택 매개변수:

  • 상태: 상태별로 필터링(예: "해야 할 일", "진행 중", "완료")

업데이트_문제

기존 문제를 업데이트합니다

• 필수 매개변수:

  • working_dir: .jira-config.json이 포함된 디렉토리

  • issue_key: 발급 키(예: PRJ-123)

• 선택 매개변수:

  • 요약: 새로운 제목

  • 설명: 새로운 설명

  • 상태: 새로운 상태

get_issue

특정 문제에 대한 자세한 정보를 얻습니다.

• 필수 매개변수:

  • working_dir: .jira-config.json이 포함된 디렉토리

  • issue_key: 발급 키(예: PRJ-123)

삭제_문제

Jira 이슈를 삭제합니다

• 필수 매개변수:

  • working_dir: .jira-config.json이 포함된 디렉토리

  • issue_key: 발급 키(예: PRJ-123)

댓글 추가

기존 문제에 주석을 추가합니다.

• 필수 매개변수:

  • working_dir: .jira-config.json이 포함된 디렉토리

  • issue_key: 발급 키(예: PRJ-123)

  • comment: 추가할 댓글 텍스트

개발

자동 재빌드를 사용한 개발의 경우:

npm run watch

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 잘못된 프로젝트 키

• 구성이 누락되었습니다

• 잘못된 문제 유형

• API 인증 오류

• 잘못된 상태 전환

출력 형식

문제 정보는 다음을 포함하도록 형식화되어 있습니다.

• 이슈 키 및 요약

• 문제 유형 및 상태

• 생성 날짜 및 생성자

• 설명

• 작성자 및 타임스탬프가 포함된 댓글(있는 경우)