What is Commercecloud Mcp Server

The commercecloud-mcp-server is an MCP server designed to facilitate the connection between AI applications and Salesforce Commerce Cloud instances, utilizing the Model Context Protocol (MCP) for data exchange.

Use cases

Use cases include managing product data, analyzing order trends, performing custom object operations, and managing content assets within Salesforce Commerce Cloud.

How to use

To use the commercecloud-mcp-server, clone the repository, install dependencies, configure your environment file with Salesforce Commerce Cloud credentials, build the project, and import OCAPI configurations into your SFCC Business Manager.

Key features

Key features include product management and updates, order analysis and insights, custom object operations, content asset management, and environment-based configuration.

Where to use

The commercecloud-mcp-server is primarily used in e-commerce environments where integration between AI applications and Salesforce Commerce Cloud is required.

🛍️ Commerce Cloud MCP Server

A server that helps connect your AI applications with Salesforce Commerce Cloud. It uses the Model Context Protocol (MCP) to make data exchange between your AI client application and Commerce Cloud instance.

✨ Features

• 🛍️ Product management and updates
• 📊 Order analysis and insights
• 🗂️ Custom object operations
• 📄 Content asset management
• ⚙️ Environment-based configuration

🔄 Flow Diagram

🚀 Setup Instructions

Prerequisites

• Node.js version 22 or higher
• Git
• A Salesforce Commerce Cloud instance with OCAPI access
• An MCP client application (like Claude Desktop App)

Installation Steps

1. Clone the repository:

git clone https://github.com/your-username/commercecloud-mcp-server.git
cd commercecloud-mcp-server

2. Install dependencies:

npm install

3. Create and configure your environment file:

cp .env.example .env

Edit the .env file with your Salesforce Commerce Cloud credentials.

4. Build the project:

npm run build

5. Import OCAPI configurations:

   The OCAPI configuration files are located in the data/ocapi directory. Import them into your SFCC Business Manager:

   • Log into Business Manager
   • Navigate to Administration > Site Development > Open Commerce API Settings
   • For each JSON file in the data/ocapi directory:
     • Select the appropriate API type (Shop/Data)
     • Copy the contents of the JSON file
     • Paste into the configuration field
     • Click “Save”

   These configurations enable the necessary endpoints for the MCP server to function.

6. Configure your MCP client application (Example - Claude Desktop App):

   • Open Claude Desktop App
   • Go to File > Settings > Developer > Edit Config
   • This will open a folder containing a file claude_desktop_config.json
   • Open the file in an editor and add the server details:

{
  "mcpServers": {
    "commercecloud": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/commercecloud-mcp-server/dist/index.js"
      ]
    }
  }
}

Note: Replace /ABSOLUTE/PATH/TO/ with the actual path to your project folder.

📋 Use Cases

📚 Supporting Documentation

• Model Context Protocol (MCP)
• Typescript SDK
• Open Commerce API

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Credits

Greater minds than mine are behind creating tools that made this project possible. I would like to mention those projects

• colinhacks for (zod).
• antfu for (vitest).
• Egoist for (tsup)

I hope you find this tool useful! 🌟

Made with ❤️ by Brinsil.