Skip to main content
Glama

Atlassian Confluence MCP Server

by aashari

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

  1. Gehen Sie zu Ihrer Atlassian API-Token-Verwaltungsseite: https://id.atlassian.com/manage-profile/security/api-tokens
  2. Klicken Sie auf API-Token erstellen .
  3. Geben Sie ihm eine beschreibende Bezeichnung (z. B. mcp-confluence-access ).
  4. Klicken Sie auf Erstellen .
  5. 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 :

{ "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.
Option B: Umgebungsvariablen
export ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" export ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" export ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>"

Schritt 3: Installieren und Ausführen

Schnellstart mit npx
npx -y @aashari/mcp-server-atlassian-confluence ls-spaces
Globale Installation
npm install -g @aashari/mcp-server-atlassian-confluence mcp-atlassian-confluence ls-spaces

Schritt 4: Mit dem AI Assistant verbinden

Konfigurieren Sie Ihren MCP-kompatiblen Client (z. B. Claude, Cursor AI):

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

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:

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

conf_get_space

Raumdetails abrufen:

{ "spaceKey": "DEV" }

conf_ls_pages

Seiten nach Bereich und Titel auflisten:

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

Seiten aus mehreren Bereichen auflisten:

{ "spaceKeys": ["DEV", "HR", "MARKETING"], "limit": 15, "sort": "-modified-date" }

conf_get_page

Seiteninhalt abrufen:

{ "pageId": "12345678" }

conf_ls_page_comments

Kommentare zur Listenseite:

{ "pageId": "12345678" }

Einfache Suche:

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

Erweiterte CQL-Suche:

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

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:

mcp-atlassian-confluence ls-spaces --type global --status current --limit 10

Schaffen Sie Platz

mcp-atlassian-confluence get-space --space-key DEV

Listenseiten

Durch mehrere Leertasten:

mcp-atlassian-confluence ls-pages --space-keys DEV HR MARKETING --limit 15 --sort "-modified-date"

Mit Titelfilter:

mcp-atlassian-confluence ls-pages --space-keys DEV --title "API Documentation" --status current

Seite abrufen

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

Listenseite Kommentare

mcp-atlassian-confluence ls-page-comments --page-id 12345678

Suchen

Einfache Suche:

mcp-atlassian-confluence search --query "security best practices" --space-key DOCS --type page --limit 5

CQL-Suche:

mcp-atlassian-confluence search --cql "label = official-docs AND creator = currentUser()"

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

# Confluence Spaces Showing **5** global spaces (current) | Key | Name | Description | |---|---|---| | [DEV](#) | Development | Engineering and development documentation | | [HR](#) | Human Resources | Employee policies and procedures | | [MARKETING](#) | Marketing | Brand guidelines and campaign materials | | [PRODUCT](#) | Product | Product specifications and roadmaps | | [SALES](#) | Sales | Sales processes and resources | *Retrieved from mycompany.atlassian.net on 2025-05-19 14:22 UTC* Use `cursor: "next-page-token-123"` to see more spaces.

Seiteninhaltsantwort

# API Authentication Guide **Space:** [DEV](#) (Development) **Created by:** Jane Smith on 2025-04-01 **Last updated:** John Doe on 2025-05-15 **Labels:** api, security, authentication ## Overview This document outlines the authentication approaches supported by our API platform. ## Authentication Methods ### OAuth 2.0 We support the following OAuth 2.0 flows: 1. **Authorization Code Flow** - For web applications 2. **Client Credentials Flow** - For server-to-server 3. **Implicit Flow** - For legacy clients only ### API Keys Static API keys are supported but discouraged for production use due to security limitations: | Key Type | Use Case | Expiration | |---|---|---| | Development | Testing | 30 days | | Production | Live systems | 90 days | ## Implementation Examples import requests def get_oauth_token(): return requests.post( 'https://api.example.com/oauth/token', data={ 'client_id': 'YOUR_CLIENT_ID', 'client_secret': 'YOUR_CLIENT_SECRET', 'grant_type': 'client_credentials' } ).json()['access_token'] *Retrieved from mycompany.atlassian.net on 2025-05-19 14:25 UTC*

Entwicklung

# Clone repository git clone https://github.com/aashari/mcp-server-atlassian-confluence.git cd mcp-server-atlassian-confluence # Install dependencies npm install # Run in development mode npm run dev:server # Run tests npm test

Beitragen

Beiträge sind willkommen! Bitte:

  1. Forken Sie das Repository.
  2. Erstellen Sie einen Feature-Zweig ( git checkout -b feature/xyz ).
  3. Änderungen festschreiben ( git commit -m "Add xyz feature" ).
  4. Pushen Sie zum Zweig ( git push origin feature/xyz ).
  5. Öffnen Sie eine Pull-Anfrage.

Weitere Einzelheiten finden Sie unter CONTRIBUTING.md .

Lizenz

ISC-Lizenz

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

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.

  1. Warum diesen Server verwenden?
    1. Was ist MCP?
      1. Voraussetzungen
        1. Aufstellen
          1. Schritt 1: Holen Sie sich Ihr Atlassian API-Token
          2. Schritt 2: Anmeldeinformationen konfigurieren
          3. Schritt 3: Installieren und Ausführen
          4. Schritt 4: Mit dem AI Assistant verbinden
        2. MCP-Tools
          1. conf_ls_spaces
          2. conf_get_space
          3. conf_ls_pages
          4. conf_get_page
          5. conf_ls_page_comments
          6. conf_search
        3. CLI-Befehle
          1. Räume auflisten
          2. Schaffen Sie Platz
          3. Listenseiten
          4. Seite abrufen
          5. Listenseite Kommentare
          6. Suchen
        4. Antwortformat
          1. Space List-Antwort
          2. Seiteninhaltsantwort
        5. Entwicklung
          1. Beitragen
            1. Lizenz

              Related MCP Servers

              • A
                security
                F
                license
                A
                quality
                A 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 -
                12
                947
                1
                JavaScript
                • Apple
              • A
                security
                A
                license
                A
                quality
                A 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 -
                9
                8
                TypeScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.
                Last updated -
                339
                6
                TypeScript
                • Apple
              • A
                security
                F
                license
                A
                quality
                A 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 -
                10
                1
                TypeScript

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/aashari/mcp-server-atlassian-confluence'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server