{"_id":"confluence-mcp-server","_rev":"7-d53f248d471d9311a396f89eed8151eb","name":"confluence-mcp-server","dist-tags":{"latest":"1.3.3"},"versions":{"1.0.0":{"name":"confluence-mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","confluence","atlassian","server","datacenter"],"author":{"name":"熊猫哥"},"license":"MIT","_id":"confluence-mcp-server@1.0.0","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"bin":{"confluence-mcp-server":"dist/index.js"},"dist":{"shasum":"25795651a7624b270767396ba067860cb8eb0cef","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.0.0.tgz","fileCount":18,"integrity":"sha512-8fMhurTSaSb5Q82vnjCC07arVIxC0zGFAaxypThBwyVx60cbCkvCxpegj1fuUalkTlIDVgKiSvB8nT8NueVfcA==","signatures":[{"sig":"MEUCIQCJcPy8SLNMSJeZ8zv6Ic/gmCGDiAw3AJsm5l7E6s7BWwIgd1XqEO3O9W//tRlLvxm+b6qRAA1saev/rFGcFICpgpo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46700},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"ad24fa240690e0fec0cb15816a674f3afd574dd8","scripts":{"build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"repository":{"url":"git+https://github.com/qihaze123/confluence-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"Confluence MCP server for search/read/update on Server/Data Center","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/confluence-mcp-server_1.0.0_1772075846445_0.5582254547075556","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"confluence-mcp-server","version":"1.1.0","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"author":{"name":"熊猫哥"},"license":"MIT","_id":"confluence-mcp-server@1.1.0","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"bin":{"confluence-mcp-server":"dist/index.js"},"dist":{"shasum":"525d97a74fc6c0f5b8c473cfb5607f6a5ce5e0eb","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.1.0.tgz","fileCount":18,"integrity":"sha512-AAtHTg2TlXN2NehCB90PXRjaMtOPHTYRV4dnzjGgRnVEiV3bI7zpdDJvrZsU1iQVlNapiUIer0as7AqSWbsq+w==","signatures":[{"sig":"MEUCIHtAJZuGoU5oHDcOpbtARmkdbjZ83Kv1tXLaiBzFbInBAiEAyPYZ4vgFXkEAcxgbmmQAm/CQVUpz2nlkGjOu1p+e1GI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69473},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"0b89dbe7d217ec1b500dff8cb491d6b4d93e384d","scripts":{"build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"repository":{"url":"git+https://github.com/qihaze123/confluence-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/confluence-mcp-server_1.1.0_1772084471145_0.7062161506946283","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"confluence-mcp-server","version":"1.2.0","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"author":{"name":"熊猫哥"},"license":"MIT","_id":"confluence-mcp-server@1.2.0","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"bin":{"confluence-mcp-server":"dist/index.js"},"dist":{"shasum":"7a6212e6739ddc5b4998612cbffa9bc4e4ab0b9e","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.2.0.tgz","fileCount":18,"integrity":"sha512-PMUEjgHvXCtvVYBNCyAO03vMTo3JAvk98HffEkBKQbpRLHe1Nl4bFZY6xHp+GjoS9yLYoS5+oH0Y6uozUJIkBg==","signatures":[{"sig":"MEYCIQDn4MGwqjYfIFBocpZPrptY97TGDEZLI2jFBp6UKCyVqQIhAPvseqHg1NtWl3R7EeD9jOFF36Sadtt4xdP7dL6TsW6v","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97177},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"e96d935b5f2c7a4a763c6053db49848611da09bf","scripts":{"build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"repository":{"url":"git+https://github.com/qihaze123/confluence-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/confluence-mcp-server_1.2.0_1776769658806_0.09706688507612515","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"confluence-mcp-server","version":"1.3.0","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"author":{"name":"熊猫哥"},"license":"MIT","_id":"confluence-mcp-server@1.3.0","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"bin":{"confluence-mcp-server":"dist/index.js"},"dist":{"shasum":"169de4adcc9a7b8044111d2568b6dd9b9f260b2b","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.3.0.tgz","fileCount":18,"integrity":"sha512-Mf6llBYA0+h9yQSRfPnoDZr+c9FNSijiNMnhd0qvGu9QqOgMkA+9x/m2qmkQttGIzidukgl0wxLRHOBpQRaEgA==","signatures":[{"sig":"MEUCIQC5cM682msDDMrItTyaRRmd31Zim2aklDuEojnIV7QafQIgP04wwl07Jn4Z0EJajM3EjLODZGYJukFuzHcYKwXt1oY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":187448},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"93b2d7be5c27b6871c14cb2986a39fbadbfe87d5","scripts":{"build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"repository":{"url":"git+https://github.com/qihaze123/confluence-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/confluence-mcp-server_1.3.0_1777000553079_0.7189727354124378","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"confluence-mcp-server","version":"1.3.1","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"author":{"name":"熊猫哥"},"license":"MIT","_id":"confluence-mcp-server@1.3.1","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"bin":{"confluence-mcp-server":"dist/index.js"},"dist":{"shasum":"3d05b7763bf531d81805c3622a2003b863ee33a2","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.3.1.tgz","fileCount":18,"integrity":"sha512-pAgpJ6/jWxzLImD3jDGy6LSxX2rMy1FRRLn2cD/dM2eWO3UVI2xdCsnukePoLo9Fgd9fYejmVzwOj2OhvwaVDg==","signatures":[{"sig":"MEYCIQC1hqhSSVTt69vm2Ox+Y223qH86OOFW6jxCl17y+w9byAIhANZV9+DyvKNU/8VdpAnOzfrohvIuMzZPBkd4Hue8aZzD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":237848},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"93b2d7be5c27b6871c14cb2986a39fbadbfe87d5","scripts":{"build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"repository":{"url":"git+https://github.com/qihaze123/confluence-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/confluence-mcp-server_1.3.1_1779083732481_0.604945751905956","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"confluence-mcp-server","version":"1.3.2","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"author":{"name":"熊猫哥"},"license":"MIT","_id":"confluence-mcp-server@1.3.2","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"bin":{"confluence-mcp-server":"dist/index.js"},"dist":{"shasum":"c1e1226efca8e137e566651d33c10c9d3d0ff903","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.3.2.tgz","fileCount":18,"integrity":"sha512-7zxteYVMlOh8J+FPT+BwI7hwVkxxuhZkSJYU0JGnNzCc0TJrTf19qpa6Kz171NTF+bxgrDcYOkBeT3iPO68PRg==","signatures":[{"sig":"MEUCIHvrXwm1+daHGddiahY38yxYT+MJvk751HyJfawfNpYcAiEA3dZvTLVzMdF4UboxVi37TMNas9Zw4OOHbfPG9N17kvk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":259867},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7dad32a764f68cab67d068c28ab11921483625ae","scripts":{"build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"repository":{"url":"git+https://github.com/qihaze123/confluence-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/confluence-mcp-server_1.3.2_1781231750269_0.4161430357946114","host":"s3://npm-registry-packages-npm-production"}},"1.3.3":{"name":"confluence-mcp-server","version":"1.3.3","description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","license":"MIT","author":{"name":"熊猫哥"},"type":"module","main":"dist/index.js","bin":{"confluence-mcp-server":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/qihaze123/confluence-mcp-server.git"},"bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"engines":{"node":">=18"},"scripts":{"build":"tsc","prepare":"npm run build","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"_id":"confluence-mcp-server@1.3.3","gitHead":"96f47730d7f3ece090b853300deb69261bf3eb6c","types":"./dist/index.d.ts","_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-hP8e4m94kj+P8c9dKW7Az59ZcALE5ftI1DeEDyXJVHeGIMBBScnCqJIyDr/G7UuWhBnC770L87kNs/1icl05iQ==","shasum":"b268de8cc214945b37c40b49c2771313e6fa92dd","tarball":"https://registry.npmjs.org/confluence-mcp-server/-/confluence-mcp-server-1.3.3.tgz","fileCount":18,"unpackedSize":262758,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBFHCjI+4jygp89oL9v89368Y1R7wVGm7dHoL7VFqMn9AiA+qABFCMwAR0y+9rPfwjTDPX5eHg5rrhPMXmfF03F7jQ=="}]},"_npmUser":{"name":"qihaze","email":"qihaze99@gmail.com"},"directories":{},"maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/confluence-mcp-server_1.3.3_1781233044902_0.8835439618116925"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-26T03:17:26.364Z","modified":"2026-06-12T02:57:25.171Z","1.0.0":"2026-02-26T03:17:26.626Z","1.1.0":"2026-02-26T05:41:11.289Z","1.2.0":"2026-04-21T11:07:38.943Z","1.3.0":"2026-04-24T03:15:53.228Z","1.3.1":"2026-05-18T05:55:32.811Z","1.3.2":"2026-06-12T02:35:50.413Z","1.3.3":"2026-06-12T02:57:25.050Z"},"bugs":{"url":"https://github.com/qihaze123/confluence-mcp-server/issues"},"author":{"name":"熊猫哥"},"license":"MIT","homepage":"https://github.com/qihaze123/confluence-mcp-server#readme","keywords":["mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter"],"repository":{"type":"git","url":"git+https://github.com/qihaze123/confluence-mcp-server.git"},"description":"Confluence MCP server for Cloud/Server/Data Center search/read/create/update","maintainers":[{"name":"qihaze","email":"qihaze99@gmail.com"}],"readme":"# confluence-mcp-server\n\n一个面向 Confluence Cloud / Server / Data Center 的 MCP 服务，提供页面搜索、CQL 查询、读取、创建、更新、附件上传和用户身份查询能力。\n\n## 功能\n\n- `confluence_search_pages`: 按关键词搜索页面\n- `confluence_execute_cql_search`: 执行原生 CQL 查询\n- `confluence_get_page`: 按页面 ID 获取内容（storage 格式）\n- `confluence_get_page_outline`: 获取页面标题目录，适合低 token 导航\n- `confluence_get_page_section`: 按标题读取单个 section，避免把整页正文返回给模型\n- `confluence_get_page_anchor_block`: 按 Anchor 起止边界读取块内容\n- `confluence_create_page`: 创建页面（支持可选 `parentId`）\n- `confluence_update_page`: 更新页面内容并自动递增版本\n- `confluence_update_page_section`: 按标题更新单个 section，由 MCP 服务端完成整页替换与提交\n- `confluence_preview_page_section_update`: 预览按标题更新的命中范围，返回旧内容和确认 hash\n- `confluence_update_page_section_confirmed`: 带 hash 确认提交按标题更新，避免 preview 后内容已变化\n- `confluence_add_anchor_block_to_section`: 给一个标题 section 自动加上起止 Anchor，便于后续稳定更新\n- `confluence_preview_page_anchor_block_update`: 预览按 Anchor 范围更新的命中块，返回旧内容和确认 hash\n- `confluence_update_page_anchor_block_confirmed`: 带 hash 确认提交 Anchor 范围更新\n- `confluence_stage_page_update`: 暂存整页改动到 MCP 服务端内存，不提交到 Confluence\n- `confluence_stage_page_section_update`: 暂存标题 section 改动到 MCP 服务端内存，不提交到 Confluence\n- `confluence_stage_page_anchor_block_update`: 暂存 Anchor 块改动到 MCP 服务端内存，不提交到 Confluence\n- `confluence_list_pending_page_updates`: 列出当前 MCP 进程里的未提交 wiki 改动\n- `confluence_get_pending_page_update`: 查看某个未提交改动的 old/new/diff 内容\n- `confluence_commit_pending_page_update`: 校验 hash 后把某个未提交改动真正提交到 Confluence\n- `confluence_discard_pending_page_update`: 丢弃某个未提交改动\n- `confluence_upload_attachment`: 上传页面附件（支持本地文件路径或 base64，同名附件默认更新为新版本）\n- `confluence_get_current_user`: 获取当前认证用户（whoami）\n\n## 环境要求\n\n- Node.js 18+\n- 可访问的 Confluence Cloud / Server / Data Center\n\n## 快速开始\n\n```bash\nnpm install\nnpm run build\nnpm start\n```\n\n## 通过 npx 使用（推荐）\n\n发布到 npm 后，可在 MCP 客户端中直接使用 `npx` 启动，无需手动克隆仓库：\n\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"confluence-mcp-server\"],\n      \"env\": {\n        \"CONF_MODE\": \"server\",\n        \"CONF_BASE_URL\": \"https://confluence.example.com\",\n        \"CONF_USERNAME\": \"your-username\",\n        \"CONF_TOKEN\": \"your-token\",\n        \"CONF_DEFAULT_SPACE\": \"DOC\"\n      }\n    }\n  }\n}\n```\n\n也可以不在客户端配置里写连接信息，先只启动 MCP 服务：\n\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"confluence-mcp-server\"]\n    }\n  }\n}\n```\n\n然后在对话里提供连接参数，让模型先调用 `confluence_configure_connection`：\n\n```json\n{\n  \"baseUrl\": \"https://confluence.example.com\",\n  \"mode\": \"server\",\n  \"authMode\": \"auto\",\n  \"username\": \"your-username\",\n  \"token\": \"your-token\",\n  \"defaultSpace\": \"DOC\"\n}\n```\n\n该配置只保存在当前 MCP 服务进程内存中，重启后会丢失。长期使用仍建议放在 MCP 客户端的环境变量配置里，避免在对话上下文中暴露密钥。\n\n如果当前进程已经有连接（例如通过环境变量连到了旧地址），也可以只切换部分字段。比如只把地址从一台 Confluence 切到另一台、账号密码不变：\n\n```json\n{\n  \"baseUrl\": \"http://192.168.40.82:8090\"\n}\n```\n\n未传的 `mode`、认证信息和 `defaultSpace` 会继承当前连接；如果显式传入 `token` / `password` / `username` / `authMode`，则会重新计算认证。\n\n## 环境变量\n\n- `CONF_BASE_URL`: Confluence 基础地址，例如 `https://confluence.example.com`\n- `CONF_MODE`: 部署模式，`cloud` 或 `server`（默认 `server`）\n- `CONF_AUTH_MODE`: 认证模式，`auto` / `basic` / `bearer`（默认 `auto`）\n- `CONF_USERNAME`: 登录用户名（Cloud 必填；Server 在 `basic` 模式或使用密码时必填）\n- `CONF_PASSWORD`: 用户密码（与 `CONF_TOKEN` 组合按模式使用）\n- `CONF_TOKEN`: 访问令牌（Cloud 下作为 API Token；Server 下默认走 Bearer）\n- `CONF_DEFAULT_SPACE`: 默认空间 Key（可选）\n\n如果未设置这些环境变量，服务会以“未配置连接”的状态启动；此时先调用 `confluence_configure_connection` 即可。可用 `confluence_get_connection_status` 查看当前连接状态，该工具不会返回 token/password。\n\n## MCP 客户端配置示例\n\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"node\",\n      \"args\": [\"dist/index.js\"],\n      \"env\": {\n        \"CONF_MODE\": \"server\",\n        \"CONF_BASE_URL\": \"https://confluence.example.com\",\n        \"CONF_USERNAME\": \"your-username\",\n        \"CONF_TOKEN\": \"your-token\",\n        \"CONF_DEFAULT_SPACE\": \"DOC\"\n      }\n    }\n  }\n}\n```\n\n## 说明\n\n- 该项目当前聚焦 Confluence 能力，不包含 Jira 工具。\n- Cloud 模式固定使用 Basic（`CONF_USERNAME` + `CONF_TOKEN/CONF_PASSWORD`）。\n- Server 模式可用 Bearer 或 Basic（`CONF_AUTH_MODE=auto` 时优先 Bearer）。\n- Cloud 模式 API 基础路径为 `/wiki/rest/api`，Server 模式为 `/rest/api`。\n- 上传图片后，`confluence_upload_attachment` 会返回 `storageImageMarkup`，可把它拼到 `confluence_update_page` 的 `bodyStorageValue` 中展示图片。\n- Confluence 原生更新仍是整页版本化 `PUT`；`confluence_update_page_section` 只是把“整页读取 + 局部替换 + 整页提交”放在 MCP 服务端完成，从而显著减少模型侧 tokens。\n- 两阶段更新不会减少 Confluence 侧请求次数，但会显著降低误改风险：preview 返回旧内容和 `expectedCurrentHash`，confirmed update 会重新拉取页面并校验 hash 一致后才提交。\n- 暂存更新工具会把改动保存在当前 MCP 服务端进程内存中，不会调用 Confluence `PUT`；重启 MCP 服务后这些未提交草稿会丢失。\n- Anchor 模式使用 Confluence Anchor 宏作为隐形边界，适合长期自动维护固定区域；普通阅读模式下通常不会显示这些锚点。\n\n## 低 Token 推荐流程\n\n1. 先用 `confluence_search_pages` 或 `confluence_execute_cql_search` 定位页面。\n2. 再用 `confluence_get_page_outline` 获取标题目录，不直接读整页正文。\n3. 用 `confluence_get_page_section` 按 `heading` 拉取需要处理的 section。\n4. 修改完成后，用 `confluence_update_page_section` 只提交该 section 的 storage 内容。\n\n如果页面里存在重复标题，可以配合 `occurrence` 指定第几个同名标题；`matchMode=contains` 可用于模糊匹配标题。\n\n## 更安全的两阶段更新\n\n1. 先调用 `confluence_preview_page_section_update`。\n2. 检查返回的 `oldStorageValue` 和 `newStorageValue` 是否符合预期。\n3. 把返回的 `expectedCurrentHash` 原样传给 `confluence_update_page_section_confirmed`。\n4. 服务端会重新拉取页面并校验 hash，一致才真正提交更新。\n\n\n## 未提交改动流程\n\n如果希望 AI 先改 wiki、你检查后再决定是否真正保存，可以使用暂存工具：\n\n1. 用 `confluence_stage_page_section_update`、`confluence_stage_page_anchor_block_update` 或 `confluence_stage_page_update` 创建未提交草稿。\n2. 检查返回的 `oldStorageValue`、`newStorageValue`、`diffStorageValue` 和 `draftId`。\n3. 需要稍后查看时，用 `confluence_list_pending_page_updates` 或 `confluence_get_pending_page_update`。\n4. 确认保存时，用 `confluence_commit_pending_page_update` 提交；服务端会重新拉取页面并校验 `expectedCurrentHash`，一致才写入 Confluence。\n5. 不想保存时，用 `confluence_discard_pending_page_update` 丢弃。\n\n这些草稿只存在于当前 MCP 服务端内存，不会出现在 Confluence 页面历史里，也不会跨服务重启持久化。\n\n## 更稳定的 Anchor 更新\n\n1. 先用 `confluence_add_anchor_block_to_section` 给目标 section 加上 `startAnchor` / `endAnchor`。\n2. 后续读取时用 `confluence_get_page_anchor_block`。\n3. 更新时先用 `confluence_preview_page_anchor_block_update`，确认后再调用 `confluence_update_page_anchor_block_confirmed`。\n\nAnchor 名称建议使用业务语义化命名，例如 `risk-summary-start`、`risk-summary-end`，避免依赖标题文本本身。\n","readmeFilename":"README.md"}