confluence-dc-advops-mcp

Local MCP helpers for Confluence Data Center used from Cursor.

Talks to the same proxy/auth as @atlassian-dc-mcp/confluence (CONFLUENCE_HOST=https://localhost:8443 + token from keychain). Prefer these tools over inventing raw curl to cnfl.upzero.net.

Auth

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

• CONFLUENCE_HOST (env or ~/.atlassian-dc-mcp/confluence.env)

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

Related MCP server: confluence-mcp-server

Tools

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

1. confluence_getStorageToFile → _tmp_….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: BSA заготовка → space template (Create from template)

BSA page = source of truth. Space template in TempStream = snapshot for «Создать из шаблона».

confluence_syncPageToSpaceTemplate
  contentId: "259706536"          # Заготовка CR-XXX-BRD
  spaceKey: "TempStream"
  templateId: "227016711"         # CR-XXX-BRD
  descriptionSuffix: "(синхрон с BSA 2.25: …)"   # 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": ["/Users/iljasorokin/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.