STARWARCLOUD STARWAR.AI
返回市场
MCP服务器-Atlassian-Confluence

MCP服务器-Atlassian-Confluence

作者：aashari39 星标更新：2025-11-20
安装使用来源：spider==github.com

项目介绍

将AI连接到您的Confluence知识库

通过将Claude、Cursor AI和其他AI助手直接连接到您的Confluence空间、页面和文档中，改变您访问和与团队知识互动的方式。从您的知识库中获得即时答案，跨所有空间搜索，并简化文档工作流程。

NPM 版本

您可以做什么

✅ 询问AI关于您的文档："我们的API认证过程是什么？"
✅ 跨所有空间搜索："找到所有关于安全最佳实践的页面"
✅ 获得即时答案："显示产品空间中的最新发布说明"
✅ 访问团队知识："我们远程工作的HR政策是什么？"
✅ 查看页面评论："显示架构文档上的讨论"
✅ 查找特定内容："搜索标题中含有'onboarding'的页面"

完美适用于

  • 开发者需要快速访问技术文档和API指南
  • 产品经理搜索需求、规格和项目更新
  • HR团队快速访问政策文件和员工资源
  • 支持团队查找故障排除指南和知识库文章
  • 任何人希望使用自然语言与Confluence进行交互

快速开始

在2分钟内启动并运行：

1. 获取您的Confluence凭证

生成一个Confluence API令牌：

  1. 前往 Atlassian API令牌
  2. 点击 创建API令牌
  3. 给它起个名字，如 "AI助手"
  4. 立即复制生成的令牌（您不会再看到它）

2. 即刻尝试

# 设置您的凭证
export ATLASSIAN_SITE_NAME="your-company"  # 对应 your-company.atlassian.net
export ATLASSIAN_USER_EMAIL="your.email@company.com"
export ATLASSIAN_API_TOKEN="your_copied_token"

# 列出您的Confluence空间
npx -y @aashari/mcp-server-atlassian-confluence ls-spaces

# 获取特定空间的详细信息
npx -y @aashari/mcp-server-atlassian-confluence get-space --space-key DEV

# 搜索页面
npx -y @aashari/mcp-server-atlassian-confluence search --query "API文档"

连接到AI助手

对于Claude桌面用户

在您的Claude配置文件 (~/.claude/claude_desktop_config.json) 中添加以下内容：

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

重启Claude桌面，您将在状态栏中看到"🔗 confluence"。

对于其他AI助手

大多数AI助手都支持MCP。全局安装服务器：

npm install -g @aashari/mcp-server-atlassian-confluence

然后配置您的AI助手以使用具有STDIO传输的MCP服务器。

可选：配置文件

创建 ~/.mcp/configs.json 用于系统范围的配置：

{
  "confluence": {
    "environments": {
      "ATLASSIAN_SITE_NAME": "your-company",
      "ATLASSIAN_USER_EMAIL": "your.email@company.com", 
      "ATLASSIAN_API_TOKEN": "your_api_token"
    }
  }
}

可选配置键：系统也接受 "atlassian-confluence"，"@aashari/mcp-server-atlassian-confluence" 或 "mcp-server-atlassian-confluence" 而不是 "confluence"。

实际案例

📚 探索您的知识库

询问您的AI助手：

  • "列出我们在Confluence中的所有空间"
  • "显示工程空间的详细信息"
  • "我们的产品空间有哪些页面？"
  • "找到市场营销空间中的最新页面"

🔍 搜索和查找信息

询问您的AI助手：

  • "搜索关于API认证的页面"
  • "找到标题中含有'security'的所有文档"
  • "显示带有'getting-started'标签的页面"
  • "搜索DEV空间中关于部署的内容"

📄 访问特定内容

询问您的AI助手：

  • "获取API认证指南页面的内容"
  • "显示入职检查清单文档"
  • "我们的安全策略页面包含什么内容？"
  • "显示最新的发布说明"

💬 查看讨论

询问您的AI助手：

  • "显示架构设计文档上的评论"
  • "新功能提案留下了哪些反馈？"
  • "显示API更改页面上的讨论"

🎯 高级搜索

询问您的AI助手：

  • "找到上个月John创建的所有页面"
  • "显示产品空间中的存档页面"
  • "搜索同时带有'API'和'tutorial'标签的页面"
  • "找到最近一周更新的文档"

故障排除

"身份验证失败"或"403禁止"

  1. 检查您的API令牌权限：

  2. 验证您的站点名称：

    # 测试您的凭证是否有效
npx -y @aashari/mcp-server-atlassian-confluence ls-spaces

  3. 检查您的站点名称格式：

    • 如果您的Confluence URL是 https://mycompany.atlassian.net
    • 您的站点名称应该是 mycompany

"未找到空间"或"未找到页面"

  1. 检查空间键拼写：

    # 列出您的空间以查看正确的键
npx -y @aashari/mcp-server-atlassian-confluence ls-spaces

  2. 验证访问权限：

    • 确保您在浏览器中有访问该空间的权限
    • 有些空间可能仅限某些用户访问

搜索时“未找到结果”

  1. 尝试更广泛的搜索词：

    • 使用单个关键词而不是完整的短语
    • 尝试不同版本的搜索词

  2. 检查空间权限：

    • 您只能搜索您有权查看的内容
    • 向管理员询问您是否有权访问特定空间

Claude桌面集成问题

  1. 更新配置文件后重启Claude桌面
  2. 检查状态栏是否有"🔗 confluence"指示器
  3. 验证配置文件位置：
    • macOS: ~/.claude/claude_desktop_config.json
    • Windows: %APPDATA%\\Claude\\claude_desktop_config.json

获取帮助

如果您仍然遇到问题：

  1. 运行一个简单的测试命令以验证一切正常
  2. 检查 GitHub问题 是否有类似的问题
  3. 创建一个新的问题，附带您的错误消息和设置详情

常见问题

我需要哪些权限？

您的Atlassian帐户需要：

  • 读取访问您想要搜索的Confluence空间
  • 具有适当权限的API令牌（创建时自动授予）

我能用这个工具连接到Confluence Server（本地部署）吗？

目前，此工具仅支持 Confluence Cloud。未来版本可能会增加对Confluence Server的支持。

如何找到我的站点名称？

您的站点名称是Confluence URL的第一部分：

  • URL: https://mycompany.atlassian.net → 站点名称: mycompany
  • URL: https://acme-corp.atlassian.net → 站点名称: acme-corp

这个工具可以与哪些AI助手一起使用？

任何支持模型上下文协议（MCP）的AI助手：

  • Claude桌面（最受欢迎）
  • Cursor AI
  • Continue.dev
  • 许多其他助手

我的数据安全吗？

是的！此工具：

  • 完全在您的本地机器上运行
  • 使用您自己的Confluence凭证
  • 从未将您的数据发送给第三方
  • 只访问您授权其访问的内容

我能在一次搜索中跨越所有空间吗？

是的！当您不指定空间时，搜索会在您有权访问的所有空间中进行。

支持

需要帮助？这是如何获得帮助的方法：

  1. 查看上面的故障排除部分 - 大多数常见问题都在那里解决
  2. 访问我们的GitHub存储库 以获取文档和示例：github.com/aashari/mcp-server-atlassian-confluence
  3. 报告问题 在 GitHub问题
  4. 发起讨论 提出功能请求或一般问题

由❤️制作，适用于希望将AI引入其知识管理流程的团队。