Skip to content

MCP GA docs cleanup [DOCS-13510]#34721

Open
sumedham wants to merge 12 commits intomasterfrom
sumedha/mcp-ga
Open

MCP GA docs cleanup [DOCS-13510]#34721
sumedham wants to merge 12 commits intomasterfrom
sumedha/mcp-ga

Conversation

@sumedham
Copy link
Contributor

@sumedham sumedham commented Feb 19, 2026 •
edited
Loading

  • Added tabs for different clients
  • Cleaned up preview callouts
  • Cleaned up HIPAA, GovCloud Requirements
  • Changed URL Hyperlinks for tabbing
  • Changed required permissions for MCP server from INcident Management to MCP Read/Write
  • This PR does not include the dynamic sites (that should come next or in a different pr)

@cursoragent
Make MCP Server docs use dynamic region URLs
f487ecb 
- Add mcp_server_endpoint to regions.config.js for all supported sites
- Replace hardcoded MCP URLs in setup.md with region-param shortcodes
- Replace hardcoded MCP URLs in bits_ai/mcp_server/_index.md Toolsets section
- Endpoint and examples now update based on docs site selector (US1, US3, EU1, etc.)

Co-authored-by: Cursor <cursoragent@cursor.com>
@sumedham sumedham requested review from a team as code owners February 19, 2026 21:23
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Feb 19, 2026
@joepeeples joepeeples added the editorial review Waiting on a more in-depth review label Feb 19, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 19, 2026

Preview links (active after the build_preview check completes)

Modified Files

@joepeeples
Copy link
Contributor

joepeeples commented Feb 19, 2026 •
edited by atlassian bot
Loading

Opened DOCS-13456 to follow up with in-depth review.

@joepeeples joepeeples self-assigned this Feb 19, 2026
sumedham and others added 3 commits February 19, 2026 16:49
@sumedham
Merge branch 'master' into sumedha/mcp-ga
5278fda
@cursoragent
Restructure MCP setup with client-based tab switcher
931ad5e 
- Add tabs: Cursor, Claude Code, Claude Desktop, Codex, VS Code, Other
- Organize instructions per client using existing doc content
- Other tab: Goose, Kiro, Kiro CLI, Cline with remote + local binary options
- Fix invalid region-param keys; keep shared Authentication and Test access sections

Co-authored-by: Cursor <cursoragent@cursor.com>
@cursoragent
Revert dynamic region URLs; use static MCP URLs for now
7b31d53 
- Remove mcp_server_endpoint from regions.config.js
- Restore static endpoint table and URLs in setup.md
- Restore static toolset URLs in _index.md
Dynamic region URLs will be reintroduced in a separate PR.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions github-actions bot removed the Architecture Everything related to the Doc backend label Feb 19, 2026
Sumedha Mehta and others added 3 commits February 19, 2026 19:29
@cursoragent
Add client tab switcher to MCP setup; reorganize by client
ead369c 
- Move client tab switcher to top of setup page (Cursor, Claude Code, Claude Desktop, Codex, VS Code, Other)
- Reformat instructions per client using existing content
- Consolidate Other tab for Goose, Kiro, Kiro CLI, Cline with remote and local binary auth
- Add Supported clients reference table below tabs

Co-authored-by: Cursor <cursoragent@cursor.com>
@sumedham
Merge branch 'master' into sumedha/mcp-ga
971d684
@cursoragent
Fix hyperlink rendering: use inline links in all tabs and sections
3acc36b 
- Convert all reference-style links to inline in Cursor, Claude Code, Claude Desktop, Codex, VS Code, and Other tabs
- Update Supported clients table, Authentication, and Test access sections
- Remove unused link reference definitions
- Fixes links not rendering correctly inside tab shortcode

Co-authored-by: Cursor <cursoragent@cursor.com>
@sumedham sumedham changed the title Make MCP Server docs use dynamic region URLs MCP GA docs cleanup Feb 20, 2026
Sumedha Mehta and others added 2 commits February 20, 2026 09:06
@cursoragent
Use reference-style links only below tabs; keep inline links in tab c…
9381698 
…ontent

- Restore [x] reference links in Supported clients, Authentication, and Test access sections
- Add URL definitions at bottom of file for refs used below tabs
- Tab content remains inline for correct rendering in shortcode

Co-authored-by: Cursor <cursoragent@cursor.com>
@cursoragent
Remove Supported clients table; add endpoint table to Codex tab
e9fe69c 
- Remove Supported clients section below tabs
- Replace 'See endpoint table in Claude Code tab' with full endpoint table in Codex tab

Co-authored-by: Cursor <cursoragent@cursor.com>
rgwood-dd
rgwood-dd approved these changes Feb 20, 2026
View reviewed changes
Copy link
Member

@rgwood-dd rgwood-dd left a comment •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is so good, the tab improvement is huge. Thanks!

@joepeeples
various small edits
e39dec5 
- Update lingering Preview language
- Fix link pointing to removed tab
- Fix spacing
- Remove unused link reference URLs
@joepeeples
a few more edits
ed4b224 
- Headings
- Writing style edits
- Include Windows in install steps
joepeeples
joepeeples approved these changes Feb 20, 2026
View reviewed changes
Copy link
Contributor

@joepeeples joepeeples left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, thanks @sumedham for these updates!

The tabs add great usability, but they do introduce extra maintenance due to repeated content; if things change in the future we'll need to remember to update the same info in multiple spots. For sake of GA velocity I'm OK merging what we have here, and we can iterate on a maintenance solution in a future PR.

content/en/bits_ai/mcp_server/_index.md
- The Datadog MCP Server is not supported for production use during the Preview.
- Only Datadog organizations that have been specifically allowlisted can use the Datadog MCP Server. It is not available to the general public.
- The Datadog MCP Server is HIPAA-eligible. You are responsible for ensuring that the AI tools you connect to the Datadog MCP Server meet your compliance requirements, such as HIPAA.
- The Datadog MCP Server is not GovCloud-compatible.
Copy link
Contributor

@joepeeples joepeeples Feb 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The page will already display a banner if the user selects US1-FED as their Datadog Site, so this is a little redundant. But it's probably OK to keep as is, since the list of disclaimers is a focus area where customers are also likely to look for this info.

image

@joepeeples joepeeples removed the request for review from a team February 20, 2026 22:57
@sumedham
Copy link
Contributor Author

sumedham commented Feb 23, 2026

@joepeeples is there a way to add in the dynamic urls to this PR or create another PR to do that? there are a few places where I think we are making lists of urls that are redundant

@joepeeples
Copy link
Contributor

joepeeples commented Feb 23, 2026 •
edited
Loading

is there a way to add in the dynamic urls to this PR or create another PR to do that? there are a few places where I think we are making lists of urls that are redundant

@sumedham Yes, agree! I think we should create a follow-up PR to focus solely on optimizing the URLs and repeated content, so we don't have to wait to merge the rest of these updates. I've opened DOCS-13477 to track the docs work for the follow-up changes

@joepeeples
Copy link
Contributor

joepeeples commented Feb 25, 2026

The tabbed structure will be added separately in #34855, so we can implement them sooner and not have to wait for GA. Once we merge that PR, we'll update this PR from master and sort out any differences or conflicts in the setup file.

@joepeeples joepeeples changed the title MCP GA docs cleanup MCP GA docs cleanup [DOCS-13510] Feb 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@joepeeples joepeeples joepeeples approved these changes

@rgwood-dd rgwood-dd rgwood-dd approved these changes

@jthomas-dd jthomas-dd Awaiting requested review from jthomas-dd

Assignees

@joepeeples joepeeples

Labels

editorial review Waiting on a more in-depth review

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@sumedham @joepeeples @rgwood-dd