Jira MCP Server (kostenlos-tauglich)

Ein kleiner MCP-Server, der es einem MCP-Client (Claude Desktop oder einem beliebigen MCP-Client) ermöglicht, Jira-Issues zu lesen, zu erstellen, zu aktualisieren, zu kommentieren und zu überführen. Entwickelt und getestet gegen den kostenlosen Plan von Jira Cloud – kein kostenpflichtiges Jira-Abonnement erforderlich.

Verfügbare Tools

1. Kostenlose Jira-Cloud-Site erhalten

1. Gehe zu https://www.atlassian.com/software/jira und registriere dich (kostenlos, bis zu 10 Benutzer, unbegrenzte Projekte).

2. Erstelle ein Projekt und notiere seinen Projektschlüssel (z. B. PROJ) – er wird neben dem Projektnamen angezeigt.

3. Erstelle ein API-Token unter https://id.atlassian.com/manage-profile/security/api-tokens.

2. Abhängigkeiten installieren

cd jira-mcp-server
python3 -m venv venv
source venv/bin/activate        # on Windows: venv\Scripts\activate
pip install -r requirements.txt

3. Anmeldedaten konfigurieren

Kopiere .env.example nach .env und fülle deine Werte ein, oder exportiere sie einfach in deiner Shell:

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token-here

4. Direkt testen (kein Claude Desktop erforderlich)

Bearbeite PROJECT_KEY / ISSUE_KEY am Anfang von test_client.py, damit sie zu deinem Jira-Projekt passen, und dann:

python test_client.py

Dies startet jira_server.py als Unterprozess über stdio (genau wie es ein echter MCP-Client tun würde), listet die verfügbaren Tools auf und testet get_issue, search_issues und create_issue gegen deine Live-Jira-Site.

5. In Claude Desktop einbinden (optional)

Füge dies zu deiner Claude-Desktop-MCP-Konfiguration hinzu (claude_desktop_config.json – Einstellungen → Entwickler → Konfiguration bearbeiten):

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/jira-mcp-server/venv/bin/python",
      "args": ["/absolute/path/to/jira-mcp-server/jira_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Starte Claude Desktop neu und frage etwas wie „Wie ist der Status von PROJ-1?“ – es sollte das get_issue-Tool aufrufen.

Hinweise / Stolperfallen

• Die v3-API von Jira speichert Beschreibungen und Kommentare im Atlassian Document Format (ADF), nicht als Klartext. Der Server übernimmt die Konvertierung für dich in beide Richtungen.

• Der issue_type von create_issue muss exakt einem Typ entsprechen, der in diesem Projekt konfiguriert ist (üblicherweise Task, Bug, Story, Epic) – überprüfe die Issue-Typen deines Projekts, wenn du einen „issuetype“-Fehler erhältst.

• Der kostenlose Plan begrenzt dich auf 100 Automatisierungsläufe/Monat und 2 GB Speicher – für diese Art von manuellen/API-Tests irrelevant, aber gut zu wissen.

• Dieser Server verwendet stdio-Transport, was bedeutet, dass er nur lokal läuft, gestartet von dem MCP-Client, der mit ihm spricht – er ist kein öffentlicher Webdienst, was der einfachste und häufigste Weg ist, MCP zu testen.