tnh-tools — TNH 사내 Claude Code 플러그인

TNH 사내 공통 도구를 Claude Code 플러그인으로 묶은 레포입니다.

포함된 도구:

Jira MCP 서버 — 이슈/코멘트 CRUD, 스프린트 조회, 상태 전환
/tnh-tools:setup — Jira 자격증명 초기 설정
/tnh-tools:link-project — 작업 디렉토리에 Jira 프로젝트 키 연결 (여러 프로젝트 오갈 때)
/tnh-tools:go-healthcheck — Go 서비스에 /HealthCheck 엔드포인트 추가 / 스키마 수정

설치 방법 (팀원)

1단계: 마켓플레이스 등록

~/.claude/settings.json 을 열어 extraKnownMarketplaces 항목을 추가합니다.

{
  "extraKnownMarketplaces": {
    "tnh-plugins": {
      "source": {
        "source": "github",
        "repo": "shjhwoo/tnh-dev-plugin"
      }
    }
  }
}

이미 extraKnownMarketplaces 키가 있으면 tnh-plugins 항목만 안에 추가하면 됩니다.

2단계: Claude Code에서 플러그인 설치

Claude Code를 재시작한 뒤 터미널에서:

/plugins

목록에서 tnh-tools 를 찾아 설치합니다.

3단계: Jira 자격증명 설정

설치 후 아래 스킬을 실행해 본인 Jira 계정 정보를 입력합니다.

/tnh-tools:setup

안내에 따라 아래 정보를 입력하면 ~/.config/tnh-tools/jira.json 에 저장됩니다.

항목	설명	예시
`JIRA_BASE_URL`	Atlassian Cloud URL	`https://trustnhope.atlassian.net`
`JIRA_EMAIL`	Jira 로그인 이메일	`[email protected]`
`JIRA_API_TOKEN`	Atlassian API 토큰	발급 방법 참고
`JIRA_MY_ACCOUNT_ID`	Jira 계정 ID	`62b52b87b8...`
`JIRA_PROJECT_KEY`	기본 프로젝트 키	`ST`

4단계: Claude Code 재시작

설정 완료 후 Claude Code를 재시작하면 모든 도구를 사용할 수 있습니다.

API 토큰 발급

https://id.atlassian.com/manage-profile/security/api-tokens 접속
Create API token 클릭
이름 입력 후 생성 → 토큰 복사

⚠️ 토큰은 생성 시 한 번만 표시됩니다. 반드시 즉시 복사하세요.

계정 ID 확인

Jira에서 우측 상단 프로필 클릭 → Profile → URL의 마지막 경로 세그먼트

https://trustnhope.atlassian.net/jira/people/62b52b87b8e499e567eab194
                                              ^^^^^^^^^^^^^^^^^^^^^^^^
                                              이 부분이 accountId

사용 가능한 도구

Jira MCP 도구

Claude에게 자연어로 요청하면 됩니다.

도구	설명
`create_issue`	이슈 생성
`update_issue`	이슈 필드 수정
`get_issue`	이슈 상세 조회
`list_issues`	JQL 기반 이슈 목록 조회
`delete_issue`	이슈 삭제
`get_child_issues`	하위 이슈 목록 조회
`assign_issue`	본인에게 할당 + 진행 중으로 전환
`transition_issue`	이슈 상태 변경
`get_sprint_status`	현재 스프린트 현황 조회
`list_comments`	코멘트 목록 조회
`add_comment`	코멘트 추가
`update_comment`	코멘트 수정
`delete_comment`	코멘트 삭제

사용 예시:

ST-1234 이슈 진행 중으로 바꿔줘
현재 스프린트 현황 보여줘
ST-1234에 "오늘 작업 완료" 코멘트 달아줘

스킬

스킬	설명
`/tnh-tools:setup`	Jira 자격증명 초기 설정 및 변경
`/tnh-tools:link-project`	현재 디렉토리에 Jira 프로젝트 키 연결 (디렉토리별 자동 적용)
`/tnh-tools:go-healthcheck`	Go 서비스에 `/HealthCheck` 엔드포인트 추가 또는 스키마 수정

여러 Jira 프로젝트를 오갈 때

한 사람이 여러 Jira 프로젝트를 오가며 작업하는 경우, 작업 디렉토리마다 다른 프로젝트 키를 연결해두면 매번 묻지 않아도 자동으로 적용됩니다.

각 작업 디렉토리에서:

/tnh-tools:link-project

해당 디렉토리에 .jira-mcp.json 파일이 생성되고, 그 디렉토리에서 Claude Code를 켜면 jira-mcp가 자동으로 그 프로젝트 키를 사용합니다.

프로젝트 키 우선순위 (위가 우선):

환경변수 JIRA_PROJECT_KEY
<cwd>/.claude/settings.json 의 jira.projectKey
<cwd>/.jira-mcp.json 의 projectKey
글로벌 ~/.config/tnh-tools/jira.json 의 JIRA_PROJECT_KEY (fallback)

플러그인 업데이트 (관리자)

코드 변경 후 배포

# jira-mcp 코드 수정 후 빌드 (dist/ 를 함께 커밋)
cd jira-mcp
npm run build
cd ..

# 커밋 & 푸시
git add .
git commit -m "feat: ..."
git push origin main

팀원은 Claude Code에서 /plugins → tnh-tools → Update 로 최신 버전을 받을 수 있습니다.

레포 구조

tnh-dev-plugin/
├── .claude-plugin/
│   ├── plugin.json          # 플러그인 메타데이터
│   └── marketplace.json     # 마켓플레이스 인덱스
├── .mcp.json                # MCP 서버 설정 (CLAUDE_PLUGIN_ROOT 사용)
├── skills/
│   ├── setup/               # /tnh-tools:setup
│   └── go-healthcheck/      # /tnh-tools:go-healthcheck
└── jira-mcp/
    ├── src/                 # TypeScript 소스
    └── dist/                # 빌드 결과물 (git 포함)

자격증명 보안

~/.config/tnh-tools/jira.json 은 본인 로컬 머신에만 저장됩니다
이 레포에는 자격증명이 포함되지 않습니다
.gitignore 에 .env 가 등록되어 있어 실수로 커밋되지 않습니다

tnh-tools

Popularity

What's Inside

README