---

name: confluence-automation description: "通过 Rube MCP (Composio) 自动化 Confluence 页面创建、内容搜索、空间管理、标签和层级导航。始终先搜索工具获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Confluence 自动化

通过 Composio 的 Confluence 工具包自动化 Confluence 操作，包括页面创建和更新、使用 CQL 的内容搜索、空间管理、标签标记和页面层级导航。

前提条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit confluence 建立活跃的 Confluence 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可工作。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用 toolkit confluence 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE，按返回的认证链接完成 Confluence OAuth
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 创建和更新页面

何时使用：用户想要创建新文档或更新现有 Confluence 页面

工具序列：

1. CONFLUENCE_GET_SPACES - 列出空间以找到目标空间 ID [前提]
2. CONFLUENCE_SEARCH_CONTENT - 查找现有页面以避免重复或定位父页面 [可选]
3. CONFLUENCE_GET_PAGE_BY_ID - 更新前获取当前页面内容和版本号 [更新前提]
4. CONFLUENCE_CREATE_PAGE - 在空间中创建新页面 [创建必需]
5. CONFLUENCE_UPDATE_PAGE - 用新内容和递增版本更新现有页面 [更新必需]
6. CONFLUENCE_ADD_CONTENT_LABEL - 创建后为页面添加标签 [可选]

关键参数：

• spaceId：空间 ID 或键（如 "DOCS"、"12345678"）——空间键自动转换为 ID
• title：页面标题（在空间内必须唯一）
• parentId：创建子页面的父页面 ID；省略则放在空间首页下
• body.storage.value：Confluence 存储格式的 HTML/XHTML 内容
• body.storage.representation：创建操作必须为 "storage"
• version.number：更新时必须为当前版本 + 1
• version.message：可选的变更描述

陷阱：

• Confluence 强制每个空间内页面标题唯一；创建重复标题的页面会失败
• UPDATE_PAGE 要求 version.number 设为当前版本 + 1；始终先用 GET_PAGE_BY_ID 获取当前版本
• 内容必须是 Confluence 存储格式（XHTML），不是纯文本或 Markdown
• CREATE_PAGE 使用 body.storage.value 而 UPDATE_PAGE 使用 body.value 配合 body.representation
• GET_PAGE_BY_ID 需要数字长 ID，不是 UUID 或字符串

2. 搜索内容

何时使用：用户想要在 Confluence 中查找页面、博客文章或内容

工具序列：

1. CONFLUENCE_SEARCH_CONTENT - 带智能相关性排名的关键词搜索 [必需]
2. CONFLUENCE_CQL_SEARCH - 使用 Confluence 查询语言的高级搜索 [替代]
3. CONFLUENCE_GET_PAGE_BY_ID - 为选定搜索结果获取完整内容 [可选]
4. CONFLUENCE_GET_PAGES - 当搜索相关性弱时按日期浏览页面 [后备]

SEARCH_CONTENT 关键参数：

• query：与页面标题匹配的搜索文本，带智能排名
• spaceKey：限制搜索到特定空间
• limit：最大结果数（默认 25，最大 250）
• start：分页偏移（从 0 开始）

CQL_SEARCH 关键参数：

• cql：CQL 查询字符串（如 text ~ "API docs" AND space = DOCS AND type = page）
• expand：逗号分隔的属性（如 content.space、content.body.storage）
• excerpt：highlight、indexed 或 none
• limit：最大结果数（最大 250；使用 body 展开时减少到 25-50）

CQL 运算符和字段：

• 字段：text、title、label、space、type、creator、lastModified、created、ancestor
• 运算符：=、!=、~（包含）、!~、>、<、>=、<=、IN、NOT IN
• 函数：currentUser()、now("-7d")、now("-30d")
• 示例：title ~ "meeting" AND lastModified > now("-7d") ORDER BY lastModified DESC