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.

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

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

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

- Create and configure your environment file:

Edit the.envfile with your Salesforce Commerce Cloud credentials.

The OCAPI configuration files are located in thedata/ocapidirectory. 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 thedata/ocapidirectory:

- 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.

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 fileclaude_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.

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

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

- colinhacksfor (zod).
- Egoistfor (tsup)

Exposes Salesforce APIs as tools for AI agents.