摘要
通过 Salesforce Commerce API (SCAPI) 管理 API 访问 Salesforce B2C Commerce Cloud:订单及其状态、产品搜索和编辑、目录和类别、库存列表记录和注册客户。账户管理 API 客户端(客户端凭证)、短代码、租户 ID 和站点 ID。
引导式设置
2 分钟将 Salesforce Commerce Cloud 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Salesforce Commerce Cloud,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
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
通过 Salesforce Commerce API (SCAPI) 管理 API 访问 Salesforce B2C Commerce Cloud:订单及其状态、产品搜索和编辑、目录和类别、库存列表记录和注册客户。账户管理 API 客户端(客户端凭证)、短代码、租户 ID 和站点 ID。
设置
设置大约需要 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中输入短代码,在SFCC_TENANT_ID中输入租户 ID,在SFCC_SITE_ID中输入站点 ID(例如RefArch,来自 Merchant Tools,Sites),在SFCC_CLIENT_ID和SFCC_CLIENT_SECRET中输入 API 客户端 ID 和密码。
连接器请求 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 通过列表 ID 和产品 ID 在 B2C 库存列表(Merchant Tools,Products and Catalogs,Inventory)上工作;没有调用列出列表的所有记录。全渠道库存(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 客户端。
先决条件:SFCC_SHORT_CODE,SFCC_TENANT_ID,SFCC_CLIENT_ID,SFCC_CLIENT_SECRET
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 Salesforce Commerce Cloud 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
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、name、type(master、variant、item、set… |
salesforce_commerce_cloud_query_products | 使用完整的 Salesforce 搜索查询搜索产品:term、text、range 和 bool 查询,针对 id、name、online、searchable、type… |
salesforce_commerce_cloud_get_product | 通过 ID 获取一个产品:name、descriptions、type、brand、ean、upc、manufacturer、online 和 per site 的 searchable、price 和 currency、ats 和… |
salesforce_commerce_cloud_list_product_variations | 列出主产品的变体:productId、variationValues(例如颜色和尺寸)和在线标志。每页最多 50 个 |
salesforce_commerce_cloud_update_product | 更改产品字段(部分:仅发送的字段)。文本字段是本地化对象,例如 ` |
salesforce_commerce_cloud_list_catalogs | 列出实例的目录:id、name、description、online、isMasterCatalog、assignedSites、rootCategory 以及类别和产品… |
salesforce_commerce_cloud_list_categories | 列出目录的类别:id、name、parentCategoryId、online、position、description 和页面元数据。每页最多 50 个 |
salesforce_commerce_cloud_get_category | 获取一个目录的一个类别及其子类别,直到给定深度:id、name、online、parentCategoryId、categories 和页面… |
salesforce_commerce_cloud_get_inventory_list | 获取一个 B2C 库存列表:id、description、defaultInStockFlag、useBundleInventoryOnly 及其分配的站点 |
salesforce_commerce_cloud_get_inventory_record | 获取一个产品在一个库存列表中的库存:allocation(amount、resetDate)、stockLevel、ats(可售)、turnover… |
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、description、type(静态或动态)和规则。每页最多 50 个 |
示例提示
- "今天 RefArch 站点的订单有哪些,哪些尚未导出?"
- "显示订单 00012345 及其发货和支付状态。"
- "在 womens-shoes 类别中找到库存少于 10 个单位的产品。"
- "将产品 701644031206M 在库存列表 inventory_m 中的库存设置为 40。"
- "我们有哪些客户组?"
下一步
这份指南对你有帮助吗?