Atlassian Confluence MCP Server

基本能力

产品定位

Atlassian Confluence MCP Server 旨在通过 MCP 协议为 AI 助手提供与 Confluence 实例的安全、实时交互能力，从而增强 AI 在文档搜索、摘要、分析和引用方面的能力。

核心功能

• 实时访问：AI 助手可以直接访问最新的 Confluence 内容。
• 消除复制/粘贴：无需手动在 Confluence 和 AI 助手之间传输信息。
• 增强 AI 能力：支持 AI 搜索、总结、分析和引用 Confluence 文档。
• 安全性：通过 API 令牌控制访问，敏感操作通过服务器进行。

适用场景

• AI 助手需要实时访问 Confluence 文档的场景。
• 需要自动化搜索、总结或分析 Confluence 内容的场景。
• 需要将 Confluence 内容集成到 AI 工作流中的场景。

工具列表

1. List Spaces (list-spaces)：列出可用的 Confluence 空间及其唯一标识符。
2. Get Space (get-space)：获取特定空间的详细信息，包括主页内容片段。
3. List Pages (list-pages)：列出特定空间或整个实例中的页面，支持过滤。
4. Get Page (get-page)：获取特定页面的完整内容（Markdown 格式）和元数据。
5. Search (search)：使用 CQL (Confluence Query Language) 进行高级搜索。

常见问题解答

• 如何获取 API 令牌？：通过 Atlassian API 令牌管理页面创建并复制令牌。
• 如何配置服务器？：可以通过全局 MCP 配置文件或环境变量设置。
• 如何验证连接？：在 AI 助手的工具列表中查看 Confluence 工具是否可用。

使用教程

使用依赖

• Node.js 和 npm：确保已安装 Node.js（包含 npm）。
• Atlassian 账户：需要有效的 Atlassian 账户并有权访问 Confluence 实例。

安装教程

1. 获取 Atlassian API 令牌： bash # 访问 https://id.atlassian.com/manage-profile/security/api-tokens 创建令牌
2. 配置服务器凭证：
3. 方法 A：全局 MCP 配置文件： bash # 创建配置文件 mkdir -p ~/.mcp/ echo '{ "@aashari/mcp-server-atlassian-confluence": { "environments": { "ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>", "ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>", "ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>" } } }' > ~/.mcp/configs.json
4. 方法 B：环境变量： bash ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" \ ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" \ ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" \ npx -y @aashari/mcp-server-atlassian-confluence
5. 连接 AI 助手：
6. Claude Desktop：在设置中添加 MCP 服务器配置。
7. Cursor AI：通过命令面板添加 MCP 服务器。

调试方式

1. 验证工具列表：在 AI 助手的工具列表中查看 Confluence 工具是否可用。
2. 测试命令： bash # 列出空间 npx -y @aashari/mcp-server-atlassian-confluence list-spaces # 获取页面内容 npx -y @aashari/mcp-server-atlassian-confluence get-page --page 123456 # 搜索内容 npx -y @aashari/mcp-server-atlassian-confluence search --cql "type=page AND text~API" --limit 10

全局安装

1. 安装： bash npm install -g @aashari/mcp-server-atlassian-confluence
2. 验证安装： bash mcp-atlassian-confluence --version
3. 使用命令： bash # 列出空间 mcp-atlassian-confluence list-spaces # 获取空间详情 mcp-atlassian-confluence get-space --space DEV # 搜索内容 mcp-atlassian-confluence search --cql "type=page AND text~API" --limit 10

许可证

该项目遵循 ISC 开源许可条款。