Atlassian Confluence MCP Server
Ein Node.js/TypeScript Model Context Protocol (MCP)-Server für Atlassian Confluence Cloud. Ermöglicht KI-Systemen (z. B. LLMs wie Claude oder Cursor AI) die sichere Interaktion mit Ihren Confluence-Bereichen, -Seiten und -Inhalten in Echtzeit.
Warum diesen Server verwenden?
- Minimaler Input, maximaler Output : Einfache Kennungen liefern umfassende Details, ohne dass zusätzliche Flags erforderlich sind.
- Vollständiger Zugriff auf die Wissensdatenbank : Geben Sie KI-Assistenten Einblick in Dokumentationen, Wikis und Inhalte der Wissensdatenbank.
- Rich Content Formatting : Automatische Konvertierung des Atlassian Document Format in lesbares Markdown.
- Sichere lokale Authentifizierung : Führen Sie die Authentifizierung lokal mit Ihren Anmeldeinformationen aus und speichern Sie Token niemals auf Remote-Servern.
- Intuitive Markdown-Antworten : Gut strukturierte, konsistente Markdown-Formatierung für alle Ausgaben.
Was ist MCP?
Model Context Protocol (MCP) ist ein offener Standard für die sichere Verbindung von KI-Systemen mit externen Tools und Datenquellen. Dieser Server implementiert MCP für Confluence Cloud und ermöglicht KI-Assistenten die programmgesteuerte Interaktion mit Ihren Confluence-Inhalten.
Voraussetzungen
- Node.js (>=18.x): Herunterladen
- Atlassian-Konto mit Zugriff auf Confluence Cloud
Aufstellen
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
Option A: MCP-Konfigurationsdatei (empfohlen)
Bearbeiten oder erstellen Sie ~/.mcp/configs.json
:
<YOUR_SITE_NAME>
: Ihr Confluence-Site-Name (z. B.mycompany
fürmycompany.atlassian.net
).<YOUR_ATLASSIAN_EMAIL>
: Die E-Mail-Adresse Ihres Atlassian-Kontos.<YOUR_COPIED_API_TOKEN>
: Das API-Token aus Schritt 1.
Option B: Umgebungsvariablen
Schritt 3: Installieren und Ausführen
Schnellstart mit npx
Globale Installation
Schritt 4: Mit dem AI Assistant verbinden
Konfigurieren Sie Ihren MCP-kompatiblen Client (z. B. Claude, Cursor AI):
MCP-Tools
MCP-Tools verwenden snake_case
-Namen, camelCase
-Parameter und geben Antworten im Markdown-Format zurück.
- conf_ls_spaces : Listet zugängliche Confluence-Bereiche auf (
type
: str opt,status
: str opt,limit
: num opt,cursor
: str opt). Verwendung: Verfügbare Bereiche anzeigen. - conf_get_space : Ruft detaillierte Space-Informationen ab (
spaceKey
: str req). Verwendung: Zugriff auf Space-Inhalte und Metadaten. - conf_ls_pages : Listet Seiten mit Filterung auf (
spaceIds
: str[] opt,spaceKeys
: str[] opt,title
: str opt,status
: str[] opt,sort
: str opt,limit
: num opt,cursor
: str opt). Verwendung: Seiten finden, die den Kriterien entsprechen. - conf_get_page : Ruft den vollständigen Seiteninhalt ab (
pageId
: str req). Verwendung: Vollständigen Seiteninhalt als Markdown anzeigen. - conf_ls_page_comments : Listet Kommentare zu einer Seite auf (
pageId
: str req). Verwendung: Lesen von Seitendiskussionen. - conf_search : Durchsucht Confluence-Inhalte (
cql
: str opt,query
: str opt,title
: str opt,spaceKey
: str opt,labels
: str[] opt,contentType
: str opt,limit
: num opt,cursor
: str opt). Verwendung: Suche nach bestimmten Inhalten.
conf_ls_spaces
Globale Bereiche auflisten:
conf_get_space
Raumdetails abrufen:
conf_ls_pages
Seiten nach Bereich und Titel auflisten:
Seiten aus mehreren Bereichen auflisten:
conf_get_page
Seiteninhalt abrufen:
conf_ls_page_comments
Kommentare zur Listenseite:
conf_search
Einfache Suche:
Erweiterte CQL-Suche:
CLI-Befehle
CLI-Befehle verwenden kebab-case
. Führen Sie --help
aus, um Details zu erhalten (z. B. mcp-atlassian-confluence ls-spaces --help
).
- ls-spaces : Listet Leerzeichen auf (
--type
,--status
,--limit
,--cursor
). Beispiel:mcp-atlassian-confluence ls-spaces --type global
. - get-space : Ruft Space-Details ab (
--space-key
). Beispiel:mcp-atlassian-confluence get-space --space-key DEV
. - ls-pages : Listet Seiten auf (
--space-keys
,--title
,--status
,--sort
,--limit
,--cursor
). Beispiel:mcp-atlassian-confluence ls-pages --space-keys DEV
. - get-page : Ruft den Seiteninhalt ab (
--page-id
). Beispiel:mcp-atlassian-confluence get-page --page-id 12345678
. - ls-page-comments : Listet Kommentare auf (
--page-id
). Beispiel:mcp-atlassian-confluence ls-page-comments --page-id 12345678
. - Suche : Durchsucht Inhalt (
--cql
,--query
,--space-key
,--label
,--type
,--limit
,--cursor
). Beispiel:mcp-atlassian-confluence search --query "security"
.
Räume auflisten
Globale Bereiche auflisten:
Schaffen Sie Platz
Listenseiten
Durch mehrere Leertasten:
Mit Titelfilter:
Seite abrufen
Listenseite Kommentare
Suchen
Einfache Suche:
CQL-Suche:
Antwortformat
Alle Antworten sind im Markdown-Format, einschließlich:
- Titel : Inhaltstyp und Name.
- Inhalt : Vollständiger Seiteninhalt, Suchergebnisse oder Elementliste.
- Metadaten : Ersteller, Datum, Beschriftungen und andere relevante Informationen.
- Paginierung : Navigationsinformationen für paginierte Ergebnisse.
- Links : Verweise auf verwandte Ressourcen, sofern zutreffend.
Space List-Antwort
Seiteninhaltsantwort
Entwicklung
Beitragen
Beiträge sind willkommen! Bitte:
- Forken Sie das Repository.
- Erstellen Sie einen Feature-Zweig (
git checkout -b feature/xyz
). - Änderungen festschreiben (
git commit -m "Add xyz feature"
). - Pushen Sie zum Zweig (
git push origin feature/xyz
). - Öffnen Sie eine Pull-Anfrage.
Weitere Einzelheiten finden Sie unter CONTRIBUTING.md .
Lizenz
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Ein Model Context Protocol-Server, der KI-Assistenten wie Claude den Zugriff auf und die Suche nach Atlassian Confluence-Inhalten ermöglicht und so die Integration in die Wissensdatenbank Ihres Unternehmens ermöglicht.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.Last updated -129471JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.Last updated -98TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.Last updated -3396TypeScript
- AsecurityFlicenseAqualityA Model Context Protocol server that provides secure access to Atlassian Confluence, allowing users to search, create, update, and manage Confluence pages and spaces through natural language commands.Last updated -101TypeScript