Merge branch 'main' into feature-W-21207882-add-scapi-cors-support

Author: amit-kumar8-sf

.changeset/fix-skills-cache-staleness.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-tooling-sdk': patch
+---
+
+Fix `b2c setup skills` serving stale cached skills when downloading latest release

.changeset/storefront-next-early-access-notices.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-dx-docs': patch
+---
+
+Add early access notices to Storefront Next MCP tool documentation indicating they're part of a closed pilot.

docs/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @salesforce/b2c-dx-docs
 
+## 0.2.3
+
+### Patch Changes
+
+- [#236](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/pull/236) [`113e81e`](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/commit/113e81e148e1c93bfa09a7d2223b0eeed6a3f41e) - Improved MCP documentation: fixed broken links, promoted project-level installation for Claude Code and Cursor, simplified verbose sections, and verified all configuration details match implementation. (Thanks [@yhsieh1](https://github.com/yhsieh1)!)
+
 ## 0.2.2
 
 ### Patch Changes

docs/guide/index.md

@@ -7,7 +7,7 @@ description: Introduction to the B2C CLI, MCP Server, and SDK for Salesforce B2C
 The B2C Developer Tooling provides command-line and AI-assisted development tools for Salesforce B2C Commerce.
 
 - **B2C CLI**: Command-line interface that you can use to deploy code, manage sandboxes, run jobs, and so on from the terminal.
-- **MCP Server**: AI-assisted development tools for Cursor, Claude Desktop, and other AI assistants.
+- **MCP Server**: AI-assisted development tools for Claude Code, Cursor, GitHub Copilot, and other AI assistants.
 
 ## Quick CLI Install
 
@@ -31,35 +31,26 @@ See the [CLI Installation Guide](./installation) for more installation options.
 
 ## Quick MCP Install
 
-The B2C DX MCP Server enables AI assistants to help with B2C Commerce development tasks. Install it in your MCP client configuration:
+The B2C DX MCP Server enables AI assistants to help with B2C Commerce development tasks.
 
-**Cursor** (supports `${workspaceFolder}`):
+**Claude Code:**
 
-```json
-{
-  "mcpServers": {
-    "b2c-dx": {
-      "command": "npx",
-      "args": ["-y", "@salesforce/b2c-dx-mcp", "--project-directory", "${workspaceFolder}", "--allow-non-ga-tools"]
-    }
-  }
-}
+::: code-group
+
+```bash [Project Scope (Recommended)]
+cd /path/to/your/project
+claude mcp add --transport stdio --scope project b2c-dx -- npx -y @salesforce/b2c-dx-mcp --allow-non-ga-tools
 ```
 
-**Claude Desktop** (use explicit path):
-
-```json
-{
-  "mcpServers": {
-    "b2c-dx": {
-      "command": "npx",
-      "args": ["-y", "@salesforce/b2c-dx-mcp", "--project-directory", "/path/to/your/project", "--allow-non-ga-tools"]
-    }
-  }
-}
+```bash [User Scope]
+claude mcp add --transport stdio --scope user b2c-dx -- npx -y @salesforce/b2c-dx-mcp --allow-non-ga-tools
 ```
 
-See the [MCP Server Installation Guide](/mcp/installation) for detailed setup instructions.
+:::
+
+**Cursor:** [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=b2c-dx&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzYWxlc2ZvcmNlL2IyYy1keC1tY3AiLCItLXByb2plY3QtZGlyZWN0b3J5IiwiJHt3b3Jrc3BhY2VGb2xkZXJ9IiwiLS1hbGxvdy1ub24tZ2EtdG9vbHMiXX0=)
+
+See the [MCP Server Installation Guide](/mcp/installation) for detailed setup instructions for Claude Code, Cursor, GitHub Copilot, and other MCP clients.
 
 ## Next Steps