SFCC Development MCP Server

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

✨ 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

🚀 Quick Start

Option 1: Documentation-Only Mode (No SFCC credentials needed)

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

Option 2: Full Mode (With SFCC credentials for log analysis)

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

Create a dw.json file with your SFCC credentials:

{
  "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"
}

🎯 Operating Modes

Mode	Tools Available	SFCC Credentials Required
Documentation-Only	15 tools	❌ No
Full Mode	30 tools	✅ Yes

Documentation-Only Mode

Perfect for learning and development - no SFCC instance required:

Complete SFCC API documentation (5 tools)
Best practices guides (4 tools)
SFRA documentation (5 tools)
Cartridge generation (1 tool)

Full Mode

Complete development experience with live SFCC instance access:

All documentation-only features (15 tools)
Real-time log analysis (7 tools)
System object definitions (6 tools)
Code version management (2 tools)

🤖 AI Interface Setup

Choose your preferred AI assistant:

Interface	Best For	Setup Guide
Claude Desktop	Multi-turn conversations, debugging	📖 Setup Guide
GitHub Copilot	VS Code integration, inline suggestions	📖 Setup Guide
Cursor	Modern AI-powered editor	📖 Setup Guide

📦 Installation

Using npx (Recommended)

# Test the server
npx sfcc-dev-mcp

# Use with your configuration
npx sfcc-dev-mcp --dw-json /path/to/your/dw.json

Global Installation

npm install -g sfcc-dev-mcp
sfcc-dev-mcp --dw-json /path/to/your/dw.json

🐛 Debug Mode & Logging

Enable Debug Logging

# Enable debug mode for detailed logging
npx sfcc-dev-mcp --debug

# Or with configuration file
npx sfcc-dev-mcp --dw-json /path/to/your/dw.json --debug

Log File Locations

The server writes logs to your system's temporary directory:

macOS: /var/folders/{user-id}/T/sfcc-mcp-logs/
Linux: /tmp/sfcc-mcp-logs/
Windows: %TEMP%\sfcc-mcp-logs\

Log Files Created:

sfcc-mcp-info.log - General application logs and startup messages
sfcc-mcp-debug.log - Detailed debug information (only when --debug is enabled)
sfcc-mcp-error.log - Error messages and stack traces
sfcc-mcp-warn.log - Warning messages

Finding Your Log Directory

// The exact path varies by system - to find yours:
node -e "console.log(require('os').tmpdir() + '/sfcc-mcp-logs')"

## 📖 Documentation

**📚 [Complete Documentation](https://taurgis.github.io/sfcc-dev-mcp/)** - Comprehensive guides and references

Quick Links:
- **[Installation Guide](https://taurgis.github.io/sfcc-dev-mcp/installation)** - Detailed installation options
- **[AI Interface Setup](https://taurgis.github.io/sfcc-dev-mcp/ai-interfaces)** - Configure Claude Desktop, GitHub Copilot, or Cursor
- **[Configuration Guide](https://taurgis.github.io/sfcc-dev-mcp/configuration)** - SFCC credentials and Data API setup
- **[Available Tools](https://taurgis.github.io/sfcc-dev-mcp/tools)** - Complete tool reference
- **[Examples](https://taurgis.github.io/sfcc-dev-mcp/examples)** - Real-world usage patterns
- **[Troubleshooting](https://taurgis.github.io/sfcc-dev-mcp/troubleshooting)** - Common issues and solutions

## 🛠️ Example AI Interactions

🧑‍💻 "Create a new SFCC controller for product search" 🤖 Generates complete controller with proper imports, route handling, and SFRA patterns

🧑‍💻 "What's wrong with my checkout flow? Check the logs"
🤖 Analyzes recent error logs, identifies issues, and suggests fixes

🧑‍💻 "Show me how to implement OCAPI hooks for order validation" 🤖 Provides best practices guide with complete hook implementation examples

## 🔒 Security Notes

- **Local Development Focus**: Designed for individual developer use on local machines
- **Credential Protection**: dw.json files should never be committed to version control
- **Network Security**: All API calls use HTTPS with proper authentication
- **No Data Storage**: Server doesn't persist any SFCC data locally

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

**🚀 Ready to supercharge your SFCC development with AI?**

**[📖 Get Started with the Full Documentation](https://taurgis.github.io/sfcc-dev-mcp/)**

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Provides comprehensive access to Salesforce B2C Commerce Cloud development tools including SFCC API documentation, best practices guides, log analysis, and system object definitions. Enables AI assistants to help with SFCC development tasks through both documentation-only mode and full credential-based mode.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Salesforce CLI MCP Server
codefriar
A
security
F
license
A
quality
Exposes Salesforce CLI functionality to LLM tools like Claude Desktop, allowing AI agents to execute Salesforce commands, manage orgs, deploy code, and query data through natural language.
Last updated -
5
296
32
SAP Documentation MCP Server
marianfoo
A
security
A
license
A
quality
Provides offline access to SAP documentation and real-time SAP Community content, integrating official documentation with community-driven solutions for comprehensive developer support.
Last updated -
5
53
Apache 2.0
Salesforce MCP Server
savidev1987
-
security
A
license
-
quality
An MCP server implementation that integrates Claude/VS Code with Salesforce, enabling natural language interactions with your Salesforce data and metadata.
Last updated -
MIT License
UI Expert MCP Server
reallygood83
A
security
A
license
A
quality
Provides professional UI/UX design expertise and frontend development tools for analyzing interfaces, generating design systems, and creating modern components with accessibility and best practices built-in. Supports React, Vue, Angular and other frameworks with seamless Claude Code CLI integration.
Last updated -
4
2
MIT License

View all related MCP servers

SFCC Development MCP Server