使用说明
atlassian-tmp-bridge
Jira Cloud MCP server. Issues, comments, attachments, transitions, bulk operations. Clone/build/install 없이 uvx로 바로 실행 가능.
Why?
공식 Atlassian MCP 서버는 이슈 조회와 검색은 가능하지만, 첨부파일 다운로드(#15), 이슈 생성/수정/삭제, 상태 전환, 벌크 작업 등 쓰기 작업이 제한적입니다. 이 서버는 해당 기능들을 보완합니다.
Requirements
- uv (
brew install uvorcurl -LsSf https://astral.sh/uv/install.sh | sh) - Jira Cloud API token (생성 페이지)
Setup
Claude Code
claude mcp add jira-bridge \
-e JIRA_DOMAIN=your-org.atlassian.net \
-e JIRA_EMAIL=your@email.com \
-e JIRA_API_TOKEN=your_token \
-- uvx --from git+https://github.com/Bldg-7/atlassian-tmp-bridge serve
Manual (mcp.json)
{
"mcpServers": {
"jira-bridge": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Bldg-7/atlassian-tmp-bridge", "serve"],
"env": {
"JIRA_DOMAIN": "your-org.atlassian.net",
"JIRA_EMAIL": "your@email.com",
"JIRA_API_TOKEN": "your_token"
}
}
}
}
Tools
Issues
| Tool | Description |
|---|---|
get_issue |
이슈 상세 조회 (summary, status, assignee, description 등) |
search_issues |
JQL로 이슈 검색 (페이지네이션 지원) |
count_issues |
JQL 쿼리 매칭 이슈 수 조회 |
create_issue |
이슈 생성 |
update_issue |
이슈 필드 수정 |
patch_description |
본문(description) 부분 수정 — 정확히 일치하는 Markdown 조각을 찾아 치환 |
delete_issue |
이슈 삭제 |
Comments
| Tool | Description |
|---|---|
get_comments |
이슈의 댓글 목록 조회 |
add_comment |
댓글 추가 |
update_comment |
댓글 수정 |
delete_comment |
댓글 삭제 |
Attachments
| Tool | Description |
|---|---|
list_attachments |
이슈의 첨부파일 목록 조회 |
download_attachment |
첨부파일 다운로드 (base64 이미지로 반환) |
upload_attachment |
파일을 이슈에 첨부 |
Transitions
| Tool | Description |
|---|---|
get_transitions |
이슈의 가능한 상태 전환 목록 조회 |
transition_issue |
이슈 상태 전환 (코멘트 첨부 가능) |
Bulk Operations
| Tool | Description |
|---|---|
bulk_create_issues |
이슈 일괄 생성 (최대 50개) |
bulk_update_issues |
이슈 일괄 수정 (최대 1000개, priority/labels/description) |
Markdown 입력
create_issue / update_issue의 description, add_comment / update_comment의 body, transition_issue의 comment, bulk_create_issues / bulk_update_issues의 description 은 Markdown 으로 작성합니다 (CommonMark + GFM 표/취소선). Heading, 리스트, 코드 블록(언어 지정), 인라인 코드, 강조, 링크, 인용, 표, 구분선이 ADF 노드로 변환되어 Jira WebUI에서 그대로 렌더링됩니다.
마크다운 문법이 없는 평문도 그대로 paragraph 노드로 들어가므로 기존 호출자는 변경 없이 작동합니다.
patch_description의 old_string / new_string도 Markdown입니다. get_issue가 출력하는 본문에서 고칠 부분을 그대로 복사해 넘기면 되며, **굵게** · *기울임* · ~~취소선~~ · `코드` · [텍스트](url) · @[accountId:이름] 같은 서식 문법을 포함해도 됩니다.
old_string이 서식 경계를 가로질러도 매칭됩니다. 서버가 걸쳐 있는 텍스트 런(run)까지 변경 범위를 넓혀 해당 런들을 걷어내고, 그 자리에 new_string을 Markdown → ADF로 변환해 끼워 넣습니다. 나머지 본문 — 다른 블록, 표·패널·미디어, 이 서버가 따로 다루지 않는 노드 타입 — 은 원본 그대로 보존되므로, 긴 본문의 일부만 고칠 때는 update_issue(전체 교체)보다 이 도구를 사용하세요.
| 상황 | 결과 |
|---|---|
| 매칭이 서식 런 하나 안에 들어감 | 그 런의 서식을 물려받음 (굵은 글씨 안의 단어를 바꾸면 계속 굵음) |
| 매칭이 여러 런에 걸침 | 서식은 new_string이 결정 |
| 코드 블록 안 | 두 문자열 모두 리터럴 — Markdown 문법은 의미 없음 |
매칭은 블록(문단, 헤딩, 리스트 항목, 태스크 항목, 표 셀, 코드 블록) 단위이므로 old_string이 블록 경계를 넘거나 블록 자체의 접두사(# , - , - [ ] , | )를 포함할 수는 없습니다. 행 추가·블록 이동 같은 구조 변경은 update_issue로 전체 본문을 다시 작성해야 합니다.
Authentication
Jira Cloud의 개인 API Token을 사용합니다. Basic Auth (email:api_token)로 인증하며, OAuth와 달리 토큰 만료/재인증 문제가 없습니다.
필요 권한: 해당 프로젝트의 Browse projects 권한 (조회), Edit issues 권한 (수정/생성) 등 작업에 맞는 프로젝트 권한이 필요합니다.
License
MIT
