MCP Server for JIRA

이 Model Context Protocol (MCP) 서버는, JIRA와의 제휴 기능을 제공합니다. ChatGPT 및 기타 AI 어시스턴트가 JIRA 이슈를 직접 조작할 수 있습니다.

기능

이 MCP 서버는 다음 도구를 제공합니다.

get_issue : JIRA 이슈에 대한 자세한 정보 얻기

설치

# リポジトリをクローン
git clone https://github.com/kuvanov-2/mcp-server-jira.git
cd mcp-server-jira

# 依存関係をインストール
npm install

# ビルド
npm run build

설정

MCP 서버를 사용하려면 다음 설정을 수행해야 합니다.

1. 사전 준비

1-1. 1Password CLI 설정

1Password 데스크톱 앱을 설치합니다.

1Password CLI를 설치합니다.

brew install 1password-cli

1Password(데스크톱 앱) 설정에서 CLI 연동을 활성화합니다.

1-2. JIRA의 API 토큰 취득

여기에서 JIRA API TOKEN을 가져 옵니다.

JIRA의 API 토큰을 1Password에 저장

2. Visual Studio Code 설정

설정 파일을 엽니다.

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

다음 설정을 추가합니다.

{
  "mcpServers": {
	"github.com/kuvanov-2/mcp-server-jira": {
	  "command": "/path/to/mcp-server-jira/start-server.sh",
	  "env": {
		"JIRA_HOST": "https://your-domain.atlassian.net",
		"JIRA_EMAIL": "your-email@example.com",
		"JIRA_API_TOKEN": "op://YOUR_VAULT_NAME/YOUR_ITEM_NAME/info/access token" 
	  },
	  "disabled": false,
	  "autoApprove": []
	}
  }
}

환경 변수 설명:

JIRA_HOST : JIRA의 호스트 URL
JIRA_EMAIL : JIRA 계정 이메일 주소
JIRA_API_TOKEN : 1Password 내에 저장된 JIRA API 토큰에 대한 참조

JIRA의 API TOKEN은 1Password에 저장한다고 가정합니다. JIRA API Token 1Password의 해당 필드에 대한 경로를 지정합니다. 경로는 필드 오른쪽 클릭에서 복사할 수 있습니다.

start-server.sh 스크립트는 자동으로 1Password CLI를 사용하여 환경 변수를 확인하고 서버를 시작합니다.

사용방법

get_issue

JIRA의 이슈에 대한 자세한 정보를 얻으십시오.

<use_mcp_tool>
<server_name>github.com/kuvanov-2/mcp-server-jira</server_name>
<tool_name>get_issue</tool_name>
<arguments>
{
  "issueKey": "PROJ-123"
}
</arguments>
</use_mcp_tool>