MCP Atlassian
Model Context Protocol (MCP)-Server für Atlassian-Produkte (Confluence und Jira). Diese Integration unterstützt sowohl Confluence & Jira Cloud- als auch Server-/Data Center-Bereitstellungen.
Beispielverwendung
Bitten Sie Ihren KI-Assistenten:
- 📝 Automatische Jira-Updates – „Aktualisieren Sie Jira anhand unserer Besprechungsnotizen“
- 🔍 KI-gestützte Confluence-Suche – „Finden Sie unseren OKR-Leitfaden in Confluence und fassen Sie ihn zusammen“
- 🐛 Intelligente Jira-Problemfilterung – „Zeigen Sie mir dringende Fehler im PROJ-Projekt von letzter Woche“
- 📄 Inhaltserstellung und -verwaltung – „Erstellen Sie ein technisches Designdokument für die Funktion XYZ“
Funktionsdemo
https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785
Kompatibilität
Produkt | Bereitstellungstyp | Support-Status |
---|---|---|
Zusammenfluss | Wolke | ✅ Vollständig unterstützt |
Zusammenfluss | Server/Rechenzentrum | ✅ Unterstützt (Version 6.0+) |
Jira | Wolke | ✅ Vollständig unterstützt |
Jira | Server/Rechenzentrum | ✅ Unterstützt (Version 8.14+) |
Kurzanleitung
🔐 1. Authentifizierungs-Setup
MCP Atlassian unterstützt drei Authentifizierungsmethoden:
A. API-Token-Authentifizierung (Cloud)
- Gehen Sie zu https://id.atlassian.com/manage-profile/security/api-tokens
- Klicken Sie auf API-Token erstellen und benennen Sie es
- Kopieren Sie das Token sofort
B. Persönlicher Zugriffstoken (Server/Rechenzentrum)
- Gehen Sie zu Ihrem Profil (Avatar) → Profil → Persönliche Zugriffstoken
- Klicken Sie auf „Token erstellen“ , benennen Sie es und legen Sie das Ablaufdatum fest
- Kopieren Sie das Token sofort
C. OAuth 2.0-Authentifizierung (Cloud)
- Zur Atlassian Developer Console
- Erstellen Sie eine App zur „OAuth 2.0 (3LO)-Integration“
- Konfigurieren Sie Berechtigungen (Bereiche) für Jira/Confluence
- Rückruf-URL festlegen (z.
http://localhost:8080/callback
) - Führen Sie den Setup-Assistenten aus:
- Folgen Sie den Anweisungen für
Client ID
,Secret
,URI
undScope
- Vollständige Browserautorisierung
- Fügen Sie die erhaltenen Anmeldeinformationen zur
.env
oder IDE-Konfiguration hinzu:ATLASSIAN_OAUTH_CLOUD_ID
(vom Assistenten)ATLASSIAN_OAUTH_CLIENT_ID
ATLASSIAN_OAUTH_CLIENT_SECRET
ATLASSIAN_OAUTH_REDIRECT_URI
ATLASSIAN_OAUTH_SCOPE
[!WICHTIG]
offline_access
in den Bereich für dauerhafte Authentifizierung einschließen (z. B.read:jira-work write:jira-work offline_access
)
📦 2. Installation
MCP Atlassian wird als Docker-Image bereitgestellt. Dies ist die empfohlene Ausführungsmethode für den Server, insbesondere für die IDE-Integration. Stellen Sie sicher, dass Docker installiert ist.
🛠️ IDE-Integration
MCP Atlassian ist für die Verwendung mit KI-Assistenten durch IDE-Integration konzipiert.
[!TIP] Für Claude Desktop : Suchen und bearbeiten Sie die Konfigurationsdatei direkt:
- Windows :
%APPDATA%\Claude\claude_desktop_config.json
- macOS :
~/Library/Application Support/Claude/claude_desktop_config.json
- Linux :
~/.config/Claude/claude_desktop_config.json
Für Cursor : Öffnen Sie Einstellungen → MCP → + Neuen globalen MCP-Server hinzufügen
⚙️ Konfigurationsmethoden
Es gibt zwei Hauptansätze zum Konfigurieren des Docker-Containers:
- Direktes Übergeben von Variablen (siehe Beispiele unten)
- Verwenden einer Umgebungsdatei mit dem Flag
--env-file
(in einklappbaren Abschnitten angezeigt)
[!NOTE] Zu den gängigen Umgebungsvariablen gehören:
CONFLUENCE_SPACES_FILTER
: Filtern nach Space-Schlüsseln (z. B. „DEV, TEAM, DOC“)JIRA_PROJECTS_FILTER
: Filtern nach Projektschlüsseln (z. B. „PROJ,DEV,SUPPORT“)READ_ONLY_MODE
: Auf „true“ setzen, um Schreibvorgänge zu deaktivierenMCP_VERBOSE
: Auf „true“ setzen für detailliertere ProtokollierungENABLED_TOOLS
: Kommagetrennte Liste der zu aktivierenden Toolnamen (z. B. „confluence_search,jira_get_issue“)Alle verfügbaren Optionen finden Sie in der Datei .env.example .
📝 Konfigurationsbeispiele
Methode 1 (Direkte Übergabe von Variablen):
Verwenden Sie für Server-/Data-Center-Bereitstellungen die direkte Variablenübergabe:
[!NOTE] Setzen Sie
CONFLUENCE_SSL_VERIFY
undJIRA_SSL_VERIFY
nur dann auf „false“, wenn Sie über selbstsignierte Zertifikate verfügen.
Dieses Beispiel zeigt, wie Sie mcp-atlassian
in Ihrer IDE (z. B. Cursor oder Claude Desktop) konfigurieren, wenn Sie OAuth 2.0 für Atlassian Cloud verwenden. Stellen Sie sicher, dass Sie zuerst den OAuth-Setup-Assistenten abgeschlossen haben.
[!NOTIZ]
ATLASSIAN_OAUTH_CLOUD_ID
wird aus der Ausgabe des Assistenten--oauth-setup
abgerufen.- Andere
ATLASSIAN_OAUTH_*
Variablen sind diejenigen, die Sie für Ihre OAuth-App in der Atlassian Developer Console konfiguriert haben (und als Eingabe für den Setup-Assistenten verwendet haben).JIRA_URL
undCONFLUENCE_URL
für Ihre Cloud-Instanzen werden weiterhin benötigt.
MCP Atlassian unterstützt das Routing von API-Anfragen über Standard-HTTP/HTTPS/SOCKS-Proxys. Konfigurieren Sie mithilfe von Umgebungsvariablen:
- Unterstützt Standard
HTTP_PROXY
,HTTPS_PROXY
,NO_PROXY
,SOCKS_PROXY
. - Es sind dienstspezifische Überschreibungen verfügbar (z. B.
JIRA_HTTPS_PROXY
,CONFLUENCE_NO_PROXY
). - Dienstspezifische Variablen überschreiben globale Variablen für diesen Dienst.
Fügen Sie die relevanten Proxy-Variablen zu den Abschnitten args
(mit -e
) und env
Ihrer MCP-Konfiguration hinzu:
Anmeldeinformationen in Proxy-URLs werden in Protokollen maskiert. Wenn Sie NO_PROXY
festlegen, wird dies bei Anfragen an übereinstimmende Hosts berücksichtigt.
Nur für Confluence Cloud:
Verwenden Sie für Confluence Server/DC:
Nur für Jira Cloud:
Verwenden Sie für Jira Server/DC:
👥 HTTP-Transportkonfiguration
Anstatt stdio
zu verwenden, können Sie den Server als dauerhaften HTTP-Dienst ausführen, indem Sie Folgendes verwenden:
sse
-Transport (Server-Sent Events) am/sse
Endpunktstreamable-http
Transport am/mcp
Endpunkt
Beide Transporttypen unterstützen die Einzelbenutzer- und Mehrbenutzerauthentifizierung:
Authentifizierungsoptionen:
- Einzelbenutzer : Verwenden Sie die über Umgebungsvariablen konfigurierte Authentifizierung auf Serverebene
- Mehrbenutzer : Jeder Benutzer stellt seine eigene Authentifizierung bereit:
- Cloud: OAuth 2.0-Bearer-Token
- Server/Rechenzentrum: Persönliche Zugriffstoken (PATs)
- Starten Sie den Server mit dem von Ihnen gewählten Transportmittel:
- Konfigurieren Sie Ihre IDE (Beispiel für einen Einzelbenutzer):SSE-Transportbeispiel:Beispiel für Streamable-HTTP-Transport:
Hier ist ein vollständiges Beispiel für die Einrichtung einer Mehrbenutzerauthentifizierung mit streambarem HTTP-Transport:
- Führen Sie zunächst den OAuth-Setup-Assistenten aus, um die OAuth-Anmeldeinformationen des Servers zu konfigurieren:
- Starten Sie den Server mit streamable-HTTP-Transport:
- Konfigurieren Sie die MCP-Einstellungen Ihrer IDE:
Wählen Sie die entsprechende Autorisierungsmethode für Ihre Atlassian-Bereitstellung:
- Cloud (OAuth 2.0): Verwenden Sie dies, wenn sich Ihre Organisation in der Atlassian Cloud befindet und Sie für jeden Benutzer ein OAuth-Zugriffstoken haben.
- Server/Rechenzentrum (PAT): Verwenden Sie dies, wenn Sie sich auf einem Atlassian-Server oder -Rechenzentrum befinden und jeder Benutzer über ein persönliches Zugriffstoken (PAT) verfügt.
Cloud (OAuth 2.0) Beispiel:
Server/Rechenzentrum (PAT) Beispiel:
- Erforderliche Umgebungsvariablen in
.env
:
[!NOTIZ]
- Der Server sollte eine eigene Fallback-Authentifizierung konfiguriert haben (z. B. über Umgebungsvariablen für API-Token, PAT oder ein eigenes OAuth-Setup mit --oauth-setup). Dies wird verwendet, wenn eine Anfrage keine benutzerspezifische Authentifizierung enthält.
- OAuth : Jeder Benutzer benötigt sein eigenes OAuth-Zugriffstoken von Ihrer Atlassian OAuth-App.
- PAT : Jeder Benutzer stellt sein eigenes persönliches Zugriffstoken bereit.
- Der Server verwendet das Token des Benutzers für API-Aufrufe, sofern es bereitgestellt wird. Andernfalls greift er auf die Serverauthentifizierung zurück.
- Benutzertoken sollten über geeignete Bereiche für die erforderlichen Vorgänge verfügen
Werkzeuge
Wichtige Werkzeuge
Jira-Tools
jira_get_issue
: Details zu einem bestimmten Problem abrufenjira_search
: Probleme mit JQL suchenjira_create_issue
: Ein neues Problem erstellenjira_update_issue
: Ein bestehendes Problem aktualisierenjira_transition_issue
: Überführen eines Problems in einen neuen Statusjira_add_comment
: Einen Kommentar zu einem Problem hinzufügen
Confluence-Tools
confluence_search
: Durchsuchen Sie Confluence-Inhalte mit CQLconfluence_get_page
: Inhalt einer bestimmten Seite abrufenconfluence_create_page
: Eine neue Seite erstellenconfluence_update_page
: Eine vorhandene Seite aktualisieren
Betrieb | Jira-Tools | Confluence-Tools |
---|---|---|
Lesen | jira_search | confluence_search |
jira_get_issue | confluence_get_page | |
jira_get_project_issues | confluence_get_page_children | |
jira_get_worklog | confluence_get_comments | |
jira_get_transitions | confluence_get_labels | |
jira_get_agile_boards | ||
jira_get_board_issues | ||
jira_get_sprints_from_board | ||
jira_get_sprint_issues | ||
jira_get_issue_link_types | ||
jira_batch_get_changelogs * | ||
jira_get_user_profile | ||
jira_download_attachments | ||
Schreiben | jira_create_issue | confluence_create_page |
jira_update_issue | confluence_update_page | |
jira_delete_issue | confluence_delete_page | |
jira_batch_create_issues | confluence_add_label | |
jira_add_comment | confluence_add_comment | |
jira_transition_issue | ||
jira_add_worklog | ||
jira_link_to_epic | ||
jira_create_sprint | ||
jira_update_sprint | ||
jira_create_issue_link | ||
jira_remove_issue_link |
*Tool nur in Jira Cloud verfügbar
Werkzeugfilterung und Zugriffskontrolle
Der Server bietet zwei Möglichkeiten zur Steuerung des Toolzugriffs:
- Werkzeugfilterung : Verwenden Sie das Flag
--enabled-tools
oder die UmgebungsvariableENABLED_TOOLS
, um anzugeben, welche Werkzeuge verfügbar sein sollen: - Lese-/Schreibsteuerung : Tools werden als Lese- oder Schreibvorgänge kategorisiert. Wenn
READ_ONLY_MODE
aktiviert ist, sind unabhängig von der EinstellungENABLED_TOOLS
nur Lesevorgänge verfügbar.
Fehlerbehebung und Debugging
Häufige Probleme
- Authentifizierungsfehler :
- Für die Cloud: Überprüfen Sie Ihre API-Token (nicht Ihr Kontopasswort)
- Für Server/Rechenzentrum: Überprüfen Sie, ob Ihr persönliches Zugriffstoken gültig und nicht abgelaufen ist
- Für ältere Confluence-Server: Einige ältere Versionen erfordern eine grundlegende Authentifizierung mit
CONFLUENCE_USERNAME
undCONFLUENCE_API_TOKEN
(wobei Token Ihr Passwort ist).
- Probleme mit SSL-Zertifikaten : Wenn Sie Server/Data Center verwenden und SSL-Fehler auftreten, setzen Sie
CONFLUENCE_SSL_VERIFY=false
oderJIRA_SSL_VERIFY=false
- Berechtigungsfehler : Stellen Sie sicher, dass Ihr Atlassian-Konto über ausreichende Berechtigungen für den Zugriff auf die Bereiche/Projekte verfügt
Debugging-Tools
Sicherheit
- Geben Sie niemals API-Token weiter
- Halten Sie .env-Dateien sicher und privat
- Best Practices finden Sie unter SECURITY.md
Beitragen
Wir freuen uns über Beiträge zu MCP Atlassian! Wenn Sie mitmachen möchten:
- Ausführliche Anweisungen zur Einrichtung der Entwicklung finden Sie in unserem CONTRIBUTING.md- Handbuch.
- Nehmen Sie Änderungen vor und senden Sie eine Pull-Anfrage.
Wir verwenden Pre-Commit-Hooks für die Codequalität und folgen der semantischen Versionierung für Releases.
Lizenz
Lizenziert unter MIT (siehe LICENSE- Datei). Dies ist kein offizielles Atlassian-Produkt.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Model Context Protocol (MCP)-Server für Atlassian-Produkte (Confluence und Jira). Diese Integration unterstützt sowohl Confluence & Jira Cloud- als auch Server-/Data Center-Bereitstellungen.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that enables AI agents to interact with Atlassian products (Confluence and Jira) for content management, issue tracking, and project management through a standardized interface.Last updated -3TypeScriptMIT License
- -securityAlicense-qualityModel Context Protocol server for integrating with Atlassian products (Confluence and Jira) that supports both Atlassian Cloud and Server/Data Center deployments.Last updated -1PythonMIT License
- AsecurityFlicenseAqualityIntegrates Atlassian products (Confluence, Jira) with Model Context Protocol, enabling easy access to Confluence content and Jira tickets through the MCP interface.Last updated -2JavaScript
- AsecurityAlicenseAqualityModel Context Protocol server that integrates with Atlassian Confluence and Jira, enabling AI assistants to search, create, and update content in these platforms through natural language interactions.Last updated -PythonMIT License