Skip to content

docs(mcp): restructure MCP server page for actionability#16295

Merged
codyde merged 1 commit intomasterfrom
updating-mcp-product-docs
Feb 8, 2026
Merged

docs(mcp): restructure MCP server page for actionability#16295
codyde merged 1 commit intomasterfrom
updating-mcp-product-docs

Conversation

@codyde
Copy link
Contributor

@codyde codyde commented Feb 7, 2026

Summary

Reorganizes the Sentry MCP Server documentation to be more actionable and get users set up faster.

  • Getting Started above the fold: Tabbed code blocks (OAuth recommended + Self-Hosted STDIO) are now the first thing users see, before any overview or video content
  • Per-client setup with TOC navigation: Each verified client gets an h3 heading (visible in right-side nav) with an Expandable accordion for setup instructions, keeping the page scannable while remaining navigable
  • Removed npx mcp-remote references: All client configs updated to use native OAuth/Streamable HTTP URLs — Warp and Amp configs updated based on their current docs confirming native support
  • STDIO deprioritized: Moved to last tab in Getting Started, labeled "Self-Hosted" to clarify its use case
  • Condensed overview: Replaced verbose overview + duplicate feature lists with a single intro sentence
  • Video moved after setup sections: Users see actionable setup first
  • Example Usage moved up: Appears before the tools reference so users know what to try immediately after connecting
  • mcp-remote fallback: Single mention in "Other Clients" section for edge cases only

Before/After structure

Before: Overview → Video → Getting Started (OAuth / Legacy Remote / STDIO) → Tools → Examples → 12 client subsections → Seer → Troubleshooting

After: Intro → Getting Started (tabbed) → Client Setup (h3 + accordion per client) → Video → Examples → Tools → Seer → Troubleshooting

Reorganize the Sentry MCP Server docs to prioritize getting started
content above the fold and deprioritize STDIO in favor of the remote
hosted OAuth configuration.

Key changes:
- Move Getting Started with tabbed code blocks (OAuth + Self-Hosted)
  to the top of the page, before any overview content
- Replace flat client list with h3 headings + Expandable accordions
  for each verified client, keeping TOC navigability
- Remove all npx mcp-remote references; update Warp and Amp configs
  to use native OAuth/Streamable HTTP URLs
- Condense Overview into a single intro sentence
- Move video embed after setup sections
- Move Example Usage above Available Tools for actionability
- Add mcp-remote fallback note only in Other Clients section

Co-Authored-By: Claude <noreply@anthropic.com>
@codyde codyde requested a review from rahulchhabria February 7, 2026 09:23
@vercel
Copy link

vercel bot commented Feb 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Feb 7, 2026 9:48am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Feb 7, 2026 9:48am

Request Review

@codyde codyde merged commit bf615f3 into master Feb 8, 2026
14 checks passed
@codyde codyde deleted the updating-mcp-product-docs branch February 8, 2026 04:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants