用途:管理 B2C CLI/MCP 的认证、实例与项目默认配置,并诊断凭据缺失、目标错误或配置优先级异常。日常查看可直接调用 config_inspect 或 b2c setup inspect,无需读取技能文档;涉及配置来源或异常值排查时再查阅对应章节。
主要能力:CLI 会自动从多来源发现实例主机名、凭据、租户 ID、MRT API 密钥等,通常无需显式传 --server、--client-id、--client-secret、--username、--password、--tenant-id、--short-code、--api-key。解析优先级从高到低为:CLI 标志与环境变量(含自动加载的 .env)、高优先级插件来源、dw.json、~/.mobify(仅 MRT API 密钥)、低优先级插件来源、package.json 的 b2c 键。dw.json 字段名 camelCase 与 kebab-case 等价。
使用方式:查看解析结果用 b2c setup inspect(别名 b2c setup config),可加 -i 指定实例、--config 指定文件、--json 输出、--unmask 显示敏感值。管理实例用 b2c setup instance list/create/set-active/remove。设置共享全局默认用 b2c setup default-config set/get/unset。认证支持客户端凭据、浏览器 OAuth(--user-auth)、Basic 认证及 b2c auth login/client 持久会话。若 b2c 不可用,可用 npx @salesforce/b2c-cli。
适用场景:验证当前使用的配置文件、确认环境变量是否被读取、调试认证失败、理解凭据来源优先级、检查 MRT 密钥来源,以及为 MCP 调用指定 projectDirectory、configPath、instanceName。
限制:MCP 无写入配置的等价命令,改配置或认证需用 CLI。package.json 的 b2c 键不允许存放 clientSecret/password 等敏感字段。自 B2C Commerce 26.8 起 SCAPI Admin API 不支持 --user-auth。代理环境下需设置 SFCC_REDIRECT_URI。具体字段与完整参考以官方配置指南为准。