jira-context-mcp

jira-context-mcp ist ein produktionsorientierter MCP-Server, der strukturierten Jira-Vorgangskontext von einer Jira-URL abruft. Er wurde für Coding-Agenten wie Codex und Claude Code entwickelt, damit diese schnell die Absicht und den Implementierungskontext eines Vorgangs verstehen können.

Was dieser Server tut

• Stellt ein MCP-Tool bereit: get_jira_issue_from_url

• Überprüft, ob die eingegebene URL zu Ihrer JIRA_BASE_URL gehört

• Extrahiert einen Jira-Vorgangsschlüssel aus verschiedenen Jira-URL-Formaten

• Ruft die Jira Cloud REST API auf:

  • GET /rest/api/3/issue/{issueIdOrKey}?expand=names,renderedFields

• Konvertiert Jira-Rich-Text (Atlassian Document Format) in Klartext

• Gibt prägnanten, für Agenten lesbaren, strukturierten Vorgangskontext zurück

Related MCP server: JIRA MCP Server

Unterstützte Jira-Vorgangstypen

Dieser Server ist vorgangstypunabhängig. Er funktioniert für jeden Jira-Vorgangstyp, einschließlich:

• Bug

• Feature-Request

• Task

• Story

• Epic

• Anforderung

• Verbesserung

• Support-Ticket

• Benutzerdefinierte Vorgangstypen

Erforderliche Umgebungsvariablen

• JIRA_EMAIL: E-Mail-Adresse des Jira-Kontos

• JIRA_API_TOKEN: Jira-API-Token

• JIRA_BASE_URL: Jira Cloud Tenant-URL (Beispiel: https://your-domain.atlassian.net)

Schnellstart-Befehle

Codex (keine globale Installation)

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Claude Code (keine globale Installation)

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Optional: Zuerst global installieren

npm install -g github:TastyHeadphones/jira-context-mcp

Dann mit lokalem Binary hinzufügen:

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

Tool

get_jira_issue_from_url

Eingabe:

{
  "url": "string"
}

Unterstützte URL-Beispiele:

• ${JIRA_BASE_URL}/browse/ABC-123

• ${JIRA_BASE_URL}/jira/software/projects/ABC/boards/1/backlog?selectedIssue=ABC-123

• Jede Jira-URL unter JIRA_BASE_URL, die einen Vorgangsschlüssel wie ABC-123 enthält

Die zurückgegebenen strukturierten Daten enthalten:

• issueKey, issueUrl, summary

• description (soweit möglich als Klartext)

• issueType, status, statusCategory, priority

• assignee, reporter

• labels, components

• fixVersions, affectedVersions

• created, updated, dueDate

• parent, epic

• subtasks, linkedIssues

• attachments (nur Metadaten)

• comments (die 10 neuesten)

• acceptanceCriteria (Best-Effort-Extraktion aus Beschreibung/benutzerdefinierten Feldern)

• customFields (nicht leer, normalisiert, menschenlesbar)

Erstellen eines Jira-API-Tokens

1. Öffnen Sie die Atlassian API-Token-Einstellungen.

2. Klicken Sie auf API-Token erstellen.

3. Benennen Sie das Token und kopieren Sie es.

4. Verwenden Sie diesen Wert für JIRA_API_TOKEN.

Lokal ausführen

1. Abhängigkeiten installieren:

npm install

2. Umgebungsvariablen setzen (zum Beispiel über .env in Ihrer Shell/Sitzung).

3. Build:

npm run build

4. Starten:

npm start

Entwicklungsmodus:

npm run dev

MCP-Konfigurationsbeispiele

Verwenden Sie diesen Servereintrag in Ihrer MCP-Client-Konfiguration:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-context-mcp/dist/index.js"],
      "env": {
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-token",
        "JIRA_BASE_URL": "https://your-domain.atlassian.net"
      }
    }
  }
}

Claude Code MCP-Konfigurationsbeispiel

Verwenden Sie denselben JSON-Block wie oben in Ihrer Claude Code MCP-Server-Konfigurationsdatei.

Codex MCP-Konfigurationsbeispiel

Verwenden Sie denselben JSON-Block wie oben in Ihrer Codex MCP-Server-Konfigurationsdatei.

Beispiel-Tool-Aufruf

{
  "name": "get_jira_issue_from_url",
  "arguments": {
    "url": "https://your-domain.atlassian.net/browse/ABC-123"
  }
}

Beispiel-Ausgabe

{
  "issueKey": "ABC-123",
  "issueUrl": "https://your-domain.atlassian.net/browse/ABC-123",
  "summary": "Prevent duplicate webhook retries",
  "description": "As a platform engineer, I need retry deduplication ...",
  "acceptanceCriteria": "- Duplicate deliveries are ignored\n- Metrics include dropped duplicates",
  "issueType": "Story",
  "status": "In Progress",
  "statusCategory": "In Progress",
  "priority": "High",
  "assignee": {
    "accountId": "5b10ac8d82e05b22cc7d4ef5",
    "displayName": "Alex Example",
    "emailAddress": null,
    "active": true
  },
  "labels": ["webhook", "idempotency"],
  "components": ["API"],
  "fixVersions": ["2026.05"],
  "affectedVersions": ["2026.04"],
  "subtasks": [],
  "linkedIssues": [],
  "attachments": [],
  "comments": [],
  "customFields": []
}

Sicherheitshinweise

• Halten Sie `JIRA_API_TOKEN