SunWooBang/jira-mcp-server

Jira MCP Server

Jira와 Claude를 연결하는 Model Context Protocol (MCP) 서버입니다.

기능

• 이슈 검색: JQL을 사용하여 Jira 이슈 검색
• 이슈 조회: 특정 이슈의 상세 정보 확인
• 이슈 생성: 새로운 Jira 이슈 생성
• 이슈 업데이트: 기존 이슈 수정 (제목, 설명, 상태, 담당자)
• 댓글 추가: 이슈에 댓글 추가
• 프로젝트 정보: 프로젝트 정보 조회

설치 및 설정

1. 환경 변수 설정

.env 파일을 생성하고 다음 정보를 입력하세요:

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@domain.com
JIRA_API_TOKEN=your-api-token
DEFAULT_PROJECT_KEY=PROJ

참고: 설정 파일들은 config/ 폴더에 자동으로 생성됩니다.

2. Jira API 토큰 생성

1. Jira에 로그인
2. 계정 설정 > 보안 > API 토큰 생성
3. 생성된 토큰을 .env 파일의 JIRA_API_TOKEN에 입력

3. 의존성 설치

npm install

4. 자동 설정 (권장)

대화형 설정 도구를 사용하여 쉽게 설정할 수 있습니다:

npm run setup

이 명령어는:

• Jira 연결 정보를 입력받습니다
• config/.env 파일을 자동으로 생성합니다
• config/claude_desktop_config.json 파일을 자동으로 생성합니다
• Claude Desktop 설정 방법을 안내합니다

5. 수동 설정 (선택사항)

자동 설정 대신 수동으로 설정하려면 config/.env.example 파일을 복사하여 config/.env로 이름을 바꾸고 값을 수정하세요.

6. 서버 실행

npm start

Claude Desktop 설정

Claude Desktop에서 이 MCP 서버를 사용하려면 설정 파일을 수정해야 합니다.

Windows

%APPDATA%\\Claude\\claude_desktop_config.json 파일을 편집:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["C:\\path\\to\\jira-mcp-server\\index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com",
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

macOS

~/Library/Application Support/Claude/claude_desktop_config.json 파일을 편집:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-server/index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com", 
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

사용 예시

Claude에서 다음과 같은 명령을 사용할 수 있습니다:

이슈 검색

"프로젝트 PROJ에서 상태가 Open인 이슈들을 찾아줘"

이슈 생성

"PROJ 프로젝트에 '새로운 기능 개발' 제목으로 Task 이슈를 생성해줘"

이슈 업데이트

"PROJ-123 이슈의 상태를 'In Progress'로 변경해줘"

댓글 추가

"PROJ-123 이슈에 '작업을 시작했습니다' 댓글을 추가해줘"

지원하는 도구

1. search_issues: JQL로 이슈 검색
2. get_issue: 특정 이슈 조회
3. create_issue: 새 이슈 생성
4. update_issue: 이슈 업데이트
5. add_comment: 댓글 추가
6. get_project_info: 프로젝트 정보 조회

문제 해결

인증 오류

• Jira URL이 올바른지 확인
• API 토큰이 유효한지 확인
• 사용자 이메일이 정확한지 확인

권한 오류

• 사용자가 해당 프로젝트에 접근 권한이 있는지 확인
• 이슈 생성/수정 권한이 있는지 확인

라이선스

MIT License