# jdra-mcp

**Claude(Claude Code)** 로 자연어로 JDRA 이슈를 만들고 주간보고에 등록하는 MCP 서버.
JDRA 기존 REST API 위의 얇은 어댑터로, DB 직접 접근 없이 `create/add-only` 로만 동작한다.

> 예)
> - "Jira PF3-1111 이슈를 JDRA 주간보고에 등록해줘."
> - "ㅇㅇ고객사 기술지원 이슈 만들고 주간보고에 넣어줘. 오늘 지원했고 내용은 ~~. 2m."

---

## 설치 (팀원용 · Claude Code)

세 가지면 됩니다. **Node 설치·JSON 편집 불필요** (Claude Code 터미널에 node 있음).

### 1. 토큰 발급
JDRA 웹 → **환경 설정 → API 토큰** 에서 발급하고 복사 (발급 시 1회만 표시).
> Jira 시나리오("Jira PF3-... 등록")를 쓰려면 **Jira 연동** 탭에서 Jira 자격증명도 먼저 등록.

### 2. 받기 + 설치 (원커맨드)
```bash
git clone https://github.com/minssd2/jdra-mcp.git
cd jdra-mcp
./setup.sh jdra_pat_...   # 복사한 토큰
```
`setup.sh` 가 **빌드 + Claude Code 등록(user scope)** 까지 끝냅니다.

### 3. 확인 + 사용
**새 claude 세션**을 열고 `/mcp` 에서 `jdra ✔ Connected` 확인 → 대화창에 자연어로 요청.

> JDRA 주소는 `https://jdra.pcfilter.co.kr` 로 기본 설정돼 있습니다. 다른 환경이면 `JDRA_BASE_URL` 환경변수로 바꿀 수 있습니다.

---

## 업데이트

```bash
cd jdra-mcp && git pull && npm install
```
(새 claude 세션부터 반영)

## 수동 등록 (setup.sh 대신)

```bash
npm install
claude mcp add --scope user -e JDRA_PAT=jdra_pat_... jdra -- node "$(pwd)/dist/index.js"
```

## 도구

| 도구 | 설명 |
|---|---|
| `jdra_whoami` | 현재 사용자 확인 |
| `jdra_search_customers` / `_product_lines` / `_projects` / `_users` | 이름 → id 조회 |
| `jdra_get_weekly_report` | 내 주간보고 + 필드셋 목록 |
| `jdra_preview_jira_issue` / `jdra_import_jira_issue` | Jira 미리보기 / 가져오기 |
| `jdra_create_issue` | 이슈 생성 (담당자 미지정 시 본인, 제목의 시간 표기 → 작업시간 자동) |
| `jdra_add_issue_to_weekly_report` | 주간보고 필드셋에 등록 |
| `jdra_register_jira_to_weekly_report` | Jira 가져와 주간보고 등록 |
| `jdra_create_and_register_issue` | 이슈 생성 → 주간보고 등록 |

## 보안

- 토큰은 **본인 권한**으로 동작하며, 할 수 있는 일은 **이슈 생성 · 주간보고 등록 · 조회 · Jira 가져오기**로 제한됩니다. 계정 설정·수정·삭제·관리자 기능에는 쓸 수 없습니다.
- 노트북 분실 등으로 토큰이 새면 JDRA 환경설정 → API 토큰에서 즉시 **취소**하세요.
- `setup.sh` 는 토큰을 Claude Code 사용자 설정(`~/.claude.json`)에 저장합니다. 더 엄격히 관리하려면 토큰을 `.mcp.json` + `${JDRA_PAT}` 환경변수 방식으로 둘 수 있습니다.

## 문의

풀스택팀 민승기 책임.