MCP 아틀라시안

Atlassian 제품(Confluence 및 Jira)용 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 통합은 Confluence 및 Jira 클라우드와 서버/데이터 센터 배포를 모두 지원합니다.

사용 예

AI 비서에게 다음을 요청하세요.

📝 자동 Jira 업데이트 - "회의 메모에서 Jira 업데이트"
🔍 AI 기반 Confluence 검색 - "Confluence에서 OKR 가이드를 찾아 요약해 보세요"
🐛 스마트 Jira 이슈 필터링 - "지난주 PROJ 프로젝트의 긴급 버그를 보여주세요"
📄 콘텐츠 제작 및 관리 - "XYZ 기능에 대한 기술 설계 문서 작성"

기능 데모

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

호환성

제품	배포 유형	지원 상태
합류	구름	✅ 완벽히 지원됨
합류	서버/데이터 센터	✅ 지원됨(버전 6.0+)
지라	구름	✅ 완벽히 지원됨
지라	서버/데이터 센터	✅ 지원됨(버전 8.14+)

빠른 시작 가이드

1. 인증 설정

먼저 Confluence 및 Jira에 필요한 인증 토큰을 생성합니다.

클라우드용

https://id.atlassian.com/manage-profile/security/api-tokens 로 이동하세요
API 토큰 만들기를 클릭하고 이름을 지정하세요.
토큰을 즉시 복사하세요

서버/데이터 센터용

프로필(아바타) → 프로필 → 개인 액세스 토큰 으로 이동하세요.
토큰 만들기를 클릭하고 이름을 지정하고 만료일을 설정합니다.
토큰을 즉시 복사하세요

2. 설치

MCP Atlassian을 사용하는 기본 방법은 IDE 통합을 통한 것입니다.

옵션 1: uvx 사용(권장)

먼저 uv를 설치하세요:

macOS/리눅스:

지엑스피1

윈도우:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

uv 설치되면 패키지를 별도로 설치하지 않고도 IDE 구성에서 uvx mcp-atlassian 직접 사용할 수 있습니다.

옵션 2: pip 사용

pip install mcp-atlassian

옵션 3: 대장간 사용

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

옵션 4: Docker 사용

저장소를 복제합니다.
git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian
Docker 이미지를 빌드합니다.
docker build -t mcp/atlassian .

3. 주요 구성 옵션

IDE에서 구성할 때 다음과 같은 선택적 환경 변수를 사용할 수 있습니다.

CONFLUENCE_SPACES_FILTER : 스페이스 키로 필터링(예: "DEV, TEAM, DOC")
JIRA_PROJECTS_FILTER : 프로젝트 키(예: "PROJ, DEV, SUPPORT")로 필터링합니다.
READ_ONLY_MODE : 쓰기 작업을 비활성화하려면 "true"로 설정합니다.
MCP_VERBOSE : 더 자세한 로깅을 위해 "true"로 설정

참고: 필요한 서비스에 대한 변수만 포함하여 Confluence만, Jira만 또는 두 서비스를 모두 구성할 수 있습니다.

사용 가능한 모든 옵션은 .env.example 파일을 참조하세요.

IDE 통합

MCP Atlassian은 IDE 통합을 통해 AI 어시스턴트와 함께 사용하도록 설계되었습니다.

참고 : Claude Desktop에서 구성을 적용하려면:
방법 1(권장) : 햄버거 메뉴(☰) > 설정 > 개발자 > "구성 편집" 버튼을 클릭합니다.
방법 2 : 구성 파일을 직접 찾아 편집합니다.
윈도우 : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
리눅스 : ~/.config/Claude/claude_desktop_config.json
커서의 경우 : 설정 → 기능 → MCP 서버 → + 새 글로벌 MCP 서버 추가를 엽니다.

설치 방법에 따라 설정하는 방법은 다음과 같습니다.

uvx 사용(권장)

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

서버/데이터 센터 배포의 경우 대신 다음 환경 변수를 사용하세요.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_token",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_token"
      }
    }
  }
}

Confluence에만 해당:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Jira에만 해당:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

환경 변수 대신 명령줄 인수를 사용할 수도 있습니다.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

pip로 mcp-atlassian을 설치한 경우 대신 이 구성을 사용하세요.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Docker 이미지를 빌드한 경우 다음 구성을 사용하세요.

방법 1: 환경 변수 사용

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

방법 2: 환경 파일 사용

저장소의 .env.example 템플릿을 기반으로 .env 파일을 만들고 변수로 채운 다음 다음을 사용합니다.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--env-file", "/path/to/your/.env", "mcp/atlassian"]
    }
  }
}

SSE 전송 구성

다음을 사용하여 서버를 시작합니다.

uvx mcp-atlassian --transport sse --port 9000 \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

IDE에서 구성:

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

리소스 및 도구

자원

confluence://{space_key} : Confluence 공간에 접근합니다.
jira://{project_key} : Jira 프로젝트에 접근합니다.

참고: MCP 서버는 사용자의 기여와 과제를 기반으로 사용자가 적극적으로 상호 작용하는 Confluence 공간과 Jira 프로젝트만 표시하도록 리소스를 필터링합니다.

주요 도구

Confluence 도구

confluence_search : CQL을 사용하여 Confluence 콘텐츠 검색
confluence_get_page : 특정 페이지의 콘텐츠를 가져옵니다
confluence_create_page : 새 페이지를 만듭니다
confluence_update_page : 기존 페이지 업데이트

지라 도구

jira_get_issue : 특정 이슈에 대한 세부 정보를 가져옵니다.
jira_search : JQL을 사용하여 문제 검색
jira_create_issue : 새로운 이슈를 생성합니다
jira_update_issue : 기존 이슈를 업데이트합니다.
jira_transition_issue : 이슈를 새로운 상태로 전환합니다.
jira_add_comment : 이슈에 댓글을 추가합니다.

Confluence 도구	지라 도구
`confluence_search`	`jira_get_issue`
`confluence_get_page`	`jira_search`
`confluence_get_page_children`	`jira_get_project_issues`
`confluence_get_page_ancestors`	`jira_get_epic_issues`
`confluence_get_comments`	`jira_create_issue`
`confluence_create_page`	`jira_batch_create_issues`
`confluence_update_page`	`jira_update_issue`
`confluence_delete_page`	`jira_delete_issue`
	`jira_get_transitions`
	`jira_transition_issue`
	`jira_add_comment`
	`jira_add_worklog`
	`jira_get_worklog`
	`jira_download_attachments`
	`jira_link_to_epic`
	`jira_get_agile_boards`
	`jira_get_board_issues`
	`jira_get_sprints_from_board`
	`jira_get_sprint_issues`
	`jira_create_issue_link`
	`jira_remove_issue_link`

문제 해결 및 디버깅

일반적인 문제

인증 실패 :
- 클라우드의 경우: API 토큰을 확인하세요(계정 비밀번호가 아님)
- 서버/데이터 센터의 경우: 개인 액세스 토큰이 유효하고 만료되지 않았는지 확인하세요.
- 이전 Confluence 서버의 경우: 일부 이전 버전에서는 CONFLUENCE_USERNAME 및 CONFLUENCE_API_TOKEN (여기서 토큰은 비밀번호)을 사용한 기본 인증이 필요합니다.
SSL 인증서 문제 : 서버/데이터 센터를 사용하고 SSL 오류가 발생하는 경우 CONFLUENCE_SSL_VERIFY=false 또는 JIRA_SSL_VERIFY=false 설정하세요.
권한 오류 : Atlassian 계정에 공간/프로젝트에 액세스할 수 있는 충분한 권한이 있는지 확인하세요.

디버깅 도구

# Using MCP Inspector for testing
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\logs\mcp*.log | more

보안

API 토큰을 공유하지 마세요
.env 파일을 안전하고 비공개로 유지하세요
모범 사례는 SECURITY.md를 참조하세요.

기여하다

MCP Atlassian에 기여해 주세요! 기여하고 싶으신 분은 다음과 같습니다.

CONTRIBUTING.md 가이드를 확인하세요
개발 환경을 설정하세요.
uv sync --frozen --all-extras --dev pre-commit install
변경 사항을 만들고 풀 리퀘스트를 제출하세요

코드 품질을 위해 사전 커밋 후크를 사용하고 릴리스를 위해 의미적 버전을 따릅니다.

특허

MIT 라이선스에 따라 배포됩니다. 라이선스 파일을 참조하세요. 이 제품은 Atlassian의 공식 제품이 아닙니다.

MCP Atlassian

Integrations