SFCC Dev MCP Server

AI-powered development tools for Salesforce B2C Commerce Cloud

An AI-powered Model Context Protocol (MCP) server that provides comprehensive access to Salesforce B2C Commerce Cloud development tools, documentation, and best practices.

🚀 Quick Start

⚠️ Important: MCP + AI Instructions Required

The MCP server alone may not be sufficient for optimal AI assistance. This project includes ready-to-use AI instruction files for GitHub Copilot, Claude, and Cursor that guide the AI to use the MCP correctly and prioritize SFCC-specific knowledge.

📁 Get the files: ai-instructions folder on GitHub
📖 Setup guide: AI Interface Setup page

Get immediate access to SFCC documentation and best practices without any credentials using documentation-only mode:

{
  "mcpServers": {
    "sfcc-dev": {
      "command": "npx", 
      "args": ["sfcc-dev-mcp"]
    }
  }
}

For full functionality including log analysis and system objects, provide SFCC credentials via --dw-json parameter:

⚠️ Important: For full API functionality, you’ll need to configure OCAPI settings in Business Manager. See the Configuration Guide for required Data API settings.

{
  "mcpServers": {
    "sfcc-dev": {
      "command": "npx",
      "args": ["sfcc-dev-mcp", "--dw-json", "/path/to/your/dw.json"]
    }
  }
}

dw.json configuration file:

{
  "hostname": "your-instance.sandbox.us01.dx.commercecloud.salesforce.com",
  "username": "your-username", 
  "password": "your-password",
  "client-id": "your-client-id",
  "client-secret": "your-client-secret",
  "site-id": "your-site-id"
}

Note: The site-id field is optional and only needed for site-specific operations.

Choose your preferred AI interface:

✨ Key Features

  • 🔍 Complete SFCC Documentation Access - Search and explore all SFCC API classes and methods
  • 📚 Best Practices Guides - Curated development guidelines for cartridges, hooks, controllers, and more
  • 🏗️ SFRA Documentation - Enhanced access to Storefront Reference Architecture documentation
  • 📊 Log Analysis Tools - Real-time error monitoring and debugging for SFCC instances
  • ⚙️ System Object Definitions - Explore custom attributes and site preferences
  • 🚀 Cartridge Generation - Automated cartridge structure creation

Documentation

📦 Installation

Multiple installation options including npx, global, and local development

🤖 AI Interface Setup

Detailed setup guides for Claude Desktop, GitHub Copilot, and Cursor

⚙️ Configuration

Complete configuration guide including dw.json and Data API setup

✨ Features

Detailed overview of all capabilities including cartridge generation, documentation access, and log analysis

🛠️ Available Tools

Comprehensive documentation of all available MCP tools

💡 Examples

Real-world AI assistant interactions and use cases

🔒 Security

Security guidelines and best practices for credential management

🐛 Troubleshooting

Common issues and debugging techniques

🎯 Operating Modes

Documentation-Only Mode

Perfect for learning and reference - no SFCC credentials required. Access to:

  • Complete SFCC API documentation
  • Best practices guides
  • SFRA documentation
  • Cartridge generation tools

Full Mode

Complete development experience with SFCC instance access:

  • All documentation-only features
  • Real-time log analysis
  • System object definitions
  • Code version management

🔗 Quick Links

This MCP server empowers AI assistants to provide accurate, real-time assistance for SFCC development workflows, significantly improving developer productivity and code quality.