Jira Mcp

Was ist Jira-MCP?

Jira-MCP (Model Control Protocol) ist ein in Go basierter Connector, der für eine nahtlose Interaktion zwischen KI-Assistenten, wie Claude, und Atlassian Jira entwickelt wurde. Dieses Tool ermöglicht es KI-Modellen, verschiedene Jira-Operationen durchzuführen, einschließlich der Verwaltung von Aufgaben, der Sprintplanung und der Workflow-Übergänge, wodurch die Produktivität effektiv gesteigert und die Projektmanagementprozesse optimiert werden.

Funktionen von Jira-MCP

• KI-Integration: Jira-MCP ermöglicht es KI-Assistenten, mit Jira zu interagieren, was eine automatisierte Aufgabenverwaltung und verbesserte Effizienz ermöglicht.
• Aufgabenverwaltung: Benutzer können Aufgaben direkt über die KI-Oberfläche erstellen, aktualisieren und verwalten, was den Workflow vereinfacht.
• Sprintplanung: Das Tool unterstützt bei der Planung von Sprints, indem es KI-gesteuerte Einblicke und Empfehlungen basierend auf Projektdaten bereitstellt.
• Workflow-Übergänge: Jira-MCP erleichtert reibungslose Übergänge zwischen verschiedenen Workflow-Zuständen und stellt sicher, dass Aufgaben ohne manuelle Eingriffe vorankommen.
• Benutzerfreundliche Oberfläche: Der Connector bietet eine einfache und intuitive Benutzeroberfläche für Entwickler und Projektmanager, was die Integration in bestehende Systeme erleichtert.

So verwenden Sie Jira-MCP

1. Installation: Beginnen Sie mit der Installation des Jira-MCP-Connectors in Ihrer Go-Umgebung. Befolgen Sie die Installationsanweisungen im Repository.
2. Konfiguration: Konfigurieren Sie den Connector, um eine Verbindung zu Ihrer Jira-Instanz herzustellen. Dies umfasst in der Regel die Einrichtung von API-Schlüsseln und Berechtigungen.
3. Integration mit KI-Assistenten: Verbinden Sie Jira-MCP mit Ihrem bevorzugten KI-Assistenten. Stellen Sie sicher, dass der Assistent die erforderlichen Berechtigungen hat, um mit Jira zu interagieren.
4. Durchführung von Operationen: Nutzen Sie den KI-Assistenten, um verschiedene Jira-Operationen durchzuführen. Sie können den Assistenten bitten, Aufgaben zu erstellen, zu aktualisieren oder Projektinformationen abzurufen.
5. Überwachen und Optimieren: Überwachen Sie kontinuierlich die Leistung des Connectors und optimieren Sie die Konfigurationen nach Bedarf, um die Effizienz zu steigern.

Häufig gestellte Fragen

F1: In welcher Programmiersprache ist Jira-MCP geschrieben?

A1: Jira-MCP ist in der Programmiersprache Go geschrieben, die für ihre Leistung und Effizienz bekannt ist.

F2: Kann ich Jira-MCP mit jeder Version von Jira verwenden?

A2: Jira-MCP ist für die Verwendung mit Atlassian Jira konzipiert, aber die Kompatibilität kann je nach Version variieren. Überprüfen Sie immer die Dokumentation auf spezifische Versionsanforderungen.

F3: Gibt es Kosten für die Verwendung von Jira-MCP?

A3: Jira-MCP ist Open Source und für die öffentliche Nutzung verfügbar. Benutzer sollten jedoch die Lizenzbedingungen überprüfen, um die Einhaltung sicherzustellen.

F4: Wie kann ich zum Jira-MCP-Projekt beitragen?

A4: Beiträge sind willkommen! Sie können beitragen, indem Sie Probleme, Funktionsanfragen oder Pull-Requests im GitHub-Repository des Projekts einreichen.

F5: Wo finde ich Unterstützung für Jira-MCP?

A5: Unterstützung finden Sie im GitHub-Repository des Projekts, wo Benutzer Probleme melden oder Hilfe von der Community suchen können.

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.