jira-mcp

Ein Model Context Protocol-Server für Jira Cloud. Erstellt Issues und Subtasks, liest Issues, sucht mit JQL, durchläuft agile Boards und ihre Swimlanes, gewegt Issues durch ihren Workflow, kommetiert und hängt Dateien an.

Die Authentifizierung erfolt mit eig der E-Mail-Adresse eines Athenan-Kontos und einem API-Token, so läuft er headls — kein OAuth, kein Brøser-Roundtrip, keine interaktive Zustimmung.

Installation

Nichts zu installieren. Richten Sie Ihren MCP-Client auf das Pakto aus and lassen Sie npx es abrufen:

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:skurekjakub/jira-mcp#v1.0.0"],
      "env": {
        "NPM_CONFIG_ALLOW_GIT": "root",
        "JIRA_SITE": "your-team.atlassian.net",
        "JIRA_CLOUD_ID": "00000000-0000-0000-0000-000000000000",
        "JIRA_PROJECT_KEY": "ABC",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}

Da das Build-Artefakt eingecheckt haben und die Laufzeitabhängigkeiten darin eingebetthat sind, besteht die Installation nur aus Klonen und Verlinken — kein Build-Schritt, keine abgerufenen Pakete und kein zu genehmigendes Installiaionsskript.

NPM_CONFIG_ALLOW_GIT

[npm 12 default-allow-git on the "can't"](https://github.com/npm/cli/commit/caa329568d32587e53f6e098f43b550dd2685034), this therefore npm the Installation mit EALLOWGIT— *„Fetching packages of type git have been disabled"*. Wird die Setting in derenv-Block des Servers gesetzt, gilt die Ausnahme nur für diesen single-Unterprozess; damit bleibt dasGit-Fetch der datei für alle anderigen Installationen auf dem Rrehner deaktiviert. rooterlaubt für das ib installierende Paket, aber nicht für irgendetwas, wovon this might depend;all` blunt the restriction entirely und ist hier not eventätig. Auf npm 11 und älter wird the variableariable ignoriert.

Einmaliges Installieren

npx löst den Git-Ref bei jedem Start neu auf, was einige Sekunden und einen Netzwerkk-Reundtrip kostet. Um beides zu vermeiden:

npm install -g --allow-git=root github:skurekjakub/jira-mcp

Verwenden Sie dann "command": "jira-mcp"ohneargsund ohneNPM_CONFIGALLOW_GIT`. Ein Upgrade erfolgt dann manuell per erneutes Ausführen dieses Befehls.

Related MCP server: Jira MCP Server

Konfiguration

Jede Einstellung stammt aus der Umgebung. Es gibt keine Konfigurationsdatei, und the server reads keine .env — ein MCP-Client übergibt die Werte im env- Block nicht.

Ermitteln Sie Ihre Cloud-ID mit:

curl -s https://your-team.atlassian.net/_edge/tenant_info

Das Token aus der Versionskontrolle heraushalten

Eine eingecheckte MCP-Konfiguration darf das Token nicht selbst enthalten. Claude Code expandiert ${VAR}-Referenzen in command, args, env, url und headers, sodass die Konfiguration nur eine Variable benennt und the Wert woanders liegt — in einem Shell-Profil oder in einer nicht eingecheckten Einstellungsdatei.

Eine Referenz, die nichts expandiert, ist kein Fehler: Claude Code reicht den wörtlichen Text ${JIRA_API_TOKEN} an den Server durch. Dieser Server verwirft einen Wert dieser Form beim Start und benennt die Variable, statt ihn an Jira zu senden und eine fragments anzunehmen.

Tools

jira_create_issue

Erstellt ein Issue in JIRA_PROJECT_KEY.

jira_create_subtask

Erstellt einen Subtask unter einem vorhandenen Issue.

jira_get_issue

Ruft die Zusammenfassung, Beschreibung, Typ, Status, das übergeordnete Issue, die Subtasks, Issue-Verknüpfungen und Fix-Versionen eines Issues ab.

                                                                                          |

jira_search_issues

Durchsucht JQL, paginiert.

jira_get_board

Meldet das Layout eines agilen Boards – Spalten, Quick-Filter und Swimlanes, jeweilt mit JQL. Führen Sie es vor jira_board_issues aus, um die Namen zu erfahren, die dieses Werkzeug akzeptiert. Die Board-ID ist das boards/<id>- Segment einer Board-URL.

Die Swimlane stammen aus der internen API von GreenHopper; Atlassian veröffentlicht keinen unterstützten Endpunkt dafür.

jira_board_issues

Liste die aktuell auf einem Board liegenden Issues, gruppiert nach Swimlane. Reproduziert die Board-Ansicht: den eigenen Filter des Boards, seinen Kanban- Unterhalt, ggf. benannte Filter und zusätzliche JQL.

Jedes Issue bounded in genau eine Swimlane – die erste, in der Board-Reihenfolge, deren Abfrage auf es passt. Wenn eine Teilmenge Spur aus angefordet, werden die darunter liegenden Bahnen trotzdem ausgewertet, ihr Anspruch auf ein Issue besteht.

jira_list_transitions

Listet die Workflow-Übergänge, die derzeit für ein Issue verfügbar sind. Übergangsnamen und -IDs sind workflow-spezifisch – rufen Sie es vor jira_transition_issue auf.

jira_transition_issue

Bewegt ein Issue durch seinen Workflow. Vergleicht transitionName ohne Groß-/Kleinschreibung mit den verfügbaren (zulässigen) Übergängen des Issues; gibt es keine Übereinstimmung, schlägt er fehl und listet die zulässigen auf.

jira_add_comment

Fügt einen Kommentar hinzu. Der Text verwendet Jira-Wiki-Markup (h3. für Überschriften, {{code}} für Inline-Code, {code:…}…{code} für Blöcke, bq. für Zitate). Verwenden Sie echte Zeilenumbrüche, keine literalen \n-Escapes.

jira_add_attachment

Hängt eine Datei an. Die Datei muss sich in JIRA_ATTACHMENTS_DIR befinden; ein Name, der dieses Verzeichnis verlässt, wird abgelehnt.

Transport

stdio standardmäßig. --transport http --port <n> stellt die gleichen Werkzeuge über einen zustandslosen Streamable-HTTP-Transport unter /mcp bereit, zugleich unter /health einen Health-Check.

Entwicklung

npm install
npm test          # vitest
npm run lint      # tsc --noEmit
npm run build     # webpack -> dist/bundle.js

dist/bundle.js ist eingecheckt, sodass die Installation keinen build-Schritt benötigt. CI baut es bei jedem Push auf main neu und übernimmt das Ergebnis, sodass nicht von src/ abweichenkann.

Lizenz

MIT