# sfcc-dev-mcp

Connects AI assistants to Salesforce Commerce Cloud docs, cartridge scaffolding, and instance logs. Useful for debugging and building storefronts on SFRA.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: taurgis
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/taurgis/sfcc-dev-mcp
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/sfcc-dev-mcp

## What it does

The server operates under two distinct setups. Without any credentials, it exposes 18 documentation tools covering the SFCC API, Storefront Reference Architecture, and ISML elements. It runs locally via `npx` with zero sandbox access.

Full mode opens 40 tools once connected to a sandbox via `dw.json` or environment variables with Basic Auth or OAuth keys. This setup grants your assistant access to live error logs, scheduled job logs, system object definitions, and script debugger endpoints.

Scaffolded cartridge writes remain strictly confined to active workspace roots. Because fallback to the user home folder is blocked, file generation will not write outside your project.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add sfcc-dev-mcp -- npx -y sfcc-dev-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add sfcc-dev-mcp -- npx -y sfcc-dev-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sfcc-dev-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "sfcc-dev-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sfcc-dev-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "sfcc-dev-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add sfcc-dev-mcp npx -y sfcc-dev-mcp
```

## When to use it
- search API references for SFCC classes and SFRA modules
- inspect live instance error logs and background job records
- look up ISML element tags and usage rules
- scaffold new cartridge structures inside project directories

## Example prompts
- Search the SFCC documentation for methods available on `dw.customer.Customer`.
- Check the latest error logs on the instance and show stack traces for checkout failures.
- Scaffold a new cartridge named `int_custom_feeds` inside the current workspace.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md