Confluence Cloud

io.github.aaronsb由 GitHub 帳號 aaronsb 發布v0.6.0更新於 Oct 24, 2026

MCP server for Confluence Cloud — page editing, navigation, and content management

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓助理讀取、搜尋、編輯與整理 Confluence Cloud 的頁面、空間、附件及頁面連結。

可以做什麼
取得、建立、更新、刪除、移動、複製頁面,或將頁面拉進編輯工作階段;工作階段式編輯只同步有變動的區塊,不會整頁重寫。使用 CQL、全文、標籤或貢獻者搜尋,並列出空間或檢視空間詳細資料。上傳、下載、列出或刪除頁面附件。走訪頁面階層,找出反向連結、正向連結與相關頁面。將多個操作批次排入佇列執行,支援結果參照與錯誤處理策略。
適用情境
適合讓助理在既有的 Confluence Cloud 知識庫中工作:草擬或修補文件、依標籤或貢獻者尋找頁面、調整頁面階層,或管理附件而不必手動複製貼上。
執行需求
透過 npm 套件以 npx 在本機執行,需要 Node.js。需要三個環境變數:CONFLUENCE_API_TOKEN(Atlassian API 權杖)、CONFLUENCE_EMAIL(Atlassian 帳號電子郵件)與 CONFLUENCE_HOST(Confluence 執行個體網址)。需要能連線至該 Confluence 執行個體及 Atlassian 服務的網路。
安裝前請注意
API 權杖可存取你的 Confluence 帳號,應妥善保管並盡量縮小權限範圍。伺服器可建立、更新、刪除、移動與複製頁面,也可刪除附件,助理的操作可能變更或刪除真實內容。頁面內容與中繼資料會傳送至所設定的 Confluence 執行個體及 Atlassian 服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Confluence Cloud,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Confluence Cloud MCP Server

A Model Context Protocol server for interacting with Confluence Cloud. Structured page editing with session-based change tracking, native macro support, and graph-based navigation.

Install

Claude Desktop (one-click)

Download confluence-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Confluence credentials.

Claude Code

bash
claude mcp add confluence-cloud -e CONFLUENCE_API_TOKEN=your-token -e CONFLUENCE_EMAIL=your-email -e CONFLUENCE_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/confluence-cloud-mcp

Manual (any MCP client)

json
{  "mcpServers": {    "confluence-cloud": {      "command": "npx",      "args": ["-y", "@aaronsb/confluence-cloud-mcp"],      "env": {        "CONFLUENCE_API_TOKEN": "your-api-token",        "CONFLUENCE_EMAIL": "your-email",        "CONFLUENCE_HOST": "https://your-team.atlassian.net"      }    }  }}

Credentials

Generate an API token at Atlassian Account Settings.

Tools

ToolDescription
manage_confluence_pageGet, create, update, delete, move, copy, or pull pages for editing
edit_confluence_contentStructural block editing within a tracked session — patch sections, append, replace, find/replace, sync
manage_confluence_spaceList spaces, get space details, or manage space configuration
search_confluenceSearch using CQL, full-text, labels, or contributors
manage_confluence_mediaUpload, download, list, or delete page attachments
navigate_confluenceTraverse page hierarchy, discover backlinks (via GraphQL), forward links, and related pages
queue_confluence_operationsBatch multiple operations with result references ($0.pageId) and error strategies

Each tool accepts an operation parameter (except queue_confluence_operations which takes an operations array). Per-tool documentation is available as MCP resources at confluence://tools/{tool_name}/documentation.

Key Features

Session-based editing — Pull a page into a tracked session, make surgical edits to individual blocks (sections, paragraphs, macros, tables), then sync only what changed. No full-page rewrites.

Native macro support — Status badges, info/warning/error panels, expand blocks, and table of contents render as readable :::directive syntax. The server handles ADF serialization with correct native node types.

GraphQL navigation — Backlinks and forward links use the Atlassian GraphQL gateway's link graph for accurate, fast relationship discovery. Falls back to REST when GraphQL is unavailable.

Rendering facades — Every response is token-efficient markdown with context-aware next-step hints. No raw JSON.

MCP Resources

ResourceDescription
confluence://macrosAvailable macro registry with parameter schemas and usage examples

Architecture

See docs/architecture/INDEX.md for the 8 ADRs covering the five-layer architecture, hybrid client, content model, session editing, macro handling, navigation, and rendering facades.

License

MIT License

來源:README.md,提交 821b467

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

2
  1. v0.6.0最新Sep 23, 2026
  2. v0.5.2Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分