Confluence MCP

Overview

Confluence MCP 是一个模型上下文协议服务器，允许 AI 代理与 Atlassian Confluence 进行交互。通过此 MCP 服务器，AI 可以搜索页面、读取内容、创建新页面、更新现有页面、管理空间（Spaces）和评论。这对于知识管理、文档协作和内容创作场景非常有用。

Confluence MCP 使得 AI 代理能够成为文档助手，自动创建和更新文档、搜索信息、总结内容、生成报告。它特别适合团队知识库管理、技术文档编写和项目文档自动化。

Features

• 页面搜索：搜索 Confluence 页面内容
• 页面读取：获取页面完整内容（包括 HTML 和存储格式）
• 页面创建：创建新页面，支持模板
• 页面更新：修改现有页面内容
• 空间管理：列出空间、获取空间详情
• 评论管理：添加、读取、更新评论
• 附件处理：上传和下载页面附件
• 版本历史：查看页面版本历史

Installation

# 使用 npx 运行
npx -y @modelcontextprotocol/server-confluence

# 或使用 uvx
uvx mcp-server-confluence

Configuration

添加以下配置到 claude_desktop_config.json：

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-confluence"],
      "env": {
        "CONFLUENCE_HOST": "https://your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Tool	Description
confluence_search	搜索 Confluence 页面
confluence_get_page	获取页面内容
confluence_create_page	创建新页面
confluence_update_page	更新页面内容
confluence_list_spaces	列出所有空间
confluence_get_comments	获取页面评论
confluence_add_comment	添加页面评论
confluence_get_attachments	获取页面附件列表

Usage Examples

示例 1：搜索文档

AI: 搜索所有关于"API 设计最佳实践"的页面

Confluence MCP:
- 执行搜索查询
- 返回匹配的页面列表和摘要

示例 2：创建技术文档

AI: 在"技术文档"空间创建一个新页面，标题为"微服务架构指南"，内容包含：
- 什么是微服务
- 微服务 vs 单体架构
- 设计原则
- 常见模式

Confluence MCP:
- 调用 confluence_create_page
- 设置 space, title, content (支持 Confluence 存储格式)
- 返回创建的页面链接

示例 3：更新文档

AI: 更新页面"项目计划"，在"时间表"部分添加新的里程碑

Confluence MCP:
- 获取当前页面内容
- 插入新内容
- 调用 confluence_update_page 保存

Pros

• ✅ 完整的 Confluence API 覆盖
• ✅ 支持 Confluence 存储格式（XHTML）
• ✅ 适合文档自动化
• ✅ 开源免费
• ✅ 与 Jira MCP 配合使用效果好

Cons

• ❌ 需要 Confluence 账户和 API 令牌
• ❌ 某些高级功能需要 Confluence Premium
• ❌ 内容格式转换可能需要额外处理

When to Use

• 需要 AI 辅助文档管理时
• 想要自动化创建和更新文档时
• 需要搜索知识库信息时
• 想要生成技术文档时

Resources

• GitHub 仓库
• Confluence API 文档