Atlassian MCP Server

Was ist der Atlassian MCP Server?

Der Atlassian MCP Server ist ein Model Context Protocol (MCP) Server. Er wurde entwickelt, um Atlassian-Produkte (Confluence und Jira, sowohl Cloud als auch Server/Data Center) mit KI-gestützten Assistenten und Entwicklertools zu integrieren. Der Server stellt die Funktionen von Jira und Confluence als ausführbare Funktionen ("Tools") über die MCP-Schnittstelle bereit. Das ermöglicht es LLMs und Agenten, Atlassian-Inhalte programmgesteuert zu automatisieren, zu durchsuchen und zu interagieren. Er fungiert als sichere Brücke zwischen Ihrer Atlassian-Instanz und den MCP-Hostanwendungen.

So konfigurieren Sie den Atlassian MCP Server

1. Authentifizierung einrichten: Wählen Sie Ihre bevorzugte Authentifizierungsmethode basierend auf dem Bereitstellungstyp:
   • Für Jira/Confluence Cloud: Verwenden Sie API-Token (empfohlen) oder OAuth 2.0
   • Für Server/Data Center: Verwenden Sie ein Personal Access Token (PAT)
2. Umgebungsvariablen: Bereiten Sie Umgebungsvariablen für Ihre Atlassian-URLs, Token und andere Optionen vor (z. B. Projekt-/Bereichsfilter, Nur-Lesen-Modus, Protokollierung).
3. Installation: Laden Sie das Docker-Image (ghcr.io/sooperset/mcp-atlassian:latest) in Ihre lokale Umgebung oder Ihren Server herunter.
4. Konfiguration in IDE oder Assistent:
   • Übergeben Sie Umgebungsvariablen direkt über die Einstellungen des MCP-Servers Ihrer IDE (z. B. in claude_desktop_config.json oder in den MCP-Einstellungen von Cursor).
   • Alternativ können Sie eine Umgebungsdatei erstellen und das --env-file-Flag von Docker verwenden.
5. Transport einrichten: Der Server kann entweder als Prozess mit stdio oder als persistenter HTTP-Dienst (mit SSE oder streambaren HTTP-Transporten) für Mehrbenutzer- oder netzwerkbasierte Bereitstellungen betrieben werden.
6. Proxy-Unterstützung: Konfigurieren Sie HTTP(S)/SOCKS-Proxys nach Bedarf mit den entsprechenden Umgebungsvariablen.
7. Werkzeugsteuerung: Verwenden Sie ENABLED_TOOLS, um den Zugriff auf bestimmte Aktionen zu beschränken oder zu erlauben, und READ_ONLY_MODE für zusätzliche Sicherheit.

So verwenden Sie den Atlassian MCP Server

1. Server starten: Starten Sie den Server mit Ihrer Konfiguration über Docker und geben Sie optional aktivierte Tools, Protokollierung oder Transporttyp an.
2. Verbindung über IDE oder KI-Assistent: Fügen Sie den laufenden Server als MCP-Server in den Einstellungen Ihrer IDE/Ihres Assistenten hinzu, indem Sie den entsprechenden Befehl oder HTTP-Endpunkt angeben.
3. Tools aufrufen: Nutzen Sie natürliche Sprache oder benutzerdefinierte Flows, um Ihren Assistenten um Hilfe bei Jira- und Confluence-Aktionen zu bitten (z. B. suchen, erstellen, aktualisieren, zusammenfassen).
4. Zugriff steuern: Filtern Sie die verfügbaren Tools, aktivieren/deaktivieren Sie Schreiboperationen und wählen Sie nach Bedarf eine Authentifizierung pro Benutzer oder serverweit.
5. Überwachen und Debuggen: Sehen Sie sich Protokolle an, verwenden Sie Debugging-Tools und überwachen Sie Interaktionen, um einen reibungslosen Betrieb sicherzustellen.

Hauptmerkmale

• Unterstützt Jira & Confluence (Cloud und Server/DC) mit einer einzigen Integration
• Ausführbare Tools: Stellt Atlassian-APIs als aufrufbare Tools über MCP für den Einsatz durch LLMs und Agenten bereit
• Nahtlose IDE/Assistent-Integration: Konfigurierbar in Claude Desktop, Cursor und ähnlichen Plattformen
• Multi-Auth-Unterstützung: Unterstützt OAuth 2.0, API-Tokens und PATs. Ermöglicht sowohl Einzel- als auch Mehrbenutzerauthentifizierung
• Sichere In-Infra-Bereitstellung: Hält Anmeldeinformationen und Daten in Ihrer Umgebung
• Werkzeugfilterung & Nur-Lesen-Modi: Granulare Kontrolle über verfügbare Aktionen und Berechtigungen
• Proxy- und Protokollierungsunterstützung: Unternehmensbereit mit benutzerdefiniertem Proxy, Protokollierung und ausführlichen Debug-Optionen
• Skalierbarer HTTP-Transport: Kann als persistenter HTTP-Dienst für gemeinsame oder automatisierte Anwendungsfälle betrieben werden

Anwendungsfälle

• KI-gestützte Suche: Schnell Projektunterlagen und Probleme mit natürlichen Sprachabfragen finden und zusammenfassen
• Automatisierte Jira-Updates: Erstellen, aktualisieren, übergeben und kommentieren Sie Jira-Probleme basierend auf Besprechungsnotizen oder Chat-Kommandos
• Dokumentenerstellung: Erstellen und aktualisieren Sie Confluence-Seiten oder Jira-Tickets direkt von Ihrem KI-Assistenten oder Ihrer IDE
• Berichterstattung und Filterung: Automatisieren Sie das Abrufen und Zusammenfassen von dringenden Bugs, Statusupdates und Projektmetriken
• Multi-User-Workflows: Ermöglichen Sie den organisationsweiten Zugriff auf Atlassian-Aktionen unter Berücksichtigung der Berechtigungen jedes Benutzers mithilfe von benutzerbezogenen Token

FAQ

F: Welche Authentifizierungsmethoden werden unterstützt?
A: Der Server unterstützt Atlassian API-Token (Cloud), Personal Access Tokens (Server/DC) und OAuth 2.0 (Cloud, für erweiterte Szenarien und Mehrbenutzerunterstützung).

F: Kann ich einschränken, welche Aktionen der MCP-Server meinem Assistenten bereitstellt?
A: Ja, Sie können aktivierte Tools über die Umgebungsvariable ENABLED_TOOLS oder das Befehlszeilen-Flag angeben und READ_ONLY_MODE setzen, um alle Schreiboperationen zu deaktivieren.

F: Wie gehe ich mit SSL-Zertifikatsproblemen bei meiner Server/Data Center-Bereitstellung um?
A: Setzen Sie CONFLUENCE_SSL_VERIFY=false oder JIRA_SSL_VERIFY=false in Ihrer Konfiguration, wenn Ihre Atlassian-Instanz selbstsignierte Zertifikate verwendet.

F: Ist es möglich, den Server für mehrere Benutzer mit eigenen Anmeldeinformationen auszuführen?
A: Ja, verwenden Sie den HTTP-Transport (SSE oder streambares HTTP) und lassen Sie jeden Client benutzerspezifische Token bereitstellen (OAuth für Cloud oder PAT für Server/DC).

F: Was ist, wenn mein Assistent keine Verbindung zu Jira oder Confluence herstellen kann?
A: Überprüfen Sie die Authentifizierungsanmeldeinformationen, Netzwerkeinstellungen/Proxy-Einstellungen, die URL-Genauigkeit und die Benutzerberechtigungen in Ihrer Atlassian-Instanz.