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.

NPM-Version Build-Status

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.

Related MCP server: Confluence MCP

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 :

{
	"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" }

`conf_search`

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:

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

ISC-Lizenz

Atlassian Confluence MCP Server

Atlassian Confluence MCP Server

Warum diesen Server verwenden?

Was ist MCP?

Voraussetzungen

Aufstellen

Schritt 1: Holen Sie sich Ihr Atlassian API-Token

Schritt 2: Anmeldeinformationen konfigurieren

Option A: MCP-Konfigurationsdatei (empfohlen)

Option B: Umgebungsvariablen

Schritt 3: Installieren und Ausführen

Schnellstart mit `npx`

Globale Installation

Schritt 4: Mit dem AI Assistant verbinden

MCP-Tools

`conf_ls_spaces`

`conf_get_space`

`conf_ls_pages`

`conf_get_page`

`conf_ls_page_comments`

`conf_search`

CLI-Befehle

Räume auflisten

Schaffen Sie Platz

Listenseiten

Seite abrufen

Listenseite Kommentare

Suchen

Antwortformat

Space List-Antwort

Seiteninhaltsantwort

Entwicklung

Beitragen

Lizenz

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

Atlassian Confluence MCP Server

Warum diesen Server verwenden?

Was ist MCP?

Voraussetzungen

Aufstellen

Schritt 1: Holen Sie sich Ihr Atlassian API-Token

Schritt 2: Anmeldeinformationen konfigurieren

Option A: MCP-Konfigurationsdatei (empfohlen)

Option B: Umgebungsvariablen

Schritt 3: Installieren und Ausführen

Schnellstart mit npx

Globale Installation

Schritt 4: Mit dem AI Assistant verbinden

MCP-Tools

conf_ls_spaces

conf_get_space

conf_ls_pages

conf_get_page

conf_ls_page_comments

conf_search

CLI-Befehle

Räume auflisten

Schaffen Sie Platz

Listenseiten

Seite abrufen

Listenseite Kommentare

Suchen

Antwortformat

Space List-Antwort

Seiteninhaltsantwort

Entwicklung

Beitragen

Lizenz

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

Schnellstart mit `npx`

`conf_ls_spaces`

`conf_get_space`

`conf_ls_pages`

`conf_get_page`

`conf_ls_page_comments`

`conf_search`