정정지용
기술스택 목록
도구

Atlassian MCP

프로젝트 1개에서 사용했습니다. 각 프로젝트에서 어떤 역할로 썼는지 아래에 정리했습니다.

이 기술은 무엇인가요?

Claude가 Atlassian 제품군(Jira, Confluence)에 접근할 수 있게 하는 MCP 서버

Atlassian MCP는 Model Context Protocol을 구현하여 AI 어시스턴트가 Jira, Confluence 등 Atlassian 제품의 데이터를 읽고 쓸 수 있도록 돕는 서버입니다. Claude Desktop이나 다른 MCP 클라이언트에서 이 서버를 등록하면, 자연어 대화만으로 이슈 조회·생성·수정, 문서 검색 등의 작업을 수행할 수 있습니다. API 호출 코드를 직접 작성하는 대신, AI가 필요한 도구(tool)를 선택해 실행하는 방식으로 작업 흐름을 자동화합니다.

이럴 때 사용합니다

  • Claude에게 Jira 이슈를 조회하거나 생성·수정하도록 지시하고 싶을 때
  • 대화형 인터페이스로 Confluence 문서를 검색하고 요약하려 할 때
  • AI 에이전트가 티켓 관리 워크플로우를 자동화하도록 구성할 때
  • API 호출 코드를 매번 작성하지 않고 자연어로 Atlassian 작업을 처리하고 싶을 때

핵심 개념

MCP (Model Context Protocol)
AI 모델이 외부 데이터 소스나 도구에 표준화된 방식으로 접근하도록 정의한 프로토콜입니다. 서버는 도구(tool) 목록을 제공하고, 클라이언트(AI)는 필요한 도구를 호출합니다.
Tool
MCP 서버가 제공하는 개별 기능 단위로, Jira 이슈 생성·조회·업데이트, Confluence 페이지 검색 등이 각각 하나의 도구로 노출됩니다.
Atlassian API Token
Atlassian Cloud 계정에서 발급받는 인증 토큰으로, MCP 서버가 사용자 대신 Jira나 Confluence API를 호출할 때 필요합니다.
Server Configuration
Claude Desktop 설정 파일에 서버 실행 명령, 환경 변수(API 토큰, 사이트 URL 등)를 등록하여 MCP 서버를 활성화하는 과정입니다.

Claude Desktop 설정 예시

Claude Desktop이 시작할 때 Atlassian MCP 서버를 자동으로 실행하고, 환경 변수로 인증 정보를 전달합니다. 이후 Claude는 제공된 도구를 사용해 Jira/Confluence 작업을 수행할 수 있습니다.

JSON
{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-atlassian"],
      "env": {
        "ATLASSIAN_API_TOKEN": "your_api_token_here",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_SITE_URL": "https://yourcompany.atlassian.net"
      }
    }
  }
}

처음 쓸 때 흔한 함정

  • API 토큰을 설정 파일에 평문으로 넣으면 유출 위험이 있으니 환경 변수나 시크릿 관리 도구 사용 권장
  • Atlassian Cloud와 Server/Data Center는 API 엔드포인트가 다르므로 서버 종류를 확인 필요
  • MCP 서버는 Claude가 요청할 때만 실행되므로, 서버 로그는 별도로 확인해야 디버깅 가능

위 개요는 기술 학습을 돕기 위해 자동 생성된 일반 설명입니다. 정확한 사양과 최신 정보는 공식 문서를 확인하세요.

프로젝트별 활용 방식

위 개념이 실제 프로젝트에서 어떻게 쓰였는지 보여줍니다.

함께 사용한 기술

위 프로젝트들에서 같이 쓰인 다른 기술입니다.

Claude CodeExpressGitGitHub CLIJavaScriptNode.jsReactShell ScriptSlack API