Jira MCP Server

🚀 Jira MCP サーバー

自然言語で Jira と対話し、プロジェクト情報を取得し、プロジェクトを変更できます。Claude デスクトップと組み合わせて使用し、プロジェクト情報を含むカスタム README を作成することで、PM タスクを委託できます（例：チームメンバーとその専門分野のリストがある場合、新しい問題を最も関連する人に割り当てることができます）。

このサーバーは Model Context Protocol に基づいて構築されています。

✨ 主な機能

• プロジェクトの作成と設定
• 問題およびサブタスクの管理
• 問題のリンクと依存関係
• 問題の自動化ワークフロー

📦 インストール

必要な環境変数は以下の通りです：

• JIRA_HOST: あなたの Jira インスタンスのホスト名
• JIRA_EMAIL: あなたの Jira アカウントのメールアドレス
• JIRA_API_TOKEN: https://id.atlassian.com/manage-profile/security/api-tokens から取得した API トークン

💻 使用例

基本的な使用法

1. ユーザー管理

// メールアドレスからユーザーのアカウント ID を取得
{
  email: "user@example.com";
}

2. 問題タイプ管理

// 利用可能なすべての問題タイプをリストする
// 返り値：id、名前、説明、サブタスクの状態
// パラメーター不要

3. 問題リンクタイプ

// 利用可能なすべての問題リンクタイプをリストする
// 返り値：id、名前、inward/outward の説明
// パラメーター不要

4. 問題管理

問題の取得

// プロジェクト内のすべての問題を取得
{
  projectKey: "PROJECT"
}

// 単一の問題の詳細情報を取得
{
  issueIdOrKey: "issues/ABC-123"
}

問題の作成

// 新しい問題を作成
{
  method: POST,
  body: {
    fields: {
      project: { key: "project_key" },
      issuetype: { name: "Task" },
      title: "問題タイトル",
      description: "問題の説明"
    }
  }
}

問題の更新

// 既存の問題を更新
{
  method: PUT,
  body: {
    fields: {
      status: { name: "已解决" },
      priority: { name: "高" },
      assignee: { email: "user@example.com" }
    }
  }
}

問題の削除

// 問題を削除
{
  method: DELETE
}

高度な使用法

記述フィールド

記述フィールドは以下の形式をサポートしています：

• 見出し: # で見出しを指定します。例：# これは見出しです
• 段落: テキストを直接入力します。例：これは段落の内容です。
• リスト: - を使って箇条書きを作成します。例：
  • 最初のリスト項目
  • 2 番目のリスト項目
• コードブロック: バッククォート \ `` でコードを囲みます。例：

  console.log("Hello, World!");
  

• 強調: * または _ を使って強調テキストを作成します。例：*これは強調された文字*_
• リンク: [テキスト](URL) でハイパーリンクを作成します。例：[公式サイトを訪問](https://www.example.com)

エラー処理

• 400 エラー: リクエストの形式が誤っているか、パラメーターが不足しています。
• 401 エラー: 認証されていません。API トークンが有効かどうかを確認してください。
• 404 エラー: リソースが存在しません。
• 500 エラー: サーバー内部エラーです。

設定コマンド

この MCP サーバーを Claude デスクトップと併用するには、以下の手順を実行します：

1. Claude デスクトップの設定ファイルを見つけます：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 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 をあなたのクローンしたリポジトリの実際のパスに置き換えてください。

3. Claude デスクトップを再起動して変更を適用します。

📚 ドキュメント

• Model Context Protocol
• Jira REST API ドキュメント
• Jira REST API の例