MCP Atlassian — Installieren & Live-Demo

Name: MCP Atlassian MCP Server
Author: sooperset

Warum nutzen

Hauptfunktionen

Jira: JQL-Suche, Issue abrufen/erstellen/aktualisieren, Übergang, Kommentar hinzufügen, Workflow auflisten
Confluence: Seiten suchen, Inhalt abrufen, Seite erstellen/aktualisieren, Kommentare, Anhänge
Cloud + Server/Data Center Support
Read-only-Modus für Least-Privilege-Deployments
Site-Filter — auf ein einzelnes Projekt/Space einschränkbar
Stdio + HTTP/SSE-Transport

Live-Demo

In der Praxis

mcp-atlassian-sooperset.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-atlassian-sooperset",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-atlassian-sooperset": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-atlassian"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mcp-atlassian-sooperset -- uvx mcp-atlassian

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: MCP Atlassian

Einen Produktionsfehler in ein Jira-Ticket mit verknüpftem Confluence-Runbook überführen

👤 On-Call-Engineers ⏱ ~10 min intermediate

Wann einsetzen: Sentry-Alert ausgelöst — ein triagiertes Jira-Ticket und ein Runbook-Link werden schnell benötigt.

Voraussetzungen

API-Tokens — Atlassian → My Account → Security → API tokens

Ablauf

Verwandte suchen

Atlassian: Jira nach Issues durchsuchen, die in den letzten 30 Tagen "NullPointerException OrderService" enthalten. Außerdem Confluence nach Runbook-Seiten zu OrderService durchsuchen.✓ Kopiert

→ Beide Ergebnismengen zurückgegeben
Entscheiden: Duplikat oder neu

Falls ein offenes BUG-Issue in den letzten 14 Tagen existiert, dieses mit dem neuen Stack-Trace kommentieren. Andernfalls ein neues BUG erstellen, die Runbook-Seite verknüpfen, Priorität High setzen.✓ Kopiert

→ Entweder jira_add_comment oder jira_create_issue einmal aufgerufen
Übergabe

Ticket-Key und kurze Zusammenfassung mitteilen, zum Posten in Slack.✓ Kopiert

→ ABC-1234 + 1-zeilige Zusammenfassung

Ergebnis: Triagiertes Ticket mit Runbook-Link in unter 2 Minuten; keine Doppelerfassung von Duplikaten.

Fallstricke

Stack-Trace als Plaintext in Jira eingefügt verliert Formatierung — In {code}-Marker einschließen; das MCP leitet unverändert weiter
JQL-Injection über Benutzereingabe — String-Parameter immer quoten; das Tool escaped, aber explizit sein

Kombinieren mit: sentry · github

Einen wöchentlichen Statusbericht aus Jira generieren

👤 Tech Leads / EMs ⏱ ~10 min beginner

Wann einsetzen: Montagmorgen: zusammenfassen, was ausgeliefert wurde und was blockiert ist.

Ablauf

Letzte Woche Erledigt ziehen

Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ Kopiert

→ Issue-Liste mit Bearbeiter, Key, Zusammenfassung
Blockiert ziehen

Jetzt JQL project = PLAT AND status = Blocked — für jedes den letzten Kommentar zusammenfassen.✓ Kopiert

→ Blockiert-Liste mit Letzter-Kommentar-Zusammenfassung pro Issue
Zusammenstellen

Als 200-Wort-Wochenbericht formatieren, gruppiert nach Ausgeliefert / Blockiert / Risiko.✓ Kopiert

→ Knapper Bericht bereit zum Einfügen

Ergebnis: Statusbericht in 90 Sekunden zusammengestellt mit zitierten Issue-Keys.

Fallstricke

Lange Kommentar-Threads blähen den Kontext auf — jira_get_issue mit fields=summary,status,assignee verwenden

Einen Confluence-RFC aus einer Diskussion entwerfen

👤 Engineers, die Design-Dokumente schreiben ⏱ ~20 min intermediate

Wann einsetzen: Ein Ansatz wurde im Chat diskutiert; eine Confluence-Seite soll daraus entstehen.

Ablauf

Den Parent-Space finden

Atlassian: den Space "Engineering RFC" finden. Seine Top-Level-Seiten auflisten.✓ Kopiert

→ Space + Parent-Seite identifiziert
Zusammenstellen

Eine neue Seite darunter mit dem Titel "RFC: Wechsel von Redis zu Valkey" erstellen. Abschnitte: Kontext, Ziele/Nicht-Ziele, geprüfte Optionen, Entscheidung, Plan. Obige Diskussion als Rohmaterial verwenden.✓ Kopiert

→ confluence_create_page gibt eine URL zurück

Ergebnis: Entworfener RFC bereit zur Review.

Fallstricke

Falsche Parent-Seiten-ID — Immer zuerst confluence_search nach Space

Veraltete Tickets in Masse bereinigen

👤 Engineering Manager ⏱ ~30 min intermediate

Wann einsetzen: Das Backlog hat 200 Zombie-Tickets; sie sollen sortiert werden.

Ablauf

Veraltete identifizieren

JQL: project = PLAT AND status = Open AND updated < -90d. Limit 50.✓ Kopiert

→ Liste veralteter Issues
Aktion vorschlagen

Für jedes vorschlagen: close-stale, reassign-to-triage oder keep. 10 auf einmal zeigen bevor Übergänge durchgeführt werden.✓ Kopiert

→ Pro-Issue-Empfehlung; Genehmigung in Batches
Anwenden

Die genehmigten mit einem Kommentar "closing as stale" schließen.✓ Kopiert

→ jira_transition_issue + jira_add_comment pro Issue aufgerufen

Ergebnis: Backlog bereinigt mit Audit-Trail pro Issue.

Fallstricke

Legitime-aber-ruhige Tickets automatisch schließen — Immer batchen + bestätigen vor dem Übergang

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcp-atlassian-sooperset + sentry

Sentry-Fehler in gut strukturierte Jira-Tickets umwandeln

Sentry: aktuellstes kritisches Issue abrufen. Atlassian: ein Jira-BUG mit Stack-Trace und Sentry-URL anlegen.✓ Kopiert

mcp-atlassian-sooperset + github

PRs automatisch mit Jira-Tickets verknüpfen

GitHub: heute gemergte PRs finden. Atlassian: für jeden das verknüpfte Jira-Issue mit der PR-URL kommentieren.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
jira_search	jql: str, limit?	Jede Jira-Suche	1 API-Aufruf
jira_get_issue	key: str, fields?	Vollständigen Inhalt eines Issues benötigt	1 Aufruf
jira_create_issue	project, type, summary, description, fields?	Neues Ticket anlegen	1 Aufruf
jira_transition_issue	key, transition, comment?	Issue durch Workflow bewegen	1 Aufruf
jira_add_comment	key, body	Kontext anhängen	1 Aufruf
confluence_search	cql: str	Docs finden	1 Aufruf
confluence_get_page	id: str	Seiteninhalt lesen	1 Aufruf
confluence_create_page	space, parent_id, title, body	Neues Dokument	1 Aufruf
confluence_update_page	id, title, body, version	Dokument bearbeiten	1 Aufruf

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Atlassian Cloud: 5000 Anfragen/Stunde pro User/Token (je nach Tarif)
Tokens pro Aufruf: 300–4000
Kosten in €: Kostenloser Open Source; Atlassian-Plan gilt
Tipp: fields= verwenden, um Payloads zu verkleinern; jira_get_issue-Standardwerte sind schwer

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: read:jira-work write:jira-work read:confluence-content.all write:confluence-content

Credential-Speicherung: API-Token in Env-Variable; über My Account rotieren

Datenabfluss: Nur die eigene atlassian.net- (oder Self-hosted-)Instanz

Niemals gewähren: site-admin

READ_ONLY_MODE=true setzen, wenn Claude nicht mutieren soll; deckt alle Write-Tools ab

Fehlerbehebung

Häufige Fehler und Lösungen

401 Unauthorized

Token abgelaufen oder falscher Benutzername (muss E-Mail für Cloud sein)

Prüfen: curl -u email:token $URL/rest/api/3/myself

JQL-Parse-Fehler

String-Werte quoten, Sonderzeichen escapen; vorher in der Jira-UI testen

Forbidden beim Erstellen im Space

Token-User hat keine Berechtigung "Add page" in dem Space

Rate-Limited 429

Backoff; parallelen Fanout reduzieren; Atlassian Rate Limit pro Token prüfen

Prüfen: X-RateLimit-Header

Alternativen

MCP Atlassian vs. andere

Alternative	Wann stattdessen	Kompromiss
Atlassian offizielles MCP (Cloud)	Nur Cloud und OAuth gewünscht	Neuer, schmaleres Toolset; kein Server/DC
Linear MCP	Linear statt Jira im Einsatz	Anderes System; schneller/sauberer, aber kein Confluence-Äquivalent

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen