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
- -securityFlicense-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 -2TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.Last updated -101PythonMIT 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