Skip to content

Polish Dropins MCP docs#958

Merged
bdenham merged 4 commits into
releasefrom
ai-dropins-mcp-polish
Jul 21, 2026
Merged

Polish Dropins MCP docs#958
bdenham merged 4 commits into
releasefrom
ai-dropins-mcp-polish

Conversation

@bdenham

@bdenham bdenham commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Purpose of this pull request

Independent prose polish for the Dropins MCP page: updated terminology (Dropins MCP rather than Drop-ins MCP), added Claude Code as a supported editor, clarified the VS Code Copilot tab label, and light copyedits.

Associated JIRA ticket

N/A

Staging preview

https://commerce-docs.github.io/microsite-commerce-storefront/ai/dropins-mcp/

Affected pages

  • src/content/docs/ai/dropins-mcp.mdx

Testing

Reviewed the updated content for clarity, structure, and internal links in the local documentation context.

bdenham added a commit that referenced this pull request Jul 21, 2026
@bdenham bdenham self-assigned this Jul 21, 2026
@bdenham
bdenham requested a review from OscarMerino July 21, 2026 03:38
@bdenham bdenham added the major-update Significant original updates to existing content label Jul 21, 2026
Comment thread src/content/docs/ai/dropins-mcp.mdx Outdated

- Node.js 18 or later (`node -v` to confirm)
- An AI editor that supports MCP servers: <Link href="https://cursor.com/" text="Cursor" />, <Link href="https://code.visualstudio.com" text="VS Code" /> with <Link href="https://github.com/features/copilot" text="GitHub Copilot" />, or <Link href="https://claude.com/download" text="Claude Desktop" />
- An AI editor that supports MCP servers: <Link href="https://cursor.com/" text="Cursor" />, <Link href="https://code.visualstudio.com" text="VS Code" /> with <Link href="https://github.com/features/copilot" text="GitHub Copilot" />, Claude Code, or <Link href="https://claude.com/download" text="Claude Desktop" />

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Claude Code in Prerequisites lacks a link. Cursor, VS Code, and Claude Desktop all use <Link> components with URLs. Claude Code is plain text. Should be (or whichever URL applies) for consistency.

Comment on lines 140 to +144
The MCP works best when you ask specific questions about your project. For example:

- _"What events does the checkout drop-in emit when a payment method is selected?"_
- _"Create a block that combines CartSummaryList and OrderConfirmation"_
- _"Are there any stale containers or removed APIs in my commerce-cart block?"_
- _"What GraphQL mutation does checkout use to place an order?"_
- _"Generate a slot implementation that adds a loyalty points badge next to the cart line item price"_
- _"Am I using the latest drop-in versions?"_
- _"What CSS design tokens control button colors?"_
- _"Are there any stale containers or removed APIs in my commerce-cart block?"_

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reducing example prompts from 7 to 2 loses significant breadth. The removed prompts: "What GraphQL mutation does checkout use to place an order?", "What CSS design tokens control button colors?", "Am I using the latest drop-in versions?" demonstrated diverse MCP capabilities. Keeping at least 4–5 would better convey the server's value to a new user landing on this page.

@bdenham
bdenham requested a review from OscarMerino July 21, 2026 14:16
@bdenham
bdenham merged commit bfae595 into release Jul 21, 2026
8 checks passed
@bdenham
bdenham deleted the ai-dropins-mcp-polish branch July 21, 2026 16:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

major-update Significant original updates to existing content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants