confluence-mcp

用浏览器已登录的会话 Cookie 给自建 Confluence (Server/DC) 搭的本地 MCP 服务。 不需要 API token、不需要 OAuth 应用、不需要管理员开通 —— 复用你浏览器里现成的登录态,读写搜索 Confluence 页面。

A local MCP server that drives self-hosted Confluence (Server/DC) using your browser's existing session cookie — no API token, no OAuth app, no admin onboarding required.

原理

浏览器登录后本地存有会话 Cookie(JSESSIONID + seraph.confluence)。本服务从浏览器 Cookie 库读出它们, 带着调用 Confluence 自带的 REST 接口。对服务端而言等同于"用户本人在操作"。

工具

| 工具 | 作用 | |---|---| | whoami | 确认当前认证身份 | | search | 关键词 / CQL 搜索 | | read_page / read_page_by_title | 读页面正文 | | create_page | 新建页面 | | update_page | 更新页面(自动版本 +1) |

快速开始

# 1. 探测 Cookie + 确认 REST 认证可用(详见 SOLUTION.md 第 2 节)
# 2. 注册进 Claude Code
claude mcp add confluence -s user \
  -e CONFLUENCE_HOST=confluence.your-company.com \
  -e CONFLUENCE_BROWSER=chrome \
  -- uv run --quiet /abs/path/to/server.py

claude mcp list   # confluence ... ✓ Connected

需要 uv;依赖由脚本头部 PEP 723 内联声明,uv run 自动安装。

配置

| 环境变量 | 默认 | 说明 | |---|---|---| | CONFLUENCE_HOST | pdconfluence.tp-link.com | 目标主机名 | | CONFLUENCE_BROWSER | chrome | chrome / edge / brave / safari / firefox |

完整方案与方法论

见 SOLUTION.md —— 包含 Cloud vs 自建的判断、"先验证再写代码"的步骤、踩坑清单、复刻 checklist。

适用性

• ✅ Confluence Server / Data Center(自建):Cookie 直连稳定。
• ⚠️ Confluence Cloud(*.atlassian.net):Cookie 直连被持续收紧,可能需退化为浏览器自动化。

安全边界

• 权限完全等于用户本人,不提权。
• Cookie 仅在本地读取、仅发往目标服务器,不经第三方。
• 写操作是真实写入;首次建议在个人空间试。

License

MIT