Jira MCP 서버 (무료 플랜 지원)

MCP 클라이언트(Claude Desktop 또는 모든 MCP 클라이언트)가 Jira 이슈를 읽고, 생성하고, 업데이트하고, 댓글을 달고, 상태를 전환할 수 있게 해주는 작은 MCP 서버입니다. Jira Cloud의 무료 플랜을 기준으로 구축 및 테스트되었습니다 — 유료 Jira 구독이 필요 없습니다.

제공하는 도구

1. 무료 Jira Cloud 사이트 만들기

1. https://www.atlassian.com/software/jira로 이동하여 가입합니다(무료, 최대 10명의 사용자, 무제한 프로젝트).

2. 프로젝트를 만들고 프로젝트 키(예: PROJ)를 기록해 둡니다 — 프로젝트 이름 옆에 표시됩니다.

3. https://id.atlassian.com/manage-profile/security/api-tokens에서 API 토큰을 생성합니다.

2. 의존성 설치

cd jira-mcp-server
python3 -m venv venv
source venv/bin/activate        # on Windows: venv\Scripts\activate
pip install -r requirements.txt

3. 자격 증명 구성

.env.example을 .env로 복사하고 값을 입력하거나, 또는 셸에서 바로 내보내기(export)하세요:

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token-here

4. 직접 테스트하기 (Claude Desktop 불필요)

test_client.py 상단의 PROJECT_KEY / ISSUE_KEY를 본인의 Jira 프로젝트에 맞게 수정한 후:

python test_client.py

이 명령은 실제 MCP 클라이언트가 하는 것과 같은 방식으로 jira_server.py를 stdio를 통해 하위 프로세스로 실행하고, 사용 가능한 도구를 나열하며, 실제 Jira 사이트에서 get_issue, search_issues, create_issue를 실행합니다.

5. Claude Desktop에 연결하기 (선택 사항)

Claude Desktop MCP 구성(claude_desktop_config.json — 설정 → Developer → Edit Config)에 다음을 추가하세요:

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/jira-mcp-server/venv/bin/python",
      "args": ["/absolute/path/to/jira-mcp-server/jira_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Desktop을 다시 시작하고 "PROJ-1의 상태가 어떻게 되나요?"라고 물어보세요 — get_issue 도구를 호출할 것입니다.

참고 사항 / 주의점

• Jira의 v3 API는 설명과 댓글을 일반 텍스트가 아닌 Atlassian Document Format(ADF)으로 저장합니다. 서버가 양방향 변환을 처리해 줍니다.

• create_issue의 issue_type은 해당 프로젝트에 구성된 유형(일반적으로 Task, Bug, Story, Epic)과 정확히 일치해야 합니다 — "issuetype" 오류가 발생하면 프로젝트의 이슈 유형을 확인하세요.

• 무료 플랜은 월 100회의 자동화 실행과 2GB 스토리지로 제한됩니다 — 이러한 수동/API 테스트에는 관련이 없지만 알아두면 좋습니다.

• 이 서버는 stdio 전송을 사용하므로, MCP 클라이언트가 통신할 때 해당 클라이언트에 의해 로컬에서만 실행됩니다 — 공개 웹 서비스가 아니며, 이는 MCP를 테스트하는 가장 간단하고 일반적인 방법입니다.