Skip to content

docs(mcp): trim onboarding jargon, direct .dxt download, fold install into Quickstart#13

Merged
ArtyETH06 merged 4 commits into
mainfrom
ArtyETH06/mcp-docs-rewrite
Jun 24, 2026
Merged

docs(mcp): trim onboarding jargon, direct .dxt download, fold install into Quickstart#13
ArtyETH06 merged 4 commits into
mainfrom
ArtyETH06/mcp-docs-rewrite

Conversation

@ArtyETH06

@ArtyETH06 ArtyETH06 commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Addresses Milan's review of the Leadbay MCP doc section (docs.leadbay.app/doc/leadbay-mcp/).

What changed

  • What is Leadbay MCP? (homepage) — dropped the Key concepts table (lens / score / AI score / taste profile / read-vs-write) and the lens/taste-profile prose; those are runtime concepts the assistant handles, not first-touch onboarding. Added a "See it in action" teaser (real dark-mode screenshots: ranked leads → outreach draft) and a single prominent Quickstart CTA so the page funnels instead of dead-ending.
  • Quickstart Step 1 — links the .dxt directly via the stable …/releases/latest/download/leadbay-latest.dxt URL (one click less, verified live). The npx … installer command stays as the fallback for Claude Code / Cursor / Codex.
  • Installation page removed — its unique reference (Claude Desktop quirk, updating, troubleshooting) is folded into Quickstart so each fact lives in exactly one place. Repointed SUMMARY, example-prompts, and changelog links to Quickstart.
  • Applied to EN and FR mirrors.

Screenshots

Two of three teaser slots are filled with real shots (leads list, outreach draft) in .gitbook/assets/. The third (company research card) stays commented until an image exists — drop it into .gitbook/assets/mcp-teaser-research.png and uncomment.

Scope note

Lens/score wording is removed from the homepage. It remains in tools-reference (documents the literal leadbay_new_lens / scoring tools) and example-prompts (real usage) — those name actual product features, so the cleanup is scoped to the first-touch page.

… into Quickstart

Addresses Milan's review of the Leadbay MCP doc section:
- "What is Leadbay MCP?" drops the Key concepts table (lens/score/AI
  score/taste profile) and the lens/taste-profile prose — runtime
  concepts the assistant handles, not first-touch onboarding. It now
  funnels straight to Quickstart.
- Quickstart's Step 1 links the .dxt asset directly (one click less)
  instead of the GitHub releases page; the npx installer stays as the
  fallback path.
- Removes the Installation page and folds its unique reference (Claude
  Desktop quirk, updating, troubleshooting) into Quickstart so each fact
  lives in one place. Repoints SUMMARY, example-prompts and changelog
  links. EN + FR.

Co-Authored-By: Claude <noreply@anthropic.com>
@ArtyETH06 ArtyETH06 added the documentation Improvements or additions to documentation label Jun 24, 2026
@ArtyETH06 ArtyETH06 self-assigned this Jun 24, 2026
ArtyETH06 and others added 3 commits June 24, 2026 13:17
Use the fixed-name leadbay-latest.dxt asset (published by leadclaw
release CI) so the one-click download always resolves to the current
version with no per-release doc edit.

Co-Authored-By: Claude <noreply@anthropic.com>
Milan wanted the MCP homepage to tease with compelling screenshots. Add
a "See it in action" section to what-is (EN + FR) with three commented
<figure> blocks (ranked leads / outreach draft / research card) and a
hint listing what to capture. Drop images into .gitbook/assets/ and
uncomment to publish — no broken images render in the meantime.

Co-Authored-By: Claude <noreply@anthropic.com>
Wire two of the three "See it in action" slots with real dark-mode shots
(ranked leads list, outreach draft) in .gitbook/assets/. EN + FR. The
research-card slot stays commented until an image exists.

Co-Authored-By: Claude <noreply@anthropic.com>
@ArtyETH06 ArtyETH06 marked this pull request as ready for review June 24, 2026 21:32
@ArtyETH06 ArtyETH06 merged commit f65b696 into main Jun 24, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant