Confluence Cloud

io.github.aaronsb由 GitHub 账号 aaronsb 发布v0.6.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面效率与工作流文件与存储知识与记忆

概览

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 分