Jira / Confluence MCP 연동 가이드

개요

Jira와 Confluence를 Claude Code MCP로 연동하면, 터미널을 벗어나지 않고 이슈 조회·생성·댓글 추가, 문서 검색 등을 자연어로 처리할 수 있습니다.

사전 준비

Personal Access Token 발급

Jira

Jira 접속 → 우측 상단 프로필 → Account Settings → Security
Personal Access Token 섹션에서 토큰 생성
생성된 토큰 값 복사

Confluence

Confluence 접속 → 우측 상단 프로필 → Profile → Personal Access Tokens
토큰 생성 후 복사

설치

mcp-atlassian 패키지는 uvx로 실행합니다. uv가 없다면 먼저 설치합니다.

brew install uv

Claude Code 전역 설정

~/.claude.json 파일의 mcpServers 섹션에 아래 내용을 추가합니다.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://jira.yourcompany.com",
        "JIRA_USERNAME": "your_id@yourcompany.com",
        "JIRA_PERSONAL_TOKEN": "<Jira Personal Access Token>",
        "CONFLUENCE_URL": "https://confluence.yourcompany.com",
        "CONFLUENCE_USERNAME": "your_id@yourcompany.com",
        "CONFLUENCE_PERSONAL_TOKEN": "<Confluence Personal Access Token>"
      }
    }
  }
}

~/.claude.json은 숨김 파일입니다. open ~/.claude.json 또는 터미널 편집기로 수정하세요.

설정 위치

설정 파일	적용 범위
`~/.claude.json` → `mcpServers`	전역 (모든 프로젝트에서 사용 가능)
프로젝트 루트 `.mcp.json`	해당 프로젝트에서만 사용

전역 설정을 권장합니다.

연동 확인

Claude Code를 재시작한 후 새 세션에서 테스트합니다.

Jira에서 내가 담당한 이슈 목록 보여줘
Confluence에서 "배포 가이드" 페이지 찾아줘

사용 가능한 주요 기능