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 있음).

JDRA 웹 → 환경 설정 → API 토큰 에서 발급하고 복사 (발급 시 1회만 표시).

Jira 시나리오("Jira PF3-... 등록")를 쓰려면 Jira 연동 탭에서 Jira 자격증명도 먼저 등록.

git clone https://github.com/minssd2/jdra-mcp.git
cd jdra-mcp
./setup.sh jdra_pat_...   # 복사한 토큰

setup.sh 가 빌드 + Claude Code 등록(user scope) 까지 끝냅니다.

새 claude 세션을 열고 /mcp 에서 jdra ✔ Connected 확인 → 대화창에 자연어로 요청.

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

cd jdra-mcp && git pull && npm install

(새 claude 세션부터 반영)

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} 환경변수 방식으로 둘 수 있습니다.

풀스택팀 민승기 책임.