JiraとCursorのMCP接続で開発効率を爆上げする方法

# JiraとCursorのMCP接続で開発効率を爆上げする方法

## はじめに

最近注目されているCursor IDEのMCP（Model Context Protocol）機能を使って、Jiraと連携する方法を解説します。この連携により、エディタ上で直接Jiraの課題管理ができるようになり、開発フローが大幅に改善されます。

## 🎯 この記事で得られること

- JiraとCursorのMCP接続方法
- 実際の設定手順（コード付き）
- よくあるトラブルの解決方法
- 実用的な使用例

## 📋 前提条件

以下の環境が整っていることを確認してください：

- ✅ Cursor IDEがインストール済み
- ✅ Jiraアカウント（Atlassian Cloud）
- ✅ 対象プロジェクトへのアクセス権限
- ✅ 基本的なJSON/環境変数の知識

## 🔑 Step 1: Jira APIトークンの取得

### 1-1. Atlassianアカウントにログイン

1. [Atlassian Account](https://id.atlassian.com/)にアクセス
2. 右上のプロフィールアイコンをクリック
3. **「アカウント設定」** を選択

### 1-2. APIトークン作成

```bash
アカウント設定 → セキュリティ → APIトークンを作成および管理
```

1. **「APIトークンを作成」** をクリック
2. わかりやすいラベルを入力（例：`cursor-mcp-integration`）
3. **「作成」** をクリック
4. 🚨 **重要**: 生成されたトークンを必ずコピーして安全に保存

:::note warn
APIトークンは一度しか表示されません。必ず安全な場所に保存してください。
:::

## ⚙️ Step 2: CursorのMCP設定

### 2-1. 設定ファイルの場所を確認

Cursorの設定ファイルは以下の場所にあります：

- **Windows**: `%APPDATA%\Cursor\User\settings.json`
- **macOS**: `~/Library/Application Support/Cursor/User/settings.json`
- **Linux**: `~/.config/Cursor/User/settings.json`

### 2-2. MCP設定の追加

設定ファイルに以下の設定を追加します：

```json
{
  "mcp": {
    "servers": {
      "jira": {
        "command": "npx",
        "args": ["@modelcontextprotocol/server-jira"],
        "env": {
          "JIRA_URL": "https://your-domain.atlassian.net",
          "JIRA_EMAIL": "your-email@example.com",
          "JIRA_API_TOKEN": "your-api-token-here"
        }
      }
    }
  }
}
```

### 2-3. 環境変数での設定（推奨）

セキュリティを考慮し、環境変数を使用することを強く推奨します：

```bash
# .env ファイルまたはシステム環境変数
export JIRA_URL="https://your-domain.atlassian.net"
export JIRA_EMAIL="your-email@example.com"
export JIRA_API_TOKEN="your-api-token-here"
```

設定ファイルでは環境変数を参照：

```json
{
  "mcp": {
    "servers": {
      "jira": {
        "command": "npx",
        "args": ["@modelcontextprotocol/server-jira"],
        "env": {
          "JIRA_URL": "${JIRA_URL}",
          "JIRA_EMAIL": "${JIRA_EMAIL}",
          "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
        }
      }
    }
  }
}
```

## 🔄 Step 3: 接続の確認とテスト

### 3-1. Cursorの再起動

設定完了後、Cursorを完全に再起動します。

### 3-2. MCP接続状態の確認

1. Cursorのコマンドパレット（`Cmd/Ctrl + Shift + P`）を開く
2. `MCP` と検索
3. **「MCP: Show Connected Servers」** を実行
4. `jira` サーバーが一覧に表示されることを確認

### 3-3. 基本的な動作テスト

チャット機能で以下を試してみましょう：

```
現在のJiraプロジェクトの課題一覧を表示してください
```

## 💡 実用的な使用例

### 課題の検索と表示

```
JQL: project = "PROJECT_KEY" AND status = "In Progress"
```

### 新しい課題の作成

```
以下の内容でJira課題を作成してください：
- プロジェクト: MY_PROJECT
- 課題タイプ: バグ
- サマリー: ログイン機能の不具合修正
- 説明: ユーザーがログインできない問題を修正する
```

### 課題へのコメント追加

```
ISSUE-123に進捗状況をコメントとして追加してください：
「実装完了、テスト環境でのテストを開始します」
```

## 🔧 トラブルシューティング

### よくあるエラーと解決方法

| エラー | 原因 | 解決方法 |
|--------|------|----------|
| `401 Unauthorized` | APIトークンが無効 | トークンを再生成して設定し直す |
| `403 Forbidden` | プロジェクトへのアクセス権限なし | Jira管理者に権限を確認 |
| `404 Not Found` | JiraのURLが間違っている | URLを正しい形式で設定 |
| `Connection timeout` | ネットワークまたはファイアウォール | プロキシ設定を確認 |

### デバッグ方法

1. **ログの確認**
   - Cursorの開発者ツール（`Help > Toggle Developer Tools`）でコンソールを確認

2. **設定の再確認**
   ```bash
   # 環境変数が正しく設定されているか確認
   echo $JIRA_URL
   echo $JIRA_EMAIL
   # APIトークンは表示しない（セキュリティ上の理由）
   ```

3. **手動でのAPI接続テスト**
   ```bash
   curl -H "Authorization: Basic $(echo -n 'your-email:your-api-token' | base64)" \
        https://your-domain.atlassian.net/rest/api/3/myself
   ```

## 🚀 応用的な活用方法

### 1. 開発ワークフローとの統合

```javascript
// コミットメッセージにJira課題番号を自動挿入
git commit -m "ISSUE-123: Fix login validation bug"
```

### 2. 課題の自動ステータス更新

作業開始時：
```
ISSUE-123のステータスを「進行中」に変更してください
```

完了時：
```
ISSUE-123のステータスを「完了」に変更し、作業時間を2.5時間で記録してください
```

### 3. コードレビューとの連携

```
現在のブランチに関連するJira課題の詳細を表示してください
```

## 📈 メリットとベストプラクティス

### メリット

- ✨ エディタとプロジェクト管理ツールの境界がなくなる
- ⚡ コンテキストスイッチの削減
- 🔄 リアルタイムでの課題情報同期
- 📊 開発進捗の可視化向上

### ベストプラクティス

1. **セキュリティ**: APIトークンは環境変数で管理
2. **権限管理**: 必要最小限の権限でAPIトークンを作成
3. **定期更新**: APIトークンを定期的に更新
4. **チーム共有**: 設定方法をチーム内で標準化

## 🎉 まとめ

JiraとCursorのMCP連携により、開発者の生産性が大幅に向上します。初期設定は少し複雑ですが、一度設定すれば継続的にメリットを享受できます。

ぜひ試してみて、開発ワークフローの改善を実感してください！

## 📚 参考リンク

- [Cursor公式ドキュメント](https://cursor.sh/docs)
- [Jira REST API ドキュメント](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
- [Model Context Protocol](https://modelcontextprotocol.io/)

---

**質問やフィードバックがあれば、コメントでお気軽にお聞かせください！** 👋