Confluence Cloud MCP服务器使用说明

项目简介

Confluence Cloud MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为AI助手提供与Atlassian Confluence Cloud集成的能力。通过此服务器，AI助手可以安全、标准地访问和操作Confluence中的知识内容，实现自动化工作流程和智能信息检索。

主要功能点

空间管理：
- 列出Confluence空间
- 获取空间详细信息
页面操作：
- 创建、读取、更新Confluence页面
- 列出空间中的页面
- 将Confluence存储格式的内容转换为Markdown格式
搜索与标签：
- 使用CQL (Confluence Query Language) 搜索内容
- 管理页面标签（获取、添加、移除）

安装步骤

此MCP服务器提供了多种安装方式，推荐使用Docker方式，操作简便快捷。

Docker安装 (推荐)

确保您的系统已安装 Docker。

复制粘贴以下命令到终端并执行，启动Confluence Cloud MCP服务器：

docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=您的Confluence API令牌 \
  -e CONFLUENCE_EMAIL=您的Confluence邮箱 \
  -e CONFLUENCE_DOMAIN=您的Confluence域名 \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest

请将命令中的 '您的Confluence API令牌'、'您的Confluence邮箱' 和 '您的Confluence域名' 替换为您的Confluence Cloud 账户的真实信息。

其他安装方式

您还可以选择本地构建或从源代码运行，详细步骤请参考仓库 README.md 文件。

服务器配置

为了让您的MCP客户端（如AI助手）连接到此Confluence Cloud MCP服务器，您需要在客户端的MCP服务器配置中添加以下JSON配置信息。请根据您的实际Confluence Cloud 账户信息修改 'env' 部分的参数。

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net", // ��的Confluence域名，例如：your-domain.atlassian.net
        "CONFLUENCE_EMAIL": "[email protected]",    // 您的Confluence账户邮箱
        "CONFLUENCE_API_TOKEN": "your-api-token"       // 您的Confluence API令牌
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置参数说明:

'server name': 'confluence' (服务器名称，客户端用以标识)
'command': 'docker' (启动服务器的命令，这里使用Docker)
'args': '["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"]' (Docker 运行参数，无需修改)
'env': 环境变量配置，包含Confluence Cloud 访问凭据:
- 'CONFLUENCE_DOMAIN': 您的Confluence Cloud 域名
- 'CONFLUENCE_EMAIL': 您的Confluence Cloud 账户邮箱
- 'CONFLUENCE_API_TOKEN': 您的Confluence Cloud API令牌 (请在Atlassian 账户设置中生成)

注意: 请务必替换配置中的占位符信息为您的真实Confluence Cloud 账户信息。API令牌请在Atlassian 账户的安全设置中创建。

基本使用方法

配置完成后，您的MCP客户端即可通过此服务器提供的工具与Confluence Cloud进行交互。客户端可以调用预定义的工具，例如 'list_confluence_spaces' (列出空间), 'get_confluence_page' (获取页面内容) 等，来执行相应的Confluence操作。

具体的工具列表和使用方法，请参考仓库 README.md 文件中 "Available Tools" 章节。

关键词