摘要
通过 Salesforce Commerce API (SCAPI) 管理 API 访问 Salesforce B2C Commerce Cloud:订单及其状态、产品搜索和编辑、目录和类别、库存列表记录和注册客户。账户管理 API 客户端(客户端凭据)、短代码、租户 ID 和站点 ID。
引导式设置
2 分钟将 Salesforce Commerce Cloud 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Salesforce Commerce Cloud,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
Salesforce Commerce Cloud 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Salesforce Commerce Cloud,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Salesforce Commerce Cloud + ChatGPT
通过 Salesforce Commerce API (SCAPI) 管理 API 访问 Salesforce B2C Commerce Cloud:订单及其状态、产品搜索和编辑、目录和类别、库存列表记录和注册客户。账户管理 API 客户端(客户端凭据)、短代码、租户 ID 和站点 ID。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SFCC_SHORT_CODE, SFCC_TENANT_ID, SFCC_CLIENT_ID, SFCC_CLIENT_SECRET
第一步 — 获取凭据
设置大约需要 15 分钟。你需要一个账户管理管理员。
- 在 Business Manager 中打开 Administration, Site Development, Salesforce Commerce API Settings,并记下 Short Code(8 个字符)和 Organization ID(
f_ecom_后跟租户 ID,例如f_ecom_zzrf_001)。租户 ID 是f_ecom_后面的部分(这里是zzrf_001)。 - 在账户管理器(
https://account.demandware.com)中打开 API Client, Add API Client。设置一个密码(这将成为客户端密钥)和令牌端点身份验证方法client_secret_basic。 - 在 Roles 下添加
Salesforce Commerce API,并将其租户过滤器设置为你的租户 ID。 - 在 Allowed Scopes(和 Default Scopes)下精确添加:
sfcc.orders.rw sfcc.products.rw sfcc.catalogs sfcc.inventory-lists.rw sfcc.customerlists sfcc.customergroups。保存并确保客户端处于活动状态。 - 将短代码输入到
SFCC_SHORT_CODE,将租户 ID 输入到SFCC_TENANT_ID,将站点 ID(例如RefArch,来自 Merchant Tools,Sites)输入到SFCC_SITE_ID,将 API 客户端 ID 和密码输入到SFCC_CLIENT_ID和SFCC_CLIENT_SECRET。
连接器向 https://account.demandware.com/dwsso/oauth2/access_token 请求带有作用域 SALESFORCE_COMMERCE_API: 及你的租户 ID 和上述作用域的客户端凭据令牌,并在过期之前重复使用(大约 30 分钟)。一个令牌覆盖一个实例(租户);对于暂存和生产,需安装两次连接器。
从哪里开始:salesforce_commerce_cloud_list_orders(最新的在前,按状态和日期过滤),然后是 salesforce_commerce_cloud_get_order。对于产品,使用 salesforce_commerce_cloud_search_products 进行短语搜索,然后是 salesforce_commerce_cloud_get_product。
订单:salesforce_commerce_cloud_list_orders,salesforce_commerce_cloud_get_order。状态:salesforce_commerce_cloud_update_order_shipping_status,salesforce_commerce_cloud_update_order_export_status(OMS 或 ERP 标记已导出的订单;这会最终确定它们的库存),salesforce_commerce_cloud_update_order_confirmation_status,salesforce_commerce_cloud_update_order_external_status。salesforce_commerce_cloud_update_order_status(可以取消或失败订单)和 salesforce_commerce_cloud_update_order_payment_status 默认关闭。没有工具会退款、捕获或以其他方式转移资金,也没有工具会创建订单。
产品和目录:salesforce_commerce_cloud_search_products(ID 和名称中的短语),salesforce_commerce_cloud_query_products(完整查询:catalogId、categoryId、lastModified、online、type),salesforce_commerce_cloud_get_product,salesforce_commerce_cloud_list_product_variations,salesforce_commerce_cloud_update_product,salesforce_commerce_cloud_list_catalogs,salesforce_commerce_cloud_list_categories,salesforce_commerce_cloud_get_category。文本字段是本地化对象(default 加上 de-DE 等语言环境);在线和可搜索标志按站点设置。
库存:salesforce_commerce_cloud_get_inventory_list,salesforce_commerce_cloud_get_inventory_record 和 salesforce_commerce_cloud_update_inventory_record 在 B2C 库存列表(Merchant Tools,Products and Catalogs,Inventory)中按列表 ID 和产品 ID 工作;没有调用列出列表的所有记录。全渠道库存(OCI)不在覆盖范围内。
客户:salesforce_commerce_cloud_search_customers(客户编号、电子邮件、姓名、公司中的短语),salesforce_commerce_cloud_get_customer,salesforce_commerce_cloud_list_customer_addresses 和 salesforce_commerce_cloud_list_customer_groups。客户列表通常以站点命名;请参阅 Merchant Tools,Customers,Customer Lists。
站点和 ID:连接器上设置的站点 ID(SFCC_SITE_ID)在工具的 site_id 被省略时使用;没有一个则订单调用失败。产品、类别和订单 ID 是字符串;orderNo 是购物者看到的数字。时间为 UTC 的 ISO 8601 格式。
分页和限制:列表接受 limit 和 offset(订单、产品和客户搜索每页最多 200 个,目录、类别、变体、地址和组每页最多 50 个)。订单列表不返回总数,并在 offset 加 limit 10,000 时停止:按日期缩小。搜索答案携带总数。Salesforce 限制繁忙的实例:429 会带有 Retry-After(以秒为单位),503 意味着负载削减,504 意味着调用超过 60 秒。错误是带有 title 和 detail 的问题文档;403 的 "Access denied for organization" 意味着租户 ID 或角色租户过滤器错误,某个 API 上的 403 意味着其作用域在 API 客户端中缺失。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Salesforce Commerce Cloud。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
salesforce_commerce_cloud_list_orders | 列出站点的订单,默认按最新排序:orderNo、status、paymentStatus、shippingStatus、exportStatus、confirmationStatus… |
salesforce_commerce_cloud_get_order | 按订单编号获取一个订单:statuses、customerInfo(customerNo、email)、billingAddress、productItems(productId、productName、quantity… |
salesforce_commerce_cloud_update_order_shipping_status | 设置订单的运输状态:not_shipped、part_shipped 或 shipped。返回 204。购物者不会通过此调用收到通知 |
salesforce_commerce_cloud_update_order_export_status | 设置订单的导出状态(你的 OMS 或 ERP 是否已提取):not_exported、ready、exported 或 failed。设置 exported… |
salesforce_commerce_cloud_update_order_confirmation_status | 设置订单的确认状态:confirmed 或 not_confirmed。返回 204 |
salesforce_commerce_cloud_update_order_external_status | 设置订单的外部状态,这是你的 OMS 或 ERP 使用的自由值(例如 IN_PICKING)。返回 204 |
salesforce_commerce_cloud_update_order_status | 设置订单状态:created、new、completed、cancelled、failed 或 failed_with_reopen。取消或失败订单会释放其… |
salesforce_commerce_cloud_update_order_payment_status | 设置订单的支付状态标志:not_paid、part_paid 或 paid。它只更改标志(没有资金转移),但财务和 OMS… |
salesforce_commerce_cloud_search_products | 按 ID 和名称中的短语搜索产品(Admin Products API):总数和命中,包括 ID、名称、类型(主、变体、项目、集合… |
salesforce_commerce_cloud_query_products | 使用完整的 Salesforce 搜索查询搜索产品:term、text、range 和 bool 查询,基于 ID、名称、在线、可搜索、类型… |
salesforce_commerce_cloud_get_product | 按 ID 获取一个产品:名称、描述、类型、品牌、ean、upc、制造商、在线和每个站点的可搜索性、价格和货币、ats 和… |
salesforce_commerce_cloud_list_product_variations | 列出主产品的变体:productId、variationValues(例如颜色和尺寸)和在线标志。每页最多 50 个 |
salesforce_commerce_cloud_update_product | 更改产品字段(部分:仅发送的字段)。文本字段是本地化对象,例如 ` |
salesforce_commerce_cloud_list_catalogs | 列出实例的目录:id、名称、描述、在线、isMasterCatalog、assignedSites、rootCategory 以及类别和产品… |
salesforce_commerce_cloud_list_categories | 列出目录的类别:id、名称、parentCategoryId、在线、位置、描述和页面元数据。每页最多 50 个 |
salesforce_commerce_cloud_get_category | 获取一个目录的类别及其子类别,直到给定深度:id、名称、在线、parentCategoryId、类别和页面… |
salesforce_commerce_cloud_get_inventory_list | 获取一个 B2C 库存列表:id、描述、defaultInStockFlag、useBundleInventoryOnly 以及分配给它的站点 |
salesforce_commerce_cloud_get_inventory_record | 获取一个产品在一个库存列表中的库存:分配(数量、重置日期)、库存水平、ats(可销售)、周转… |
salesforce_commerce_cloud_update_inventory_record | 设置一个产品在一个库存列表中的库存分配(部分更新)。分配替换当前数量;ats 然后… |
salesforce_commerce_cloud_search_customers | 按客户编号、电子邮件、名字、姓氏或公司中的短语搜索注册客户:总数和命中包括… |
salesforce_commerce_cloud_get_customer | 获取一个注册客户:customerNo、email、firstName、lastName、电话号码、生日、性别、公司名称、创建日期… |
salesforce_commerce_cloud_list_customer_addresses | 列出客户的保存地址:addressId、firstName、lastName、address1、address2、city、postalCode、stateCode、countryCode、phone… |
salesforce_commerce_cloud_list_customer_groups | 列出站点的客户组:id、描述、类型(静态或动态)和规则。每页最多 50 个 |
示例提示
- "今天在站点 RefArch 下的订单有哪些,哪些尚未导出?"
- "显示订单 00012345 及其运输和支付状态。"
- "在类别 womens-shoes 中找到库存少于 10 个单位的产品。"
- "将产品 701644031206M 在库存列表 inventory_m 中的库存设置为 40。"
- "我们有哪些客户组?"
常见问题
这是 Salesforce CRM 连接器吗? 不是。这是通过 Salesforce Commerce API (SCAPI) 管理 API 访问 Salesforce B2C Commerce Cloud。Sales Cloud 和 CRM 有自己的 Salesforce 连接器和指南。
需要什么? 一个具有 Salesforce Commerce API 角色的账户管理 API 客户端,适用于你的租户和列出的作用域,以及来自 Business Manager 的短代码、租户 ID 和站点 ID。账户管理管理员进行设置。
哪些工具默认关闭? salesforce_commerce_cloud_update_order_status 和 salesforce_commerce_cloud_update_order_payment_status。仅在 AI 应该更改这些状态时,在连接器页面上将它们打开。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?