docs(bitbucket): document Cloud writeback

[sdolidze]

Closes: https://linear.app/lightdash/issue/SPK-1999

Summary

PR 5 of 5 for the Bitbucket writeback project. Documents the Bitbucket Cloud API token scopes and connection fields, then covers writeback from custom metrics and dimensions, SQL Runner, AI chat, and MCP.

Stacks on top of lightdash#28936, already merged and released, which completed SQL Runner writeback for Bitbucket Cloud.

Behavior

Atlassian API token
        ↓
Bitbucket project connection
        ↓
Explorer · SQL Runner · AI agent · MCP
        ↓
Bitbucket pull request → review and merge → sync Lightdash

The docs distinguish bitbucket.org from Server/Data Center, keep read-only token guidance intact, explain token-owner attribution, and state the current limits around previews, Pipelines, repository browsing, and in-chat merge support.

Screenshots

Test plan

• Walked the connection and SQL Runner instructions in Chrome DevTools against a disposable Bitbucket Cloud repository
• Opened a real pull request containing the generated SQL and YAML files
• Declined the test pull request, deleted its branch, and confirmed main was unchanged
• Rendered and inspected every changed page in the Mintlify preview
• node scripts/docs/validate.ts --changed-files ... — 0 errors
• mint broken-links — no broken links

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
lightdash	🟢 Ready	View Preview	Sep 9, 2026, 2:10 PM

[linear-code]

SPK-1999

[sdolidze]

• docs(bitbucket): document Cloud writeback #1232 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.