MCP Atlassian

Atlassian 제품(Confluence 및 Jira)을 위한 Model Context Protocol (MCP) 서버입니다. Cloud 및 Server/Data Center 배포를 모두 지원합니다.

점진적 포크 프로필

이 포크는 업스트림의 직접적인 Atlassian MCP 표면을 유지하면서 MCP_PROFILE=progressive로 제어되는 로컬 점진적 프로필을 추가합니다. 점진적 모드에서 서버는 전체 직접 도구 표면 대신 jira_discover, jira_capability_schema, jira_execute_read, jira_execute_write_guarded와 같은 검색/스키마/실행 래퍼만 노출합니다.

업스트림 sooperset/mcp-atlassian에는 현재 이 점진적 레이어가 포함되어 있지 않으므로 업스트림 업데이트는 선택적으로 조정해야 합니다. 업스트림을 무작정 병합하지 마십시오. 그렇지 않으면 점진적 패키지/테스트가 제거될 수 있습니다. FORK_WORKFLOW.md를 참조하세요.

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

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

Related MCP server: MCP Atlassian

빠른 시작

1. API 토큰 받기

https://id.atlassian.com/manage-profile/security/api-tokens로 이동하여 토큰을 생성하세요.

Server/Data Center의 경우 개인 액세스 토큰을 대신 사용하세요. 인증을 참조하세요.

2. IDE 구성

Claude Desktop 또는 Cursor MCP 구성에 추가하세요:

{
  "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",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center 사용자: JIRA_USERNAME + JIRA_API_TOKEN 대신 JIRA_PERSONAL_TOKEN을 사용하세요. 자세한 내용은 인증을 참조하세요.

Autohand Code

Atlassian 자격 증명과 함께 동일한 uvx 서버를 사용하세요:

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  JIRA_USERNAME=your.email@company.com \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  CONFLUENCE_USERNAME=your.email@company.com \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

add 뒤에 --scope project를 추가하여 구성을 현재 프로젝트에 유지하세요. 현재 설치 및 CLI 세부 정보는 Autohand Code를 참조하세요.

3. 사용 시작

AI 어시스턴트에게 다음을 요청하세요:

• "PROJ 프로젝트에서 나에게 할당된 이슈 찾기"

• "Confluence에서 온보딩 문서 검색"

• "로그인 문제에 대한 버그 티켓 생성"

• "PROJ-123의 상태를 Done으로 업데이트"

문서

전체 문서는 **mcp-atlassian.soomiles.com**에서 확인할 수 있습니다.

문서는 LLM이 쉽게 소비할 수 있는 llms.txt 형식으로도 제공됩니다:

• llms.txt — 문서 사이트맵

• llms-full.txt — 전체 문서

호환성

주요 도구

총 98개 도구 — 전체 목록은 도구 참조를 참조하세요.

보안

API 토큰을 공유하지 마세요. .env 파일을 안전하게 유지하세요. SECURITY.md를 참조하세요.

기여

개발 설정은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT - LICENSE를 참조하세요. 공식 Atlassian 제품이 아닙니다.