Confluence MCP

Ein Model Context Protocol (MCP)-Server für Confluence, der es KI-Assistenten ermöglicht, über eine standardisierte Schnittstelle mit Confluence-Inhalten zu interagieren.

ℹ️ Es gibt einen separaten MCP-Server für Jira

Merkmale

Authentifizieren Sie sich bei Confluence mit einem persönlichen API-Token
Abrufen und Durchsuchen von Confluence-Seiten und -Bereichen
Erstellen und Aktualisieren von Confluence-Inhalten
Abrufen und Hinzufügen von Kommentaren zu Seiten
Abrufen und Hinzufügen von Anhängen zu Seiten
Bereinigen und transformieren Sie Confluence-Inhalte für die KI-Nutzung
Behandeln Sie API-Kommunikation, Fehlerbehandlung und Datentransformation
Grundlegende Ratenbegrenzung zur Verhinderung von API-Missbrauch

Related MCP server: Atlassian Confluence MCP Server

Voraussetzungen

Bun (v1.0.0 oder höher)
Confluence-Konto mit API-Zugriff

Installation

# Clone the repository
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp

# Install dependencies
bun install

# Build the project
bun run build

Konfiguration

Um diesen MCP-Server zu verwenden, müssen Sie die folgenden Umgebungsvariablen festlegen:

CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_BASE_URL=your_confluence_instance_url  # e.g., https://your-domain.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=your_email

Claude Desktop / Cline-Konfiguration

Fügen Sie Ihrer Einstellungsdatei diese Konfiguration hinzu:

{
  "mcpServers": {
    "confluence": {
      "command": "bun",
      "args": ["/absolute/path/to/confluence-mcp/dist/index.js"],
      "env": {
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "CONFLUENCE_BASE_URL": "your_confluence_instance_url/wiki",
        "CONFLUENCE_USER_EMAIL": "your_email"
      }
    }
  }
}

Entwicklung

# Run in development mode
bun run dev

# Run tests
bun test

Verfügbare Tools

Der Confluence MCP-Server stellt die folgenden Tools bereit:

Seite abrufen

Ruft eine Confluence-Seite anhand ihrer ID ab. Format bezieht sich auf das Rückgabeformat des Inhalts und kann text oder markdown sein. Der Parameter includeMarkup ermöglicht das Abrufen des ursprünglichen Confluence Storage Format (XHTML)-Markups. Dies ist nützlich, um Seiten unter Beibehaltung der Formatierung zu aktualisieren.

{
  "pageId": "123456",
  "format": "text",
  "includeMarkup": true
}

Suchseiten

Suchen Sie mit CQL (Confluence Query Language) nach Confluence-Seiten. Format bezieht sich auf das Rückgabeformat des Inhalts und kann text oder markdown sein. Der Parameter includeMarkup ermöglicht das Abrufen des ursprünglichen Confluence Storage Format (XHTML)-Markups für jede Seite.

{
  "query": "space = DEV and label = documentation",
  "limit": 10,
  "format": "text",
  "includeMarkup": true
}

get_spaces

Listen Sie alle verfügbaren Confluence-Bereiche auf.

{
  "limit": 50
}

Seite erstellen

Erstellen Sie eine neue Confluence-Seite. Die parentId ist optional und kann verwendet werden, um eine untergeordnete Seite unter einer bestehenden Seite zu erstellen.

{
  "spaceKey": "DEV",
  "title": "New Page Title",
  "content": "<p>Page content in Confluence Storage Format (XHTML)</p>",
  "parentId": "123456"
}

Seite aktualisieren

Aktualisieren Sie eine vorhandene Confluence-Seite.

{
  "pageId": "123456",
  "title": "Updated Page Title",
  "content": "<p>Updated content in Confluence Storage Format (XHTML)</p>",
  "version": 1
}

Kommentare abrufen

Rufen Sie Kommentare für eine bestimmte Confluence-Seite ab. „Format“ bezieht sich auf das Rückgabeformat des Inhalts und kann text oder markdown sein.

{
  "pageId": "123456",
  "limit": 25,
  "format": "text"
}

Kommentar hinzufügen

Fügen Sie einer Confluence-Seite einen Kommentar hinzu. Die parentId ist für Thread-Antworten optional.

{
  "pageId": "123456",
  "content": "<p>This is a new comment.</p>",
  "parentId": "789012"
}

Anhänge abrufen

Rufen Sie Anhänge für eine bestimmte Confluence-Seite ab.

{
  "pageId": "123456",
  "limit": 25
}

Anhang hinzufügen

Fügen Sie einer Confluence-Seite einen Anhang hinzu. Der fileContentBase64 sollte die Base64-codierte Zeichenfolge des Dateiinhalts sein.

{
  "pageId": "123456",
  "filename": "document.pdf",
  "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...",
  "comment": "Uploaded new version of the document"
}