Install AI Tools

B2C Commerce tools, documentation, and skills for your assistant.

Claude

Using Claude Desktop? See Claude Desktop (Cowork) setup.

Install the plugin Recommended

bash
claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
claude plugin install b2c-dx-mcp@b2c-developer-tooling

Start a new Claude Code session. To install for the current project only, run it from your project directory with --scope project.

Manual MCP setup
bash
claude mcp add --transport stdio --scope user b2c-dx-mcp -- npx -y @salesforce/b2c-dx-mcp@latest

Start a new session. To configure the current project only, run it from your project directory with --scope project. See Claude Code MCP setup.

Codex/ChatGPT

Using the ChatGPT desktop app (ChatGPT Work)? See ChatGPT Work setup.

Install the plugin Recommended

bash
codex plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
codex plugin add b2c-dx-mcp@b2c-developer-tooling

Start a new Codex session in your project. Codex plugins also work in ChatGPT Work.

Manual MCP setup
bash
codex mcp add b2c-dx-mcp -- npx -y @salesforce/b2c-dx-mcp@latest

Or add this to ~/.codex/config.toml (or $CODEX_HOME/config.toml if customized):

toml
[mcp_servers.b2c-dx-mcp]
command = "npx"
args = ["-y", "@salesforce/b2c-dx-mcp@latest"]

Start a new session. See Codex MCP configuration.

VS Code

Install the plugin Recommended

  1. Open the Command Palette (Cmd/Ctrl+Shift+P) and run Chat: Install Plugin from Source.
  2. Enter SalesforceCommerceCloud/b2c-developer-tooling.
  3. Select b2c-dx-mcp and follow the installation prompts.
  4. Start a new chat in GitHub Copilot.
Manual MCP setup

Add this to .vscode/mcp.json in your workspace:

json
{
  "servers": {
    "b2c-dx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@salesforce/b2c-dx-mcp@latest"]
    }
  }
}

See VS Code MCP setup.

Copilot CLI setup

Cursor

Reload the MCP server in Cursor after installation.

Manual MCP setup

Add this to .cursor/mcp.json in your project:

json
{
  "mcpServers": {
    "b2c-dx-mcp": {
      "command": "npx",
      "args": ["-y", "@salesforce/b2c-dx-mcp@latest"]
    }
  }
}

For all projects, use ~/.cursor/mcp.json instead.

See Cursor's MCP documentation.

OpenCode

Add this to opencode.json in your project:

json
{
  "mcp": {
    "b2c-dx-mcp": {
      "type": "local",
      "command": ["npx", "-y", "@salesforce/b2c-dx-mcp@latest"],
      "enabled": true
    }
  }
}

Restart OpenCode. For all projects, use ~/.config/opencode/opencode.json. See OpenCode MCP setup.

Gemini

Run:

bash
gemini mcp add --scope user b2c-dx-mcp -- npx -y @salesforce/b2c-dx-mcp@latest

Start a new Gemini CLI session. To configure the current project only, run it from your project directory with --scope project. See Gemini CLI MCP setup.

No separate skills plugins needed.

Other clients and manual setup →
Skip to content
View as Markdown
View as Markdown

@salesforce/b2c-tooling-sdk / config / ResolveConfigOptions

Interface: ResolveConfigOptions ​

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:311

Options for configuration resolution.

Properties ​

accountManagerHost? ​

optional accountManagerHost: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:346

Account Manager hostname for OAuth (passed to plugins for host-specific config)


clientIdProtection? ​

optional clientIdProtection: boolean

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:335

Whether to apply OAuth clientId mismatch protection (default: true). When the override clientId differs from the base config's clientId, the stored clientSecret is dropped — a secret bound to a different client would silently steer auth into client-credentials with credentials that never validate. Same protection applies to slasClientId / slasClientSecret.


cloudOrigin? ​

optional cloudOrigin: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:342

Cloud origin for ~/.mobify lookup (MRT)


configPath? ​

optional configPath: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:319

Explicit path to config file (defaults to auto-discover). An explicit path is used on its own, without defaultConfigPath. An empty string selects no dw.json at all.


credentialsFile? ​

optional credentialsFile: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:344

Path to custom MRT credentials file (overrides default ~/.mobify)


defaultConfigPath? ​

optional defaultConfigPath: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:321

Global instance-catalog fallback used after a discovered project-local dw.json


hostnameProtection? ​

optional hostnameProtection: boolean

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:327

Whether to apply hostname mismatch protection (default: true)


instance? ​

optional instance: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:313

Explicit instance name, or the name resolved from an earlier source during loading.


overrideOrigins? ​

optional overrideOrigins: Partial<Record<keyof NormalizedConfig, string>>

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:340

Human-readable origin of each override field (e.g. .env (SFCC_OAUTH_CLIENT_ID), --client-id). Used only in mismatch warning messages.


projectDirectory? ​

optional projectDirectory: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:323

Starting directory for config file search


replaceDefaultSources? ​

optional replaceDefaultSources: boolean

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:361

Replace default sources entirely (instead of appending)


sourcesAfter? ​

optional sourcesAfter: ConfigSource[]

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:358

Custom sources to add AFTER default sources (lower priority). These sources fill in gaps left by dw.json and ~/.mobify.


sourcesBefore? ​

optional sourcesBefore: ConfigSource[]

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:352

Custom sources to add BEFORE default sources (higher priority). These sources can override values from dw.json and ~/.mobify.


workingDirectory? ​

optional workingDirectory: string

Defined in: packages/b2c-tooling-sdk/src/config/types.ts:325

Deprecated ​

Use projectDirectory instead