@W-20598954 MCP docs merge into existing guide

Author: patricksullivansf

docs/.vitepress/config.mts

@@ -61,6 +61,9 @@ const guideSidebar = [
     text: 'MCP Server',
     items: [
       {text: 'Overview', link: '/mcp/'},
+      {text: 'Installation', link: '/mcp/installation'},
+      {text: 'Configuration', link: '/mcp/configuration'},
+      {text: 'Toolsets & Tools', link: '/mcp/toolsets'},
     ],
   },
   {
@@ -95,20 +98,8 @@ const guideSidebar = [
       {text: 'Logging', link: '/cli/logging'},
     ],
   },
-];
-
-const mcpSidebar = [
-  {
-    text: 'MCP Server',
-    items: [
-      {text: 'Overview', link: '/mcp/'},
-      {text: 'Installation', link: '/mcp/installation'},
-      {text: 'Configuration', link: '/mcp/configuration'},
-      {text: 'Toolsets & Tools', link: '/mcp/toolsets'},
-    ],
-  },
   {
-    text: 'Tools',
+    text: 'Tools Reference',
     items: [
       {text: 'cartridge_deploy', link: '/mcp/tools/cartridge-deploy'},
       {text: 'mrt_bundle_push', link: '/mcp/tools/mrt-bundle-push'},
@@ -182,7 +173,7 @@ export default defineConfig({
     sidebar: {
       '/guide/': guideSidebar,
       '/cli/': guideSidebar,
-      '/mcp/': mcpSidebar,
+      '/mcp/': guideSidebar,
       '/api/': [
         {
           text: 'API Reference',

docs/guide/index.md

@@ -1,12 +1,15 @@
 ---
-description: Introduction to the B2C CLI and SDK for Salesforce Commerce Cloud B2C code deployment, site management, and sandbox operations.
+description: Introduction to the B2C CLI, MCP Server, and SDK for Salesforce Commerce Cloud B2C code deployment, site management, and sandbox operations.
 ---
 
 # Introduction
 
-The B2C CLI is a command-line interface for Salesforce Commerce Cloud B2C — deploy code, manage sandboxes, run jobs, and more from the terminal.
+The B2C Developer Tooling provides command-line and AI-assisted development tools for Salesforce Commerce Cloud B2C:
 
-## Quick Install
+- **B2C CLI** - Command-line interface to deploy code, manage sandboxes, run jobs, and more from the terminal
+- **MCP Server** - AI-assisted development tools for Cursor, Claude Desktop, and other AI assistants
+
+## Quick CLI Install
 
 ::: code-group
 
@@ -24,14 +27,47 @@ brew install SalesforceCommerceCloud/tools/b2c-cli
 
 :::
 
-See [Installation](./installation) for more options.
+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:
+
+**Cursor** (supports `${workspaceFolder}`):
+
+```json
+{
+  "mcpServers": {
+    "b2c-dx": {
+      "command": "npx",
+      "args": ["-y", "@salesforce/b2c-dx-mcp", "--working-directory", "${workspaceFolder}", "--allow-non-ga-tools"]
+    }
+  }
+}
+```
+
+**Claude Desktop** (use explicit path):
+
+```json
+{
+  "mcpServers": {
+    "b2c-dx": {
+      "command": "npx",
+      "args": ["-y", "@salesforce/b2c-dx-mcp", "--working-directory", "/path/to/your/project", "--allow-non-ga-tools"]
+    }
+  }
+}
+```
+
+See the [MCP Server Installation Guide](/mcp/installation) for detailed setup instructions.
 
 ## Next Steps
 
 - [Authentication Setup](./authentication) - Set up Account Manager, OCAPI, and WebDAV
 - [Analytics Reports (CIP/CCAC)](./analytics-reports-cip-ccac) - Run curated analytics reports and SQL queries
 - [Configuration](./configuration) - Configure instances and credentials
 - [IDE Integration](./ide-integration) - Connect Prophet VS Code to B2C CLI configuration
-- [CLI Reference](/cli/) - Browse available commands
 - [MCP Server](/mcp/) - AI-assisted development with Model Context Protocol
+- [CLI Reference](/cli/) - Browse available commands
+- [Tools Reference](/mcp/toolsets) - Explore MCP tools for cartridges, MRT, SCAPI, and more
 - [API Reference](/api/) - Explore the SDK API

docs/mcp/index.md

@@ -112,6 +112,8 @@ AI assistants automatically decide which MCP tools to use based on your prompts.
 4. **Use natural language**: Describe what you want to achieve, not the tool name
 5. **Provide context**: Mention your project type, what you're building, or what you need to learn
 6. **Ask for guidelines first**: When starting a new project or learning a framework, ask for development guidelines before writing code
+7. **Combine related topics**: Ask for multiple related sections in one request (e.g., "Use the MCP tool to show me data fetching and component patterns for Storefront Next")
+8. **Specify operations clearly**: For deployment operations, mention the target and what to deploy (e.g., "Use the MCP tool to deploy my cartridges to the sandbox instance")
 
 #### Example Prompts
 

docs/mcp/toolsets.md

@@ -115,35 +115,6 @@ Storefront Next development tools for building modern storefronts.
 
 Some tools appear in multiple toolsets (e.g., `mrt_bundle_push`, `scapi_schemas_list`, `scapi_custom_apis_status`). When using multiple toolsets, tools are automatically deduplicated, so you'll only see each tool once.
 
-## Prompting Tips
-
-### Start with Guidelines
-
-When learning a new framework, ask for development guidelines first:
-
-- ✅ "Use the MCP tool to get Storefront Next development guidelines."
-- ✅ "Use the MCP tool to show me PWA Kit best practices."
-
-### Combine Related Topics
-
-Ask for multiple related sections in one request:
-
-- ✅ "Use the MCP tool to show me data fetching and component patterns for Storefront Next."
-
-### Provide Project Context
-
-Mention your project type for better tool selection:
-
-- ✅ "I'm working on a Storefront Next project. Use the MCP tool to..."
-- ✅ "In my PWA Kit project, use the MCP tool to..."
-
-### Specify Operations Clearly
-
-For deployment operations, mention the target and what to deploy:
-
-- ✅ "Use the MCP tool to deploy my cartridges to the sandbox instance."
-- ✅ "Use the MCP tool to push my bundle to staging."
-
 ## Next Steps
 
 - [Configuration](./configuration) - Configure credentials and toolset selection