# Jira MCP Server

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

<a href="https://glama.ai/mcp/servers/@SunWooBang/jira-mcp-server">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@SunWooBang/jira-mcp-server/badge" alt="Jira Server MCP server" />
</a>

## 기능

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

## 설치 및 설정

### 1. 환경 변수 설정

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

```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. 의존성 설치

```bash
npm install
```

### 4. 자동 설정 (권장)

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

```bash
npm run setup
```

이 명령어는:
- Jira 연결 정보를 입력받습니다
- `config/.env` 파일을 자동으로 생성합니다
- `config/claude_desktop_config.json` 파일을 자동으로 생성합니다
- Claude Desktop 설정 방법을 안내합니다

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

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

### 6. 서버 실행

```bash
npm start
```

## Claude Desktop 설정

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

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

```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` 파일을 편집:

```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