Jira MCP Server

Jira MCP Server

Sprechen Sie mit Jira in natürlicher Sprache, um Informationen zu Ihrem Projekt zu erhalten und Änderungen vorzunehmen. Nutzen Sie Jira mit Claude Desktop in Kombination mit einer benutzerdefinierten README-Datei, die Sie mit Projektinformationen erstellen, um PM-Aufgaben zu delegieren (z. B. wenn Sie eine Liste Ihres Teams und seiner Fachgebiete haben, weisen Sie jedes neue Problem der zuständigen Person zu).

Erstellt mit dem Model Context Protocol .

Der Server ermöglicht:

• Projekterstellung und -konfiguration
• Problem- und Unteraufgabenverwaltung
• Problemverknüpfung und Abhängigkeiten
• Automatisierte Problem-Workflows

Konfiguration

Erforderliche Umgebungsvariablen:

• JIRA_HOST : Hostname Ihrer Jira-Instanz
• JIRA_EMAIL : Die E-Mail-Adresse Ihres Jira-Kontos
• JIRA_API_TOKEN : API-Token von https://id.atlassian.com/manage-profile/security/api-tokens

Verfügbare Tools

1. Benutzerverwaltung

2. Problemtypverwaltung

3. Linktypen ausgeben

4. Problemmanagement

Probleme abrufen

Probleme erstellen

Aktualisierungsprobleme

Problemabhängigkeiten

Probleme löschen

Feldformatierung

Beschreibungsfeld

Das Beschreibungsfeld unterstützt die Formatierung im Markdown-Stil:

• Verwenden Sie Leerzeilen zwischen Absätzen
• Verwenden Sie „-“ für Aufzählungspunkte
• Verwenden Sie "1. " für nummerierte Listen
• Verwenden Sie Header, die mit ":" enden (gefolgt von einer Leerzeile).

Beispiel:

Fehlerbehandlung

Der Server liefert detaillierte Fehlermeldungen für:

• Ungültige Issue-Schlüssel
• Fehlende Pflichtfelder
• Berechtigungsprobleme
• API-Ratenbegrenzungen

Installationsanweisungen

1. Klonen Sie das Repository:
   git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-Server
2. Installieren Sie Abhängigkeiten:
   npm install
3. Umgebungsvariablen konfigurieren: Erstellen Sie eine .env Datei im Stammverzeichnis:
   JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token
4. Erstellen Sie das Projekt:
   npm run build
5. Starten Sie den Server:
   npm start

Konfigurieren von Claude Desktop

So verwenden Sie diesen MCP-Server mit Claude Desktop:

1. Suchen Sie Ihre Claude Desktop-Konfigurationsdatei:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Fügen Sie den Jira MCP-Server zu Ihrer Konfiguration hinzu:
   { "mcpServers": { "jira-server": { "name": "jira-server", "command": "/path/to/node", "args": ["/path/to/jira-server/build/index.js"], "cwd": "/path/to/jira-server", "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }
   Ersetzen Sie /path/to/jira-server durch den absoluten Pfad zu Ihrem geklonten Repository. Ersetzen Sie /path/to/node durch den absoluten Pfad zu Ihrer Node.js-Datei (diesen finden Sie normalerweise, indem Sie which node oder „ where node in Ihrem Terminal ausführen). Aus Gründen der Zuverlässigkeit wird empfohlen, den direkten Pfad zur Node.js-Datei und der erstellten JavaScript-Datei ( build/index.js nach Ausführung npm run build “) zu verwenden.
3. Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.

Cursor konfigurieren

So verwenden Sie diesen Jira MCP-Server mit Cursor:

1. Stellen Sie sicher, dass der Server erstellt ist: Führen Sie npm run build im Verzeichnis Jira-MCP-Server aus, um die erforderliche Datei build/index.js zu erstellen.
2. Suchen oder erstellen Sie die MCP-Konfigurationsdatei von Cursor:
   • Für projektspezifische Konfiguration: .cursor/mcp.json im Stammverzeichnis Ihres Projekts.
   • Für die globale Konfiguration (alle Projekte): ~/.cursor/mcp.json in Ihrem Home-Verzeichnis.
3. Fügen Sie die Jira MCP-Serverkonfiguration zu mcp.json hinzu:
   { "mcpServers": { "jira-mcp-server": { "command": "node", // Or provide the absolute path to your Node.js executable "args": [ "/path/to/your/Jira-MCP-Server/build/index.js" // Absolute path to the server's built index.js ], "cwd": "/path/to/your/Jira-MCP-Server", // Absolute path to the Jira-MCP-Server directory "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", // Your Jira email "JIRA_API_TOKEN": "your-api-token" // Your Jira API token } } // You can add other MCP server configurations here } }
   • Ersetzen Sie /path/to/your/Jira-MCP-Server durch den richtigen absoluten Pfad zu dem Ort, an dem Sie das Jira-MCP-Server Repository geklont haben.
   • Wenn sich node nicht im PATH Ihres Systems befindet oder Sie einen absoluten Pfad bevorzugen, ersetzen Sie "node" durch den vollständigen Pfad zu Ihrer ausführbaren Node.js-Datei (z. B. /usr/local/bin/node oder C:\Program Files\nodejs\node.exe ).
   • Stellen Sie sicher, dass die Details Ihrer Jira-Instanz und Ihr API-Token im Abschnitt env korrekt ausgefüllt sind.
4. Starten Sie Cursor neu, um die Änderungen zu übernehmen.

Verwenden von Cursorregeln für Jira Context

Um die Interaktion mit Jira reibungsloser zu gestalten, können Sie Ihr Standard-Jira-Projekt und Ihre Benutzerkennung in den Cursor-Regeln definieren. Dadurch versteht die Cursor-KI Ihren Kontext, ohne dass Sie ihn in jeder Eingabeaufforderung erneut angeben müssen.

Erstellen oder bearbeiten Sie Ihre Cursor-Regeldatei (z. B. in Ihrem Projekt .cursor/rules.json oder global ~/.cursor/rules.json (die genaue Datei und Methode für Regeln kann variieren, siehe Cursor-Dokumentation für „Regeln“ oder „Kontextverwaltung“)). Fügen Sie Einträge wie diese hinzu:

Ersetzen Sie YOUR_PROJECT_KEY_HERE und your_jira_email@example.com durch Ihre tatsächlichen Angaben.

Beispielverwendung im Cursor-Chat

Nach der Konfiguration (insbesondere mit Cursorregeln für den Kontext) können Sie Cursor fragen:

"Using Jira MCP, list my assigned tasks. Then, based on these tasks, come up with an implementation plan and work schedule."

Wenn Sie keine Regeln eingerichtet haben oder ein anderes Projekt oder einen anderen Benutzer angeben müssen, können Sie dies deutlicher machen:

"Using Jira MCP, list tasks assigned to 'user@example.com' in project 'PROJECT_KEY'. Then, based on these tasks, come up with an implementation plan and work schedule."

Die KI von Cursor verwendet den Jira MCP-Server, um die Aufgaben abzurufen und fährt dann mit der Planungs- und Terminierungsanforderung fort.

Installation über Smithery

So installieren Sie Jira MCP Server für Claude Desktop automatisch über Smithery :

Manuelle Installation

1. Klonen Sie das Repository:
   git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-Server
2. Installieren Sie Abhängigkeiten:
   npm install
3. Umgebungsvariablen konfigurieren: Erstellen Sie eine .env Datei im Stammverzeichnis:
   JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token
4. Erstellen Sie das Projekt:
   npm run build
5. Starten Sie den Server:
   npm start

Verweise

• Modellkontextprotokoll
• Jira REST API-Dokumentation
• Beispiele für die Jira-REST-API