MCP Atlassian Server

MCP Atlassian 서버(phuc-nt 제공)

버전 2.1.1의 새로운 기능 🚀

• 리소스/도구 구조를 표준화하기 위해 전체 코드베이스를 리팩토링하고, 콘텐츠 메타데이터 리소스를 완전히 제거하고, 메타데이터를 페이지 리소스에 병합했습니다.
• 새로운 개발자 가이드: 이제 누구나 쉽게 코드베이스를 확장하고 유지관리할 수 있습니다.
• 최신 MCP SDK와의 호환성이 보장되고, 보안, 확장성, 유지 관리성이 향상되었습니다.
• content-metadata에 대한 모든 참조를 제거하기 위해 docs/introduction/resources-and-tools.md 를 업데이트했습니다.

👉 자세한 내용은 전체 변경 내역을 참조하세요.

2.0.1 버전의 새로운 기능 🎉

MCP Atlassian Server v2.0.1은 기능과 성능이 대폭 확장되었습니다!

• 업데이트된 API : 이제 최신 Atlassian API(Jira API v3, Confluence API v2)를 사용합니다.
• 확장된 기능 : 고급 Jira 및 Confluence 기능을 포함하여 기능이 21개에서 48개로 증가했습니다.
• 향상된 보드 및 스프린트 관리 : 완벽한 Agile/Scrum 워크플로 지원
• 고급 Confluence 기능 : 페이지 버전 관리, 첨부 파일 처리 및 댓글 관리
• 개선된 리소스 등록 : 보다 안정적인 경험을 위해 중복 리소스 등록 문제를 해결했습니다.
• 문서 업데이트 : MCP 아키텍처, 리소스/도구 개발을 설명하는 새로운 포괄적인 문서 시리즈

모든 변경 사항, 개선 사항 및 수정 사항에 대한 자세한 내용은 CHANGELOG를 참조하세요.

소개

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를 자동으로 설치하려면:

기능 개요

MCP Atlassian Server를 사용하면 AI 어시스턴트(Cline, Claude Desktop, Cursor 등)가 Jira 및 Confluence에 액세스하고 관리할 수 있으며, 명확성을 위해 다음과 같은 전체 기능을 그룹화할 수 있습니다.

지라

• 이슈 관리
  • 문제 보기, 검색 및 필터링
  • 문제 생성, 업데이트, 전환 및 할당
  • 백로그 또는 스프린트에 이슈 추가, 이슈 순위 지정
• 프로젝트 관리
  • 프로젝트 목록, 프로젝트 세부 정보 및 프로젝트 역할 보기
• 보드 및 스프린트 관리
  • 보드, 보드 구성, 보드의 이슈 및 스프린트 보기
  • 스프린트 생성, 시작 및 종료
• 필터 관리
  • 필터 보기, 생성, 업데이트 및 삭제
• 대시보드 및 가젯 관리
  • 대시보드 및 가젯 보기
  • 대시보드 만들기 및 업데이트
  • 대시보드에 가젯 추가 또는 제거
• 사용자 관리
  • 사용자 세부 정보, 할당 가능한 사용자 및 프로젝트 역할별 사용자 보기

합류

• 공간 관리
  • 공간 목록, 공간 세부 정보 및 공간의 페이지 보기
• 페이지 관리
  • 페이지, 자식 페이지, 상위 페이지, 첨부 파일 및 버전 기록에 대한 세부 정보를 보고, 검색하고, 가져옵니다.
  • 페이지 생성, 업데이트, 이름 변경 및 삭제
• 댓글 관리
  • 페이지에서 댓글 보기, 추가, 업데이트 및 삭제

모든 기능, 리소스 및 도구에 대한 전체 기술 분석은 docs/introduction/resources-and-tools.md 에서 확인하세요.

요청 흐름

보안 참고 사항

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

기여 및 지원

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