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 トークン

Related MCP server: JIRA MCP Tools

利用可能なツール

1. ユーザー管理

// Get user's account ID by email
{
  email: "user@example.com";
}

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デスクトップの設定

この MCP サーバーを Claude Desktop で使用するには:

Claude Desktop 構成ファイルを見つけます。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
- Linux: ~/.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