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 토큰 생성
- Jira에 로그인
- 계정 설정 > 보안 > API 토큰 생성
- 생성된 토큰을
.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 이슈에 '작업을 시작했습니다' 댓글을 추가해줘"
지원하는 도구
- search_issues: JQL로 이슈 검색
- get_issue: 특정 이슈 조회
- create_issue: 새 이슈 생성
- update_issue: 이슈 업데이트
- add_comment: 댓글 추가
- get_project_info: 프로젝트 정보 조회
문제 해결
인증 오류
- Jira URL이 올바른지 확인
- API 토큰이 유효한지 확인
- 사용자 이메일이 정확한지 확인
권한 오류
- 사용자가 해당 프로젝트에 접근 권한이 있는지 확인
- 이슈 생성/수정 권한이 있는지 확인
라이선스
MIT License