MCP Atlassian Server

MCP Atlassian Server (von phuc-nt)

Einführung

MCP Atlassian Server (von phuc-nt) ist ein Model Context Protocol (MCP)-Server, der KI-Agenten wie Cline, Claude Desktop oder Cursor mit Atlassian Jira und Confluence verbindet und es ihnen ermöglicht, Daten abzufragen und Aktionen über eine standardisierte Schnittstelle auszuführen.

Hinweis: Dieser Server ist in erster Linie für die Verwendung mit Cline konzipiert und optimiert, folgt jedoch dem MCP-Standard und kann mit anderen MCP-kompatiblen Clients zusammenarbeiten.

• Hauptmerkmale:
  • Verbinden Sie KI-Agenten mit Atlassian Jira und Confluence
  • Unterstützt sowohl Ressourcen (schreibgeschützt) als auch Tools (Aktionen/Mutationen)
  • Einfache Integration mit Cline über MCP Marketplace
  • Local-First-Design für persönliche Entwicklungsumgebungen
  • Optimierte Integration mit dem Cline AI-Assistenten

Das Warum hinter diesem Projekt

Als Entwickler, der täglich mit Jira und Confluence arbeitet, verbrachte ich viel Zeit mit der Navigation dieser Tools. Obwohl sie leistungsstark sind, wünschte ich mir eine einfachere Möglichkeit, mit ihnen zu interagieren, ohne bei intensiver Arbeit ständig den Kontext wechseln zu müssen.

Das Aufkommen von KI-Agenten und dem Model Context Protocol (MCP) bot die perfekte Gelegenheit. Ich erkannte sofort das Potenzial, Jira und Confluence (mit Plänen für Slack, GitHub, Kalender und mehr) mit meinen KI-Workflows zu verbinden.

Dieses Projekt begann als Lernreise in die Welt von MCP und KI-Agenten, aber ich hoffe, dass es sich zu etwas wirklich Nützlichem für Einzelpersonen und Organisationen entwickelt, die täglich mit Atlassian-Tools interagieren.

Systemarchitektur

Installation und Einrichtung

Detaillierte Anweisungen zur Installation und Einrichtung finden Sie in unserer Installationsanleitung für KI-Assistenten . Diese Anleitung ist speziell für KI-/LLM-Assistenten wie Cline formatiert, damit diese den MCP Atlassian Server lesen und automatisch einrichten können.

Hinweis für Cline-Nutzer : Die Installationsanleitung (llms-install.md) ist für Cline AI optimiert und lässt sich leicht verstehen und ausführen. Sie können Cline einfach bitten, „MCP Atlassian Server (von phuc-nt) zu installieren“. Cline analysiert die Anweisungen und unterstützt Sie Schritt für Schritt bei der Einrichtung.

Der Leitfaden enthält:

• Voraussetzungen und Systemanforderungen
• Schrittweise Einrichtung für Node.js-Umgebungen
• Konfigurieren des Cline AI-Assistenten für die Verbindung mit Atlassian
• Abrufen und Einrichten von Atlassian API-Token
• Sicherheitsempfehlungen und bewährte Methoden

Installation über Smithery

So installieren Sie Atlassian Integration Server für Claude Desktop automatisch über Smithery :

Funktionsübersicht

Eine ausführliche Dokumentation aller Ressourcen und Tools finden Sie unter Ressourcen- und Tool-Referenz

Anforderungsfluss

Beispiel-Anwendungsfälle

Versuchen Sie, Cline nach der Installation diese Fragen zu stellen:

1. Aufgaben erstellen und verwalten
   • „Erstellen Sie im Projekt DEMO ein neues Problem zu Anmeldefehlern.“
   • „Alle mir im aktuellen Sprint zugewiesenen Probleme finden“
   • „Übergangsproblem DEMO-43 in den Status „Erledigt““
2. Zusammenfassung der Projektinformationen
   • „Alle Probleme im Projekt DEMO zusammenfassen“
   • „Wem werden im Projekt DEMO Probleme zugewiesen?“
   • „Liste nicht zugewiesener Probleme im aktuellen Sprint auf“
3. Dokumentation mit Confluence
   • „Erstellen Sie eine Confluence-Seite mit dem Titel ‚Meeting-Notizen‘.“
   • „Aktualisieren Sie die Confluence-Seite ‚API-Dokumentation‘ mit neuen Beispielen und Beschriftungen.“
   • „Fügen Sie der Seite über Architektur das Label ‚Dokumentation‘ hinzu.“
   • „Entfernen Sie die Bezeichnung ‚Entwurf‘ von der Seite ‚Besprechungsnotizen‘.“
   • „Fügen Sie der Confluence-Seite zur API-Dokumentation einen Kommentar hinzu.“
4. Analyse und Reporting
   • „Vergleichen Sie die Anzahl der abgeschlossenen Probleme zwischen dem aktuellen und dem vorherigen Sprint.“
   • „Wer hat die meisten Aufgaben im Status ‚Zu erledigen‘?“

Diese Abfragen funktionieren am besten in der Cline-Umgebung, die mit diesem MCP-Server gründlich getestet wurde.

Verwendungshinweise

1. Einfaches JQL : Verwenden Sie bei der Suche nach Problemen einfaches JQL ohne Leerzeichen oder Sonderzeichen (z. B. project=DEMO statt project = DEMO AND key = DEMO-43 ).
2. Confluence-Seite erstellen : Verwenden Sie beim Erstellen einer Confluence-Seite einfachen HTML-Inhalt und geben Sie keine ParentId an, um Fehler zu vermeiden.
3. Confluence-Seite aktualisieren : Geben Sie beim Aktualisieren einer Seite immer die aktuelle Versionsnummer an, um Konflikte zu vermeiden. Sie können auch Beschriftungen aktualisieren (hinzufügen/entfernen) und müssen ein gültiges Speicherformat für den Inhalt verwenden.
4. Problem erstellen : Geben Sie beim Erstellen neuer Probleme für optimale Ergebnisse nur die mindestens erforderlichen Felder (Projektschlüssel, Zusammenfassung) an.
5. Zugriffsrechte : Stellen Sie sicher, dass das konfigurierte Atlassian-Konto Zugriff auf die Projekte und Bereiche hat, mit denen Sie interagieren möchten.

Sicherheitshinweis

• Ihr API-Token erbt alle Berechtigungen des Benutzers, der es erstellt hat
• Geben Sie Ihr Token niemals an eine nicht vertrauenswürdige Partei weiter
• Seien Sie vorsichtig, wenn Sie LLMs bitten, Konfigurationsdateien zu analysieren, die Ihr Token enthalten
• Detaillierte Sicherheitsrichtlinien finden Sie in llms-install.md

Beitragen und unterstützen

• Tragen Sie bei, indem Sie Pull Requests oder Issues auf GitHub öffnen.
• Treten Sie der MCP/Cline-Community bei, um zusätzliche Unterstützung zu erhalten.

MCP Atlassian Server (von phuc-nt) ist bereit für die Ein-Klick-Installation vom Cline Marketplace!
Detaillierte Anweisungen finden Sie in llms-install.md

Obwohl der Server den offenen MCP-Standard verwendet, ist er in erster Linie für Cline-Benutzer konzipiert und getestet.