docs(mcp): lead the Quickstart with a 'which one are you?' router#16
Closed
ArtyETH06 wants to merge 1 commit into
Closed
docs(mcp): lead the Quickstart with a 'which one are you?' router#16ArtyETH06 wants to merge 1 commit into
ArtyETH06 wants to merge 1 commit into
Conversation
The connector's real gate — paid plan + admin-only in a company workspace — was scattered across mid-page hints, so a reader only discovered whether they COULD add the connector after trying (and maybe failing). Surface it up front as a 4-row decision table (solo-paid / admin / member→ask admin / no-admin→.dxt) before Step 1, so users self-route in one glance. Trim the now-redundant mid-step hint to a pointer to the full Installation walkthrough. Co-Authored-By: Claude <noreply@anthropic.com>
Contributor
Author
|
Closed by #19 |
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
1 participant
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.
Problem
The MCP Quickstart is well-written per step, but a new (non-technical) user finds it messy because the one fact that gates everything — "can I even add this connector?" — is scattered across mid-page hints:
So the reader only discovers whether they can proceed after trying (and possibly failing). The info exists 4× but is never the first thing they see.
Fix (surgical — EN Quickstart only)
Add a "First — which one are you?" decision table at the very top, before Step 1, so users self-route in one glance:
.dxt(no-admin install)Then trim the now-redundant mid-step hint to a pointer to the full Installation walkthrough. No step-by-step content changed; +14/−1 lines.
Not in this PR (flagged separately)
fr/leadbay-mcp/quickstart.mdis stale — it leads with.dxtas "recommended", uses the oldleadbay/leadclawGitHub URL (repo renamed toleadbay/mcp), and says "ChatGPT support coming soon" (it's shipped). The FR MCP docs need a broader refresh to match EN — larger scope, worth its own PR.Draft — for review by whoever owns the docs voice.