GitHub 오픈소스 탐험

최근 개발 및 프로젝트 관리에서 다양한 툴을 연동하고, 데이터를 효율적으로 활용하는 것이 중요한 화두가 되고 있습니다. 특히 Jira와 Confluence와 같은 Atlassian 제품을 사용하는 팀에서는 여러 작업을 동시에 진행하면서도 서로 다른 툴 간의 정보 전환이 번거롭게 느껴질 수 있습니다. 이런 문제를 해결해주는 것이 바로 Atlassian MCP Server입니다. 이 오픈소스 프로젝트는 Atlassian Cloud 서비스와 외부 툴 간의 안전한 연결 고리를 제공하여, 개발자와 콘텐츠 제작자들이 보다 효율적으로 작업할 수 있도록 지원합니다.

주요 기능 및 특징

Atlassian MCP Server는 다음과 같은 주요 기능을 제공합니다:

실시간 데이터 접근: Jira, Compass, Confluence의 콘텐츠를 다른 툴에서 직접 검색하고 요약할 수 있습니다. 이를 통해 도구 간의 전환 없이도 필요한 정보를 빠르게 찾을 수 있습니다.
자연어 명령으로 작업 수행: 사용자가 자연어로 명령을 내리면 이슈나 페이지를 생성하거나 업데이트할 수 있습니다. 예를 들어, "회의 노트로부터 티켓 생성"과 같은 명령이 가능합니다.
반복 작업 자동화: 미팅 노트나 사양에서 자동으로 티켓을 생성하는 등 반복적인 작업을 자동화하여, 개발자와 팀원들이 더 창의적인 업무에 집중할 수 있도록 도와줍니다.
다양한 클라이언트 지원: OpenAI의 ChatGPT, GitHub Copilot CLI, Visual Studio Code 등 여러 클라이언트와의 연동을 지원하여 사용자가 원하는 환경에서 쉽게 사용할 수 있습니다.

설치 및 기본 사용법

Atlassian MCP Server를 설치하고 사용하는 것은 생각보다 간단합니다. 다음 단계에 따라 진행해보세요.

사전 준비사항

Atlassian Cloud 계정: Jira, Compass, Confluence 중 하나 이상의 서비스에 대한 접근 권한이 필요합니다.
Node.js: MCP 프로토콜을 사용하는 로컬 프록시를 실행하기 위해 Node.js v18 이상이 필요합니다.
클라이언트 선택: 사용할 클라이언트를 선택해야 합니다. 예를 들어, Visual Studio Code나 OpenAI ChatGPT를 사용할 수 있습니다.

설치 과정

Node.js 설치: Node.js를 설치합니다. Node.js 공식 사이트에서 다운로드할 수 있습니다.
MCP Server 클론: GitHub에서 MCP Server를 클론합니다.

   git clone https://github.com/atlassian/atlassian-mcp-server.git
   cd atlassian-mcp-server

의존성 설치: 필요한 패키지를 설치합니다.

   npm install

서버 실행: MCP 프로토콜을 사용하는 로컬 서버를 실행합니다.

   npm start

OAuth 인증: 브라우저를 통해 OAuth 2.1 인증 절차를 완료하거나 API 토큰을 사용하여 인증합니다.

기본 사용법

서버가 성공적으로 실행된 후에는, 선택한 클라이언트에서 다음과 같은 형식으로 API를 호출하여 데이터를 가져올 수 있습니다.

const { Client } = require('mcp-client');

// 클라이언트 인스턴스 생성
const client = new Client('https://mcp.atlassian.com/v1/mcp');

// 인증 정보 설정
client.setCredentials({
  token: 'YOUR_API_TOKEN'
});

// 데이터 요청
client.get('/jira/issues')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

이 코드는 Jira 이슈 목록을 가져오는 간단한 예제입니다. YOUR_API_TOKEN 부분에는 실제 API 토큰을 입력해야 합니다.

실무에서의 활용 시나리오

Atlassian MCP Server는 여러 실무 환경에서 매우 유용하게 사용될 수 있습니다. 예를 들어, 개발 팀이 매주 회의를 진행하는 경우, 회의 노트를 작성한 후, 다음과 같은 자연어 명령을 통해 티켓을 자동으로 생성할 수 있습니다.

"이번 주 회의에서 논의된 이슈를 기반으로 새로운 티켓 생성"이라는 명령을 사용하여 팀원들이 놓치는 이슈가 없도록 합니다.

이 외에도 프로젝트 관리 도구 사용 시, 진행 중인 이슈를 쉽게 검색하고 업데이트할 수 있어, 팀원 간의 소통과 협업을 원활하게 만드는 데 기여할 수 있습니다.

비슷한 도구와의 비교

Atlassian MCP Server는 유사한 기능을 제공하는 여러 도구와 비교할 때, 특히 보안성과 다양한 클라이언트 지원에서 두드러진 특징을 보입니다. 예를 들어, Zapier나 Integromat과 같은 도구도 자동화 기능을 제공하지만, Atlassian MCP Server는 Atlassian 제품의 보안 모델을 그대로 활용할 수 있어, 기업 내에서 더 안전하게 사용할 수 있습니다.

atlassian/atlassian-mcp-server — Remote MCP Server that securely connects