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 → /path/to/page.xml

2. confluence_storage_listHeadings / getSection (format: text) — do not @ or Read the dump file into chat

3. confluence_storage_replaceSection or confluence_storage_replaceMacroBody (dryRun first if unsure)

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

5. Verify with user-confluence-dc / confluence_getContent bodyMode: text (limit chars)

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

7. Delete the temp file

These storage tools do not publish and do not return the full XML. Python/StrReplace on the dump is a fallback when they do not cover the case.

Do not round-trip the whole page through Markdown (macros/layout will not survive).

For tiny pages that are not templates, user-confluence-dc confluence_updateContent is still ok.

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
  # copyPageLabels: true by default — template labels come from the page

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.

Labels (pages + Create from template)

Confluence copies space-template labels onto pages created from that template. Put labels on the catalog page, then sync (or set them on the template). New pages from «Create from template» inherit them.

confluence_syncPageToSpaceTemplate copies the page’s global labels onto the template (copyPageLabels default true). If the page has none, current template labels are kept. Pass labels: [...] to set them explicitly. Create/update-from-file accept labels and copyLabelsFromContentId.

Page API: GET/POST /rest/api/content/{id}/label, DELETE …/label?name=. Template labels go in the experimental template PUT payload (omitting them can wipe labels on DC — tools always send a list unless you set keepLabels: false with no replacement).

Footer comments (page comments)

No inline comments. Put a quote from the page in the comment body so the subject is clear.

bodyFormat: plain (default — wrap in <p>, blank lines = paragraphs) or storage (raw Confluence storage XML).

Inline comments (read + reply only)

Does not create new text anchors. Use footer comments with a quote if you need a new note.

Each item includes status (open|resolved), visibleOnPage (true when open on the page), and originalSelection (anchored text when present).

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.