Jira MCP 서버

Jira에 자연어로 대화하여 프로젝트에 대한 정보를 얻고 수정하세요. Claude Desktop과 함께 프로젝트 정보를 기반으로 직접 생성한 README 파일을 함께 사용하면 PM 업무를 위임할 수 있습니다. (예: 팀원과 각 팀의 전문 분야 목록이 있다면, 새로운 이슈를 가장 관련성 높은 담당자에게 할당할 수 있습니다.)

모델 컨텍스트 프로토콜을 사용하여 구축되었습니다.

서버를 사용하면 다음이 가능합니다.

프로젝트 생성 및 구성
이슈 및 하위 작업 관리
문제 연결 및 종속성
자동화된 이슈 워크플로

구성

필수 환경 변수:

JIRA_HOST : Jira 인스턴스 호스트 이름
JIRA_EMAIL : Jira 계정 이메일
JIRA_API_TOKEN : https://id.atlassian.com/manage-profile/security/api-tokens 의 API 토큰

사용 가능한 도구

1. 사용자 관리

지엑스피1

2. 이슈 유형 관리

// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required

3. 이슈 링크 유형

// List all available issue link types
// Returns: id, name, inward/outward descriptions
// No parameters required

4. 이슈 관리

문제 검색

// Get all issues in a project
{
  projectKey: "PROJECT"
}

// Get issues with JQL filtering
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// Get issues assigned to user
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

문제 만들기

// Create a standard issue
{
  projectKey: "PROJECT",
  summary: "Issue title",
  issueType: "Task",  // or "Story", "Bug", etc.
  description: "Detailed description",
  assignee: "accountId",  // from get_user tool
  labels: ["frontend", "urgent"],
  components: ["ui", "api"],
  priority: "High"
}

// Create a subtask
{
  parent: "PROJECT-123",
  projectKey: "PROJECT",
  summary: "Subtask title",
  issueType: "Subtask",
  description: "Subtask details",
  assignee: "accountId"
}

문제 업데이트

// Update issue fields
{
  issueKey: "PROJECT-123",
  summary: "Updated title",
  description: "New description",
  assignee: "accountId",
  status: "In Progress",
  priority: "High"
}

문제 종속성

// Create issue link
{
  linkType: "Blocks",  // from list_link_types
  inwardIssueKey: "PROJECT-124",  // blocked issue
  outwardIssueKey: "PROJECT-123"  // blocking issue
}

문제 삭제

// Delete single issue
{
  issueKey: "PROJECT-123"
}

// Delete issue with subtasks
{
  issueKey: "PROJECT-123",
  deleteSubtasks: true
}

// Delete multiple issues
{
  issueKeys: ["PROJECT-123", "PROJECT-124"]
}

필드 서식

설명 필드

설명 필드는 마크다운 스타일 서식을 지원합니다.

문단 사이에 빈 줄을 사용하세요
요점 표시에는 "- "를 사용하세요
번호가 매겨진 목록의 경우 "1."을 사용하세요.
":"로 끝나는 헤더를 사용하세요(뒤에 빈 줄이 옵니다)

예:

Task Overview:

This task involves implementing new features:
- Feature A implementation
- Feature B testing

Steps:
1. Design component
2. Implement logic
3. Add tests

Acceptance Criteria:
- All tests passing
- Documentation updated

오류 처리

서버는 다음에 대한 자세한 오류 메시지를 제공합니다.

잘못된 발급 키
필수 필드가 누락되었습니다
권한 문제
API 속도 제한

설치 지침

저장소를 복제합니다.
git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-Server
종속성 설치:
npm install
환경 변수 구성: 루트 디렉토리에 .env 파일을 만듭니다.
JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token
프로젝트를 빌드하세요:
npm run build
서버를 시작합니다:
npm start

Claude Desktop 구성

Claude Desktop과 함께 이 MCP 서버를 사용하려면:

Claude Desktop 구성 파일을 찾으세요.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- 윈도우: %APPDATA%/Claude/claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.json
구성에 Jira MCP 서버를 추가합니다.
{ "mcp_servers": [ { "name": "jira-server", "command": "npm start", "cwd": "/path/to/jira-server", "env": { "JIRA_HOST": "your-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } ] }
/path/to/jira-server 복제된 저장소의 절대 경로로 바꾸세요.
변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

Jira MCP Server

Integrations