关于 Confluence Cloud
面向 Confluence Cloud 的 MCP 服务，可管理页面、空间、附件并浏览内容关系。它以会话跟踪区块级编辑，并支持原生宏，避免重写整页。
主要功能
- 01管理页面和空间
- 02编辑会话跟踪的内容区块
- 03处理原生宏
- 04搜索并管理附件
- 05浏览链接和页面层级
- 06通过引用批量执行操作
适用场景
- 01只更新指定章节而不重写整页
- 02按文本、标签或贡献者查找页面
- 03追踪反向链接和相关页面
- 04批量运行存在依赖的 Confluence 操作
MCP 相关
向 MCP 客户端提供页面、内容、空间、媒体、搜索、导航和批量操作工具。工具文档和宏注册表也作为 MCP 资源提供。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @aaronsb/confluence-cloud-mcpCONFLUENCE_API_TOKEN密钥Confluence API token (generate at https://id.atlassian.com/manage/api-tokens)CONFLUENCE_EMAILAtlassian account email addressCONFLUENCE_HOSTConfluence instance URL (e.g., https://your-team.atlassian.net)本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。
工具
8收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| body | string | 否 | 评论文本，使用 Markdown 格式（用于 add_comment）。通过与页面内容相同的指令解析器进行渲染。 |
| label | string | 否 | 要移除的标签（用于 remove_label 操作） |
| title | string | 否 | 页面标题（create 时必填，update 时可选） |
| expand | array | 否 | 要包含在响应中的附加数据 |
| labels | array | 否 | 要添加的标签（用于 add_labels 操作） |
| pageId | string | 否 | 页面 ID（get、update、delete、move、copy、get_versions、pull_for_editing、get_comments、add_comment、archive、archive_tree、unarchive 必填） |
| spaceId | string | 否 | 空间 ID（create 必填；list_archived 可用） |
| parentId | string | 否 | 父页面 ID（create 时可选，move 时必填，copy 时可选） |
| spaceKey | string | 否 | 空间键（用于 list_archived） |
| operation | enum | 是 | 要执行的操作get | create | update | delete | move | copy | get_versions | pull_for_editing | get_comments | add_comment | get_labels | add_labels | remove_label | get_properties | get_property | set_property | delete_property | archive | archive_tree | unarchive | list_archived |
| propertyKey | string | 否 | 内容属性键（用于 get_property、set_property、delete_property） |
| propertyValue | object | 否 | 作为 JSON 对象的内容属性值（用于 set_property） |
| parentCommentId | string | 否 | 要回复的评论 ID（add_comment 时可选）。ID 来自 get_comments；对行内评论的回复会显示在线程中。 |
详细介绍
Confluence Cloud MCP 服务
用于与 Confluence Cloud 交互的 Model Context Protocol 服务。支持结构化页面编辑、基于会话的变更跟踪、原生宏，以及基于图的导航。
安装
Claude Desktop（一键安装）
下载 confluence-cloud-mcp.mcpb 并打开，Claude Desktop 将提示你输入 Confluence 凭据。
Claude Code
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
手动安装（适用于任何 MCP 客户端）
{
"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"
}
}
}
}
凭据
在 Atlassian Account Settings 中生成 API 令牌。
工具
| 工具 | 描述 |
|---|---|
manage_confluence_page | 获取、创建、更新、删除、移动、复制页面，或拉取页面以供编辑 |
edit_confluence_content | 在跟踪会话中进行结构化块编辑——修补章节、追加、替换、查找/替换、同步 |
manage_confluence_space | 列出空间、获取空间详情，或管理空间配置 |
search_confluence | 使用 CQL、全文、标签或贡献者进行搜索 |
manage_confluence_media | 上传、下载、列出或删除页面附件 |
navigate_confluence | 遍历页面层级、发现反向链接（通过 GraphQL）、正向链接和相关页面 |
queue_confluence_operations | 批量执行多个操作，并使用结果引用（$0.pageId）和错误处理策略 |
每个工具都接受 operation 参数（queue_confluence_operations 除外，它接受 operations 数组）。各工具的文档可通过 MCP 资源 confluence://tools/{tool_name}/documentation 获取。
主要功能
基于会话的编辑——将页面拉取到受跟踪的会话中，对单个块（章节、段落、宏、表格）进行精细编辑，然后仅同步发生变化的内容。无需重写整页。
原生宏支持——状态徽章、信息/警告/错误面板、展开块和目录会以易读的 :::directive 语法呈现。服务会使用正确的原生节点类型处理 ADF 序列化。
GraphQL 导航——反向链接和正向链接使用 Atlassian GraphQL 网关的链接图，实现准确、快速的关系发现。GraphQL 不可用时会回退到 REST。
渲染外观层——每个响应都是节省令牌的 Markdown，并提供结合上下文的后续步骤提示。不返回原始 JSON。
MCP 资源
| 资源 | 描述 |
|---|---|
confluence://macros | 可用宏注册表，包含参数架构和使用示例 |
架构
有关涵盖五层架构、混合客户端、内容模型、会话编辑、宏处理、导航和渲染外观层的 8 份 ADR，请参阅 docs/architecture/INDEX.md。
许可证
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。