docs(mcp): Restructure and expand MCP server documentation#17201
Merged
docs(mcp): Restructure and expand MCP server documentation#17201
Conversation
Reorganize the page into a clearer flow: Setup (cloud default with stdio subsection), Configuration (org/project scoping), Self-Hosted Sentry (promoted to top-level section), Common Workflows, Client Instructions, and Troubleshooting. Key additions: - Document device-code OAuth for stdio transport - Add org/project URL scoping for cloud and CLI flags for stdio - Expand self-hosted into dedicated section with token setup, --host config, and --disable-skills guidance - Replace generic example usage / available tools / Seer sections with practical workflow examples (issue link debugging, incident analysis with search) - Move client-specific instructions to end as reference material - Apply Sentry brand guidelines throughout Co-Authored-By: Claude <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
Consecutive fenced code blocks get auto-grouped into tabs by the MDX compiler. Rework the Common Workflows examples as inline bullet lists instead. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Restructure the MCP docs page for clarity and expand coverage of stdio
transport, self-hosted setup, and practical workflows.
The page was a flat list of sections that made it hard to find what you
needed — cloud and stdio setup were interleaved, self-hosted was buried
in a collapsible, and the "Example Usage" / "Available Tools" / "Seer
Integration" sections were filler without actionable guidance.
New structure:
device-code OAuth documented
--hostconfig, and--disable-skillsguidancesections (issue link debugging, incident analysis with search)
Also applied Sentry brand guidelines throughout (shorter sentences,
active voice, less fluff).