MCP Atlassian
지라와 컨플루언스를 에이전트 도구로 여는 서버
uvx mcp-atlassian지라와 컨플루언스를 에이전트가 다루게 해 주는 MCP 서버입니다. 클라우드와 자체 설치 환경을 모두 지원하고 인증 방식이 각각 다릅니다. 담당 이슈를 찾고 문서를 검색하고 버그 티켓을 만들고 상태를 바꾸는 작업을 대화로 시킵니다. 설치 없이 실행기로 바로 띄우고 환경 변수로 주소와 계정, 토큰을 넘깁니다. 문서를 언어 모델이 읽기 좋은 형식으로도 제공합니다. 최근 판은 특정 전송 방식의 인증 경계 문제를 고친 보안 배포입니다.
판단
이럴 때 씁니다
- 이슈와 문서를 대화로 찾고 만들어야 할 때
- 티켓 상태 갱신을 에이전트에게 맡기고 싶을 때
- 자체 설치 환경에서도 같은 도구를 쓰고 싶을 때
이럴 땐 쓰지 마세요
- 조직 정책상 토큰 발급이 막혀 있으면 쓸 수 없습니다
- 에이전트가 티켓을 만들고 고치므로 권한 범위를 정해야 합니다
- 특정 전송 방식은 최근까지 인증 경계 문제가 있었습니다
차별점
- 클라우드와 자체 설치 환경을 모두 지원합니다.
- 설치 없이 실행기로 바로 띄웁니다.
- 문서를 언어 모델이 읽기 좋은 형식으로도 제공합니다.
- 보안 문제를 권고와 함께 공개하고 고칩니다.
워크플로
- 01계정에서 토큰을 발급합니다.
- 02클라이언트 설정에 서버와 환경 변수를 넣습니다.
- 03자체 설치 환경이면 다른 인증 변수를 씁니다.
- 04이슈 검색이나 문서 검색을 시켜 확인합니다.
- 05티켓 생성과 상태 변경 권한을 정합니다.
주요 명령
| 명령 | 설명 |
|---|---|
uvx mcp-atlassian | 설치 없이 서버를 띄웁니다. |
JIRA_URL · JIRA_USERNAME · JIRA_API_TOKEN | 클라우드 환경의 인증 변수입니다. |
JIRA_PERSONAL_TOKEN | 자체 설치 환경에서는 이 변수를 씁니다. |
함정
설치 전에 확인하세요
- 특정 전송 방식의 두 엔드포인트에 인증 경계 문제가 있었습니다. 보안 권고가 발행됐으니 그 전송을 쓴다면 반드시 올려야 합니다.
- 클라우드와 자체 설치의 인증 변수가 다릅니다. 섞어 쓰면 연결되지 않습니다.
- 발급한 토큰의 권한이 곧 에이전트의 권한입니다. 읽기 전용이 필요하면 토큰 단계에서 좁혀야 합니다.
- 최신 판은 진행 중인 다음 판 개발을 빼고 보안 수정만 담은 유지 배포입니다. 새 기능을 기대하면 안 됩니다.
비교
이슈 추적기를 에이전트에 붙이는 방법은 직접 REST 를 감싸는 것이 보통인데, 인증 방식이 환경마다 달라 손이 많이 갑니다. 이쪽은 그 차이를 흡수하고 도구 정의까지 갖춰 두었습니다. 대신 토큰 권한이 곧 에이전트 권한이 되므로 범위를 먼저 정해야 합니다.
최근 변경
특정 전송 방식의 인증 경계 문제를 고친 보안 배포와 의존성 호환 고정 두 가지만 담겼습니다. 진행 중인 다음 판 개발 내용은 포함되지 않았습니다.