commercecloud

This Commerce Cloud MCP Server connects your AI applications to Salesforce Commerce Cloud using the Model Context Protocol (MCP). It exposes endpoints and flows that let you fetch and manage product data, analyze orders for insights, read and write custom objects, and handle content assets within your SFCC instance. The server is built with Node.js and is intended to be run from the dist/index.js bundle after building the project. To integrate with your MCP client (e.g., Claude Desktop App), point the client’s MCP configuration to the server’s Node entry, as shown in the example config. Once connected, you can request product details, generate product updates from images, analyze orders for patterns, and perform content asset operations through standardized MCP messages.

Prerequisites:

• Node.js v22 or higher
• Git
• Salesforce Commerce Cloud OCAPI access and a valid SFCC instance
• An MCP client application (for example, 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 (or use the provided environment variables in the mcp_config) with your SFCC OCAPI credentials and SFCC instance details.

4. Build the project:

npm run build

5. Import OCAPI configurations: The OCAPI configuration files are in data/ocapi. Import them into SFCC Business Manager as described in README:

• Log into Business Manager
• Administration > Site Development > Open Commerce API Settings
• For each JSON in data/ocapi, select API type (Shop/Data), copy contents, and paste then Save

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

• Open Claude Desktop App
• File > Settings > Developer > Edit Config
• In the configuration, add the server details, for example:

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

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

• The server relies on environment variables to connect to SFCC OCAPI endpoints. Ensure OCAPI credentials are correct and that OCAPI permissions (Shop/Data) are configured.
• Use the provided data/ocapi configurations by importing them into Business Manager to enable required MCP endpoints.
• When deploying, ensure the path in the MCP client config (.json) points to the built dist/index.js output.
• If you encounter connection issues, verify network access from the MCP client to the SFCC instance and confirm OCAPI host URL is reachable.
• The project is designed to support Product Details, Product Updates, Order Details, Custom Objects, and Content Assets; some features like Site Preferences, Promotions & Campaigns, and Job Configurations are marked for future implementation.