Atlassian Confluence MCP Server

Dieses Projekt stellt einen Model Context Protocol (MCP)-Server bereit, der als Brücke zwischen KI-Assistenten (wie Anthropics Claude, Cursor AI oder anderen MCP-kompatiblen Clients) und Ihrer Atlassian Confluence-Instanz fungiert. Er ermöglicht KI den sicheren Zugriff auf Ihre Confluence-Bereiche und -Seiten und die Interaktion mit ihnen in Echtzeit.

Überblick

Was ist MCP?

Model Context Protocol (MCP) ist ein offener Standard, der es KI-Systemen ermöglicht, sich sicher und kontextbezogen mit externen Tools und Datenquellen zu verbinden.

Dieser Server implementiert MCP speziell für Confluence Cloud und verbindet Ihre Confluence-Daten mit KI-Assistenten.

Warum diesen Server verwenden?

Philosophie des minimalen Inputs, des maximalen Outputs : Einfache Bezeichner wie spaceKey und pageId genügen. Jedes Tool liefert umfassende Details, ohne dass zusätzliche Flags erforderlich sind.
Vollständiger Zugriff auf die Wissensdatenbank : Geben Sie Ihrem KI-Assistenten in Echtzeit vollständige Transparenz in Ihre Dokumentation, Wikis und Wissensdatenbankinhalte.
Umfangreiche Inhaltsformatierung : Der gesamte Seiteninhalt wird automatisch mit den richtigen Überschriften, Tabellen, Listen und anderen Formatierungselementen vom Atlassian-Dokumentformat in Markdown konvertiert.
Sichere lokale Authentifizierung : Anmeldeinformationen werden niemals auf dem Server gespeichert. Der Server läuft lokal, sodass Ihre Token Ihren Computer nie verlassen und Sie nur die Berechtigungen anfordern können, die Sie benötigen.
Intuitive Markdown-Antworten : Alle Antworten verwenden gut strukturiertes Markdown zur besseren Lesbarkeit mit konsistenter Formatierung und Navigationslinks.

Erste Schritte

Voraussetzungen

Node.js (>=18.x): Herunterladen
Atlassian-Konto mit Zugriff auf Confluence Cloud

Schritt 1: Holen Sie sich Ihr Atlassian API-Token

Gehen Sie zu Ihrer Atlassian API-Token-Verwaltungsseite: https://id.atlassian.com/manage-profile/security/api-tokens
Klicken Sie auf API-Token erstellen .
Geben Sie ihm eine beschreibende Bezeichnung (z. B. mcp-confluence-access ).
Klicken Sie auf Erstellen .
Kopieren Sie das generierte API-Token sofort. Sie können es nicht mehr sehen.

Schritt 2: Anmeldeinformationen konfigurieren

Methode A: MCP-Konfigurationsdatei (empfohlen)

Erstellen oder bearbeiten Sie ~/.mcp/configs.json :

{
	"confluence": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>",
			"ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>",
			"ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>"
		}
	}
}

<YOUR_SITE_NAME> : Ihr Confluence-Site-Name (z. B. mycompany für mycompany.atlassian.net ).
<YOUR_ATLASSIAN_EMAIL> : Die E-Mail-Adresse Ihres Atlassian-Kontos.
<YOUR_COPIED_API_TOKEN> : Das API-Token aus Schritt 1.

Hinweis: Aus Gründen der Abwärtskompatibilität erkennt der Server Konfigurationen auch unter dem vollständigen Paketnamen ( @aashari/mcp-server-atlassian-confluence ), dem Paketnamen ohne Gültigkeitsbereich ( mcp-server-atlassian-confluence ) oder im atlassian-confluence -Format, wenn der empfohlene confluence -Schlüssel nicht gefunden wird. Für neue Konfigurationen wird jedoch die Verwendung des kurzen confluence -Schlüssels empfohlen.

Methode B: Umgebungsvariablen

Übergeben Sie die Anmeldeinformationen direkt beim Ausführen des Servers:

ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" \
ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" \
ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" \
npx -y @aashari/mcp-server-atlassian-confluence

Schritt 3: Verbinden Sie Ihren KI-Assistenten

Konfigurieren Sie Ihren MCP-kompatiblen Client, um diesen Server zu starten.

Claude / Cursor-Konfiguration:

{
	"mcpServers": {
		"confluence": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-confluence"]
		}
	}
}

Diese Konfiguration startet den Server automatisch zur Laufzeit.

Werkzeuge

Dieser Abschnitt behandelt die verfügbaren MCP-Tools bei Verwendung dieses Servers mit einem KI-Assistenten. Beachten Sie, dass MCP-Tools snake_case für Toolnamen und camelCase für Parameter verwenden.

`conf_ls_spaces`

Listet die für den Benutzer zugänglichen Confluence-Bereiche auf.

Filter: type („global“, „persönlich“), status („aktuell“, „archiviert“).
Seitennummerierung: limit , cursor .
Standardsortierung: nach Name.

Beispiel:

{ "type": "global", "status": "current", "limit": 10 }

„Zeigen Sie mir die ersten 10 aktuellen globalen Confluence-Bereiche.“

`conf_get_space`

Erhalten Sie alle Details zu einem bestimmten Bereich mithilfe seines spaceKey . Enthält Homepage, Beschreibung und andere Metadaten.

Beispiel:

{ "spaceKey": "DEV" }

„Erzählen Sie mir etwas über den DEV-Bereich in Confluence.“

`conf_ls_pages`

Listet Seiten auf.

Filter: spaceIds (Array von Space-IDs), spaceKeys (Array von Space-Schlüsseln), title (Text im Titel), status (z. B. „aktuell“, „archiviert“).
Sortierung: sort (z. B. „Änderungsdatum“, „Titel“).
Seitennummerierung: limit , cursor .

Beispiel (mit Leertaste und Titel):

{
	"spaceKeys": ["DEV"],
	"title": "API Documentation",
	"status": ["current"],
	"sort": "-modified-date"
}

„Zeigen Sie mir aktuelle Seiten im DEV-Bereich mit ‚API-Dokumentation‘ im Titel, sortiert nach Änderungsdatum.“

`conf_get_page`

Erhalten Sie den vollständigen Inhalt (als Markdown) und die Metadaten für eine bestimmte Seite über ihre pageId .

Beispiel:

{ "pageId": "12345678" }

„Holen Sie sich den Inhalt der Confluence-Seite 12345678.“

`conf_search`

Durchsucht Confluence-Inhalte.

Abfragen: cql (vollständige Confluence Query Language-Zeichenfolge) oder Kombination einfacherer Filter:
- query (Freitextsuche nach Text und Titel)
- title (Text im Titel)
- spaceKey (Begrenzung auf ein Leerzeichen)
- labels (Array von Beschriftungen – Inhalt muss ALLE enthalten)
- contentType ('Seite', 'Blogbeitrag')
Seitennummerierung: limit , cursor .
Gibt Ergebnisse als Markdown zurück, inklusive Snippets und Metadaten. Die ausgeführte CQL-Abfrage wird ebenfalls in den Metadaten zurückgegeben.

Beispiel (einfache Suche):

{
	"query": "release notes Q1",
	"spaceKey": "PRODUCT",
	"contentType": "page",
	"limit": 5
}

„Suchen Sie auf den Seiten im Bereich PRODUKT nach ‚Release Notes Q1‘.“

Beispiel (erweitertes CQL):

{ "cql": "space = DEV AND label = api AND created >= '2023-01-01'" }

„Suchen Sie im DEV-Bereich nach Inhalten mit der Bezeichnung ‚API‘, die seit dem 1. Januar 2023 erstellt wurden.“

Befehlszeilenschnittstelle (CLI)

Die CLI verwendet Kebab-Case für Befehle (z. B. ls-spaces ) und Optionen (z. --space-key ).

Schnelle Verwendung mit `npx`

npx -y @aashari/mcp-server-atlassian-confluence ls-spaces --type global --status current --limit 10
npx -y @aashari/mcp-server-atlassian-confluence get-space --space-key DEV
npx -y @aashari/mcp-server-atlassian-confluence ls-pages --space-key DEV --title "Release Notes" --status current --sort "-modified-date"
npx -y @aashari/mcp-server-atlassian-confluence get-page --page-id 12345678
npx -y @aashari/mcp-server-atlassian-confluence search --query "security best practices" --space-key DOCS --type page --limit 5
npx -y @aashari/mcp-server-atlassian-confluence search --cql "label = official-docs AND creator = currentUser()"

Global installieren

npm install -g @aashari/mcp-server-atlassian-confluence

Führen Sie dann direkt aus:

mcp-atlassian-confluence ls-spaces
mcp-atlassian-confluence get-page --page-id 12345678

Entdecken Sie weitere CLI-Optionen

Verwenden Sie --help , um Flags und Verwendung für alle verfügbaren Befehle anzuzeigen:

mcp-atlassian-confluence --help

Oder erhalten Sie ausführliche Hilfe zu einem bestimmten Befehl:

mcp-atlassian-confluence ls-spaces --help
mcp-atlassian-confluence get-space --help
mcp-atlassian-confluence ls-pages --help
mcp-atlassian-confluence get-page --help
mcp-atlassian-confluence search --help

Lizenz

ISC-Lizenz

Atlassian Confluence MCP Server

Integrations