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にアクセス
2. 右上のプロフィールアイコンをクリック
3. 「アカウント設定」 を選択

1-2. APIトークン作成

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

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

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設定の追加

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

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

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

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

# .env ファイルまたはシステム環境変数
export JIRA_URL="https://your-domain.atlassian.net"
export JIRA_EMAIL="[e-mail]"
export JIRA_API_TOKEN="your-api-token-here"

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

{
  "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. 設定の再確認

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

3. 手動でのAPI接続テスト

   curl -H "Authorization: Basic $(echo -n 'your-email:your-api-token' | base64)" \
        https://your-domain.atlassian.net/rest/api/3/myself
   

🚀 応用的な活用方法

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

// コミットメッセージに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公式ドキュメント
• Jira REST API ドキュメント
• Model Context Protocol

---

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