MCP Atlassian 서버

MCP Atlassian 서버(phuc-nt 제공)

소개

MCP Atlassian Server(phuc-nt 제작) 는 Cline, Claude Desktop, Cursor와 같은 AI 에이전트를 Atlassian Jira와 Confluence에 연결하여 표준화된 인터페이스를 통해 데이터를 쿼리하고 작업을 수행할 수 있도록 하는 Model Context Protocol(MCP) 서버입니다.

참고: 이 서버는 주로 Cline과 함께 사용하도록 설계 및 최적화되었지만 MCP 표준을 따르고 다른 MCP 호환 클라이언트와도 작동할 수 있습니다.

주요 특징:
- AI 에이전트를 Atlassian Jira 및 Confluence에 연결
- 리소스(읽기 전용)와 도구(작업/변이)를 모두 지원합니다.
- MCP Marketplace를 통한 Cline과의 간편한 통합
- 개인 개발 환경을 위한 로컬 우선 디자인
- Cline AI 어시스턴트와의 최적화된 통합

이 프로젝트의 이유

Jira와 Confluence를 매일 사용하는 개발자로서, 저는 이 도구들을 사용하는 데 상당한 시간을 허비했습니다. 도구들이 강력하기는 하지만, 심층적인 작업 중에 끊임없이 컨텍스트를 전환하지 않고도 더 간편하게 상호작용할 수 있는 방법이 절실했습니다.

AI 에이전트와 모델 컨텍스트 프로토콜(MCP)의 등장은 완벽한 기회를 제공했습니다. Jira와 Confluence(Slack, GitHub, Calendar 등 추가 예정)를 제 AI 워크플로에 연결할 수 있는 잠재력을 바로 파악했습니다.

이 프로젝트는 MCP와 AI 에이전트에 대한 학습 여정으로 시작되었지만, 이것이 Atlassian 도구를 매일 사용하는 개인과 조직에 정말 유용한 것으로 발전하기를 바랍니다.

시스템 아키텍처

지엑스피1

설치 및 설정

자세한 설치 및 설정 지침은 AI 어시스턴트 설치 가이드 를 참조하세요. 이 가이드는 Cline과 같은 AI/LLM 어시스턴트가 MCP Atlassian Server를 읽고 자동으로 설정할 수 있도록 특별히 작성되었습니다.

Cline 사용자 참고 : 설치 가이드(llms-install.md)는 Cline AI가 이해하고 실행할 수 있도록 최적화되어 있습니다. Cline에 "MCP Atlassian Server 설치(phuc-nt 제공)"라고 요청하면 Cline이 지침을 분석하여 단계별로 모든 설정을 도와드립니다.

가이드에는 다음이 포함됩니다.

필수 구성 요소 및 시스템 요구 사항
Node.js 환경을 위한 단계별 설정
Atlassian과 연결하기 위한 Cline AI Assistant 구성
Atlassian API 토큰 얻기 및 설정
보안 권장 사항 및 모범 사례

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Atlassian Integration Server를 자동으로 설치하려면:

npx -y @smithery/cli install @phuc-nt/mcp-atlassian-server --client claude

기능 개요

모든 리소스 및 도구에 대한 자세한 설명서는 리소스 및 도구 참조를 참조하세요.

유형	그룹	특징	설명	상태
의지	지라	문제, 프로젝트, 사용자, 댓글, 역할 보기	Jira 데이터 쿼리(JQL, 세부 정보, 목록)	✔
의지	지라	필터, 보드, 대시보드, 스프린트	개발자를 위한 고급 관리	🚧
의지	합류	공간, 페이지, 자식 페이지, 댓글 보기	Confluence 데이터 쿼리	✔
의지	합류	레이블, 첨부 파일, 콘텐츠 버전	고급 문서 관리	🚧
의지	다른	스마트 캐싱, 고급 JQL/CQL, 템플릿	성능, 경험, UI 통합	🚧
도구	지라	문제 생성, 업데이트, 전환	Jira에서의 직접 작업	✔
도구	합류	페이지 생성, 페이지 업데이트(제목, 콘텐츠, 버전, 레이블), 레이블 관리, 댓글 추가	Confluence에서 직접 작업(만들기, 업데이트, 라벨 추가/제거, 댓글 달기)	✔
도구	다른	프롬프트, 샘플링, 개인화	AI 최적화, 개인화, 고급 흐름	🚧

요청 흐름

예시 사용 사례

설치 후 Cline에게 다음 질문을 해보세요.

작업 생성 및 관리
- "프로젝트 DEMO에 로그인 오류에 대한 새로운 이슈를 생성하세요"
- "현재 스프린트에서 나에게 할당된 모든 이슈 찾기"
- "문제 DEMO-43을 완료 상태로 전환"
프로젝트 정보 요약
- "프로젝트 DEMO의 모든 이슈를 요약합니다"
- "DEMO 프로젝트에서 이슈를 담당하는 사람은 누구입니까?"
- "현재 스프린트의 할당되지 않은 이슈를 나열하세요"
Confluence를 사용한 문서화
- "Confluence 페이지 제목을 '회의 메모'로 만드세요"
- "Confluence 페이지 'API 문서'를 새로운 예제와 레이블로 업데이트"
- "아키텍처에 대한 페이지에 '문서' 라벨을 추가하세요"
- "회의 메모" 페이지에서 "초안" 라벨을 제거하세요.
- "Confluence 페이지에 API 문서에 대한 의견을 추가하세요"
분석 및 보고
- "현재 스프린트와 이전 스프린트에서 완료된 이슈 수를 비교하세요"
- "'해야 할 일' 상태에서 가장 많은 문제가 있는 사람은 누구입니까?"

이러한 쿼리는 MCP 서버로 철저히 테스트된 Cline 환경에서 가장 잘 작동합니다.

사용 참고 사항

간단한 JQL : 문제를 검색할 때 공백이나 특수 문자가 없는 간단한 JQL을 사용합니다(예: project=DEMO``project = DEMO AND key = DEMO-43 ).
Confluence 페이지 만들기 : Confluence 페이지를 만들 때는 간단한 HTML 콘텐츠를 사용하고 parentId를 지정하지 않으면 오류가 발생하지 않습니다.
Confluence 페이지 업데이트 : 페이지를 업데이트할 때는 충돌을 방지하기 위해 항상 현재 버전 번호를 포함해야 합니다. 레이블(추가/삭제)도 업데이트할 수 있으며, 콘텐츠에 유효한 저장 형식을 사용해야 합니다.
이슈 생성 : 새로운 이슈를 생성할 때 최상의 성공을 위해 최소한의 필수 필드(projectKey, summary)만 제공하세요.
접근 권한 : 구성된 Atlassian 계정이 상호 작용하려는 프로젝트와 공간에 액세스할 수 있는지 확인하세요.

보안 참고 사항

귀하의 API 토큰은 이를 생성한 사용자의 모든 권한을 상속받습니다.
신뢰할 수 없는 당사자와 토큰을 공유하지 마십시오.
토큰이 포함된 구성 파일을 분석하도록 LLM에 요청할 때는 주의하세요.
llms-install.md 에서 자세한 보안 지침을 확인하세요.

기여 및 지원

GitHub에서 풀 리퀘스트나 이슈를 열어 기여하세요.
추가 지원을 받으려면 MCP/Cline 커뮤니티에 가입하세요.

MCP Atlassian Server(phuc-nt 제작)를 Cline Marketplace에서 클릭 한 번으로 설치할 수 있습니다!
자세한 지침은 llms-install.md 에서 확인하세요.

서버는 개방형 MCP 표준을 사용하지만, 주로 Cline 사용자를 대상으로 설계 및 테스트되었습니다.

MCP Atlassian Server

Integrations