Jira Mcp

Jira-MCP क्या है?

Jira-MCP (Model Control Protocol) एक Go-आधारित कनेक्टर है जिसे AI सहायक, जैसे कि Claude, और Atlassian Jira के बीच सहज इंटरैक्शन के लिए डिज़ाइन किया गया है। यह उपकरण AI मॉडलों को विभिन्न Jira संचालन करने की अनुमति देता है, जिसमें मुद्दा प्रबंधन, स्प्रिंट योजना, और कार्यप्रवाह संक्रमण शामिल हैं, जो उत्पादकता को प्रभावी ढंग से बढ़ाता है और परियोजना प्रबंधन प्रक्रियाओं को सरल बनाता है।

Jira-MCP की विशेषताएँ

• AI एकीकरण: Jira-MCP AI सहायकों को Jira के साथ इंटरैक्ट करने की अनुमति देता है, जिससे स्वचालित कार्य प्रबंधन और बेहतर दक्षता संभव होती है।
• मुद्दा प्रबंधन: उपयोगकर्ता AI इंटरफ़ेस के माध्यम से सीधे मुद्दे बना, अपडेट और प्रबंधित कर सकते हैं, जिससे कार्यप्रवाह सरल हो जाता है।
• स्प्रिंट योजना: यह उपकरण परियोजना डेटा के आधार पर AI-चालित अंतर्दृष्टि और सिफारिशें प्रदान करके स्प्रिंट की योजना बनाने में मदद करता है।
• कार्यप्रवाह संक्रमण: Jira-MCP विभिन्न कार्यप्रवाह राज्यों के बीच सुचारू संक्रमण को सुविधाजनक बनाता है, यह सुनिश्चित करते हुए कि कार्य बिना मैनुअल हस्तक्षेप के आगे बढ़ते हैं।
• उपयोगकर्ता-अनुकूल इंटरफ़ेस: कनेक्टर डेवलपर्स और परियोजना प्रबंधकों दोनों के लिए एक सरल और सहज इंटरफ़ेस प्रदान करता है, जिससे इसे मौजूदा सिस्टम में एकीकृत करना आसान हो जाता है।

Jira-MCP का उपयोग कैसे करें

1. स्थापना: अपने Go वातावरण में Jira-MCP कनेक्टर स्थापित करने से शुरू करें। रिपॉजिटरी में दिए गए स्थापना निर्देशों का पालन करें।
2. कॉन्फ़िगरेशन: अपने Jira उदाहरण के साथ कनेक्टर को कनेक्ट करने के लिए कॉन्फ़िगर करें। इसमें आमतौर पर API कुंजियों और अनुमतियों को सेट करना शामिल होता है।
3. AI सहायकों के साथ एकीकृत करें: अपने पसंदीदा AI सहायक के साथ Jira-MCP को कनेक्ट करें। सुनिश्चित करें कि सहायक के पास Jira के साथ इंटरैक्ट करने के लिए आवश्यक अनुमतियाँ हैं।
4. संचालन करें: विभिन्न Jira संचालन करने के लिए AI सहायक का उपयोग करें। आप सहायक से मुद्दे बनाने, कार्य अपडेट करने, या परियोजना जानकारी प्राप्त करने के लिए कह सकते हैं।
5. निगरानी और अनुकूलन: कनेक्टर के प्रदर्शन की निरंतर निगरानी करें और दक्षता बढ़ाने के लिए आवश्यकतानुसार कॉन्फ़िगरेशन को अनुकूलित करें।

अक्सर पूछे जाने वाले प्रश्न

प्रश्न 1: Jira-MCP किस प्रोग्रामिंग भाषा में बनाया गया है?

उत्तर 1: Jira-MCP Go प्रोग्रामिंग भाषा का उपयोग करके बनाया गया है, जो अपने प्रदर्शन और दक्षता के लिए जानी जाती है।

प्रश्न 2: क्या मैं किसी भी संस्करण के Jira के साथ Jira-MCP का उपयोग कर सकता हूँ?

उत्तर 2: Jira-MCP Atlassian Jira के साथ काम करने के लिए डिज़ाइन किया गया है, लेकिन संगतता संस्करण के आधार पर भिन्न हो सकती है। हमेशा विशिष्ट संस्करण आवश्यकताओं के लिए दस्तावेज़ीकरण की जांच करें।

प्रश्न 3: क्या Jira-MCP का उपयोग करने के लिए कोई लागत है?

उत्तर 3: Jira-MCP ओपन-सोर्स है और सार्वजनिक उपयोग के लिए उपलब्ध है। हालांकि, उपयोगकर्ताओं को अनुपालन सुनिश्चित करने के लिए लाइसेंसिंग शर्तों की समीक्षा करनी चाहिए।

प्रश्न 4: मैं Jira-MCP परियोजना में कैसे योगदान कर सकता हूँ?

उत्तर 4: योगदान का स्वागत है! आप परियोजना के GitHub रिपॉजिटरी पर मुद्दे, फीचर अनुरोध, या पुल अनुरोध सबमिट करके योगदान कर सकते हैं।

प्रश्न 5: मैं Jira-MCP के लिए सहायता कहाँ प्राप्त कर सकता हूँ?

उत्तर 5: सहायता परियोजना के GitHub रिपॉजिटरी के माध्यम से प्राप्त की जा सकती है, जहाँ उपयोगकर्ता मुद्दे रिपोर्ट कर सकते हैं या समुदाय से सहायता मांग सकते हैं।

Jira MCP

A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations.

WHY

While Atlassian provides an official MCP connector, our implementation offers superior flexibility and real-world problem-solving capabilities. We've built this connector to address the daily challenges developers and project managers actually face, not just basic API operations.

Key Advantages:

• More Comprehensive Tools: We provide 20+ specialized tools covering every aspect of Jira workflow management
• Real-World Focus: Built to solve actual daily problems like sprint management, issue relationships, and workflow transitions
• Enhanced Flexibility: Support for complex operations like moving issues between sprints, creating child issues, and managing issue relationships
• Better Integration: Seamless integration with AI assistants for natural language Jira operations
• Practical Design: Tools designed for actual development workflows, not just basic CRUD operations

Features

Issue Management

• Get detailed issue information with customizable fields and expansions
• Create new issues with full field support
• Create child issues (subtasks) with automatic parent linking
• Update existing issues with partial field updates
• Search issues using powerful JQL (Jira Query Language)
• List available issue types for any project
• Transition issues through workflow states
• Move issues to sprints (up to 50 issues at once)

Comments & Time Tracking

• Add comments to issues
• Retrieve all comments from issues
• Add worklogs with time tracking and custom start times
• Flexible time format support (3h, 30m, 1h 30m, etc.)

Issue Relationships & History

• Link issues with relationship types (blocks, duplicates, relates to)
• Get related issues and their relationships
• Retrieve complete issue history and change logs
• Track issue transitions and workflow changes

Sprint & Project Management

• List all sprints for boards or projects
• Get active sprint information
• Get detailed sprint information by ID
• List project statuses and available transitions
• Board and project integration with automatic discovery

Advanced Features

• Bulk operations support (move multiple issues to sprint)
• Flexible parameter handling (board_id or project_key)
• Rich formatting of responses for AI consumption
• Error handling with detailed debugging information

🚀 Quick Start Guide

Prerequisites

Before you begin, you'll need:

1. Atlassian Account with access to a Jira instance
2. API Token from Atlassian (we'll help you get this)
3. Cursor IDE with Claude integration

Step 1: Get Your Atlassian API Token

1. Go to Atlassian API Tokens
2. Click "Create API token"
3. Give it a name like "Jira MCP Connector"
4. Copy the token (you won't see it again!)

Step 2: Choose Your Installation Method

We recommend Docker for the easiest setup:

🐳 Option A: Docker (Recommended)

### Pull the latest image
docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest

### Test it works (replace with your details)
docker run --rm \
  -e ATLASSIAN_HOST=https://your-company.atlassian.net \
  -e ATLASSIAN_EMAIL=your-email@company.com \
  -e ATLASSIAN_TOKEN=your-api-token \
  ghcr.io/nguyenvanduocit/jira-mcp:latest \
  --http_port 3000

📦 Option B: Download Binary

1. Go to GitHub Releases
2. Download for your platform:
   • macOS: jira-mcp_darwin_amd64
   • Linux: jira-mcp_linux_amd64
   • Windows: jira-mcp_windows_amd64.exe
3. Make it executable (macOS/Linux):

   chmod +x jira-mcp_*
   sudo mv jira-mcp_* /usr/local/bin/jira-mcp
   

🛠️ Option C: Build from Source

go install github.com/nguyenvanduocit/jira-mcp@latest

Step 3: Configure Cursor

1. Open Cursor
2. Go to Settings → Features → Model Context Protocol
3. Add a new MCP server with this configuration:

For Docker Users:

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ATLASSIAN_HOST=https://your-company.atlassian.net",
        "-e", "ATLASSIAN_EMAIL=your-email@company.com", 
        "-e", "ATLASSIAN_TOKEN=your-api-token",
        "ghcr.io/nguyenvanduocit/jira-mcp:latest"
      ]
    }
  }
}

For Binary Users:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira-mcp",
      "env": {
        "ATLASSIAN_HOST": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_TOKEN": "your-api-token"
      }
    }
  }
}

Step 4: Test Your Setup

1. Restart Cursor completely
2. Open a new chat with Claude
3. Try these test commands:

List my Jira projects

Show me issues assigned to me

What's in the current sprint?

If you see Jira data, congratulations! 🎉 You're all set up.

🔧 Advanced Configuration

Using Environment Files

Create a .env file for easier management:

### .env file
ATLASSIAN_HOST=https://your-company.atlassian.net
ATLASSIAN_EMAIL=your-email@company.com
ATLASSIAN_TOKEN=your-api-token

Then use it:

### With binary
jira-mcp -env .env

### With Docker
docker run --rm -i --env-file .env ghcr.io/nguyenvanduocit/jira-mcp:latest

HTTP Mode for Development

For development and testing, you can run in HTTP mode:

### Start HTTP server on port 3000
jira-mcp -env .env -http_port 3000

Then configure Cursor with:

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

🎯 Usage Examples

Once configured, you can ask Claude to help with Jira tasks using natural language:

Issue Management

• "Create a new bug ticket for the login issue"
• "Show me details for ticket PROJ-123"
• "Move ticket PROJ-456 to In Progress"
• "Add a comment to PROJ-789 saying the fix is ready"

Sprint Management

• "What's in our current sprint?"
• "Move these 3 tickets to the next sprint: PROJ-1, PROJ-2, PROJ-3"
• "Show me all tickets assigned to John in the current sprint"

Reporting & Analysis

• "Show me all bugs created this week"
• "List all tickets that are blocked"
• "What tickets are ready for testing?"

🛠️ Troubleshooting

Common Issues

❌ "Connection failed" or "Authentication error"

• Double-check your ATLASSIAN_HOST (should be like company.atlassian.net)
• Verify your API token is correct
• Make sure your email matches your Atlassian account

❌ "No MCP servers found"

• Restart Cursor completely after adding the configuration
• Check the MCP configuration syntax in Cursor settings
• Verify the binary path is correct (for binary installations)

❌ "Permission denied" errors

• Make sure your Atlassian account has access to the Jira projects
• Check if your API token has the necessary permissions

Getting Help

1. Check the logs: Run with -http_port to see detailed error messages
2. Test your credentials: Try the Docker test command from Step 2
3. Verify Cursor config: The app will show you the exact configuration to use

📚 Development

For local development and contributing:

### Clone the repository
git clone https://github.com/nguyenvanduocit/jira-mcp.git
cd jira-mcp

### Create .env file with your credentials
cp .env.example .env
### Edit .env with your details

### Run in development mode
just dev
### or
go run main.go -env .env -http_port 3002

### Test with MCP inspector
npx @modelcontextprotocol/inspector http://localhost:3002/mcp

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Need help? Check our CHANGELOG.md for recent updates or open an issue on GitHub.