Кратко
Salesforce B2C Commerce Cloud через Salesforce Commerce API (SCAPI) Admin APIs: заказы и их статусы, поиск и редактирование продуктов, каталоги и категории, записи списка запасов и зарегистрированные клиенты. Клиент API Account Manager (учетные данные клиента), короткий код, идентификатор арендатора и идентификатор сайта.
Пошаговая настройка
Подключи Salesforce Commerce Cloud к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Salesforce Commerce Cloud в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Salesforce Commerce Cloud
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Salesforce Commerce Cloud, вставь свои учетные данные, создай ключ API MCP, и все готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Salesforce Commerce Cloud
Salesforce B2C Commerce Cloud через Salesforce Commerce API (SCAPI) Admin APIs: заказы и их статусы, поиск и редактирование продуктов, каталоги и категории, записи списка запасов и зарегистрированные клиенты. Клиент API Account Manager (учетные данные клиента), короткий код, идентификатор арендатора и идентификатор сайта.
Настройка
Настройка занимает около 15 минут. Тебе нужен администратор Account Manager.
- В Business Manager открой Administration, Site Development, Salesforce Commerce API Settings и запомни Short Code (8 символов) и Organization ID (
f_ecom_, за которым следует идентификатор арендатора, напримерf_ecom_zzrf_001). Идентификатор арендатора — это часть послеf_ecom_(здесьzzrf_001). - В Account Manager (
https://account.demandware.com) открой API Client, Add API Client. Установи пароль (это станет секретом клиента) и метод аутентификации токенаclient_secret_basic. - В разделе Roles добавь
Salesforce Commerce APIи в качестве фильтра арендатора укажи свой идентификатор арендатора. - В разделе 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, идентификатор сайта (напримерRefArch, из Merchant Tools, Sites) вSFCC_SITE_ID, а идентификатор клиента API и пароль вSFCC_CLIENT_IDиSFCC_CLIENT_SECRET.
Коннектор запрашивает https://account.demandware.com/dwsso/oauth2/access_token для получения токена клиентских учетных данных с областью SALESFORCE_COMMERCE_API: плюс идентификатор арендатора и указанные выше области, и использует его до истечения срока действия (около 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 (фраза в идентификаторе и названии), 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) по идентификатору списка и идентификатору продукта; нет вызова для получения всех записей списка. Омниканальные запасы (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.
Сайт и идентификаторы: идентификатор сайта, установленный на коннекторе (SFCC_SITE_ID), используется, когда идентификатор сайта инструмента не указан; вызовы заказов завершаются неудачей без него. Идентификаторы продуктов, категорий и заказов являются строками; orderNo — это номер, который видит покупатель. Время указано в формате ISO 8601 в UTC.
Пагинация и лимиты: списки принимают лимит и смещение (заказы, поиск продуктов и клиентов до 200 на страницу, каталоги, категории, вариации, адреса и группы до 50). Списки заказов не возвращают общий итог и останавливаются на смещении плюс лимит 10,000: уточняй по дате. Ответы поиска содержат общий итог. Salesforce ограничивает загруженные экземпляры: 429 приходит с Retry-After в секундах, 503 означает сброс нагрузки, 504 означает, что вызов занял больше 60 секунд. Ошибки — это документы с проблемами с title и detail; 403 с "Доступ запрещен для организации" означает, что идентификатор арендатора или фильтр роли арендатора неверны, а 403 на одном API означает, что его область отсутствует в клиенте 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 | Получить один заказ по номеру заказа: статусы, 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 | Поиск продуктов по фразе в их идентификаторе и названии (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 и 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 | Поиск зарегистрированных клиентов списка клиентов по фразе в customerNo, email, first name, last name или company: всего и попаданий с… |
salesforce_commerce_cloud_get_customer | Получить одного зарегистрированного клиента: customerNo, email, firstName, lastName, номера телефонов, день рождения, пол, companyName, creationDate… |
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."
- "Какие группы клиентов у нас есть?"
Следующие шаги
Это руководство помогло?