confluence-dc-advops-mcp

Local MCP helpers for Confluence Data Center used from Cursor.

Русская документация: README.ru.md.

Talks to the same proxy/auth as @atlassian-dc-mcp/confluence (local TLS proxy + token from keychain / env). Prefer these tools over ad-hoc curl to the public Confluence hostname.

Auth

Same sources as @atlassian-dc-mcp/confluence:

• CONFLUENCE_HOST (env or ~/.atlassian-dc-mcp/confluence.env) — typically your local proxy, e.g. https://localhost:8443

• CONFLUENCE_API_TOKEN (env), or macOS Keychain service atlassian-dc-mcp / account confluence-token

Do not commit tokens or *.env files. See SECURITY.md.

Related MCP server: confluence-mcp-server

Tools

Fast path for large pages (BRD/SRS/…)

1. confluence_getStorageToFile → local ….xml

2. Surgical edit with Python/StrReplace on the file (preserve entities; do not re-escape)

3. confluence_updateStorageFromFile (omit version to auto-bump, or pass current+1)

4. Verify with user-confluence-dc / confluence_getContent bodyMode: text

5. If the page is also a Create-from-template snapshot → sync space template (below)

6. Delete the temp file

For small pages, keep using user-confluence-dc confluence_updateContent directly.

Fast path: page → space template (Create from template)

Catalog / BSA page = source of truth. Space template = snapshot for «Create from template».

confluence_syncPageToSpaceTemplate
  contentId: "<pageId>"
  spaceKey: "<spaceKey>"
  templateId: "<templateId>"
  descriptionSuffix: "(sync note)"   # optional

DC notes:

• List: /rest/experimental/template/page?spaceKey=…

• GET by template id alone often 404 — always pass spaceKey

• Update: PUT /rest/experimental/template with templateType: "page" and body.storage

• Delete: DELETE /rest/experimental/template/{id} — only via MCP delete tools after human confirmation (confirm: "DELETE" + exact confirmName / confirmNames). No trash restore.

Cursor config

"confluence-dc-advops": {
  "command": "node",
  "args": ["/path/to/confluence-dc-advops-mcp/index.js"],
  "env": {
    "CONFLUENCE_HOST": "https://localhost:8443",
    "NODE_TLS_REJECT_UNAUTHORIZED": "0"
  }
}

After changing index.js, reload MCP servers in Cursor so new tools appear.