Summary
Salesforce B2C Commerce Cloud through the Salesforce Commerce API (SCAPI) Admin APIs: orders and their statuses, product search and edits, catalogs and categories, inventory list records and registered customers. Account Manager API client (client credentials), short code, tenant id and site id.
Guided setup
Connect Salesforce Commerce Cloud to Gemini in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Salesforce Commerce Cloud in the guided setup, then add your MCP URL to Gemini. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Salesforce Commerce Cloud
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Salesforce Commerce Cloud, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Salesforce Commerce Cloud + Gemini
Salesforce B2C Commerce Cloud through the Salesforce Commerce API (SCAPI) Admin APIs: orders and their statuses, product search and edits, catalogs and categories, inventory list records and registered customers. Account Manager API client (client credentials), short code, tenant id and site id.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SFCC_SHORT_CODE, SFCC_TENANT_ID, SFCC_CLIENT_ID, SFCC_CLIENT_SECRET
Step 1 — Get credentials
Setting up takes about 15 minutes. You need the needs an Account Manager administrator.
- In Business Manager open Administration, Site Development, Salesforce Commerce API Settings and note the Short Code (8 characters) and the Organization ID (
f_ecom_followed by the tenant id, for examplef_ecom_zzrf_001). The tenant id is the part afterf_ecom_(herezzrf_001). - In Account Manager (
https://account.demandware.com) open API Client, Add API Client. Set a password (this becomes the client secret) and token endpoint auth methodclient_secret_basic. - Under Roles add
Salesforce Commerce APIand, as its tenant filter, your tenant id. - Under Allowed Scopes (and Default Scopes) add exactly:
sfcc.orders.rw sfcc.products.rw sfcc.catalogs sfcc.inventory-lists.rw sfcc.customerlists sfcc.customergroups. Save and make sure the client is active. - Enter the short code in
SFCC_SHORT_CODE, the tenant id inSFCC_TENANT_ID, the site id (for exampleRefArch, from Merchant Tools, Sites) inSFCC_SITE_ID, and the API client id and password inSFCC_CLIENT_IDandSFCC_CLIENT_SECRET.
The connector asks https://account.demandware.com/dwsso/oauth2/access_token for a client-credentials token with the scope SALESFORCE_COMMERCE_API: plus your tenant id and the scopes above, and reuses it until it expires (about 30 minutes). One token covers one instance (tenant); for staging and production install the connector twice.
Where to start: salesforce_commerce_cloud_list_orders (newest first, filter by status and date), then salesforce_commerce_cloud_get_order. For products salesforce_commerce_cloud_search_products with a phrase, then salesforce_commerce_cloud_get_product.
Orders: salesforce_commerce_cloud_list_orders, salesforce_commerce_cloud_get_order. Statuses: salesforce_commerce_cloud_update_order_shipping_status, salesforce_commerce_cloud_update_order_export_status (an OMS or ERP marks orders exported; this finalizes their inventory), salesforce_commerce_cloud_update_order_confirmation_status, salesforce_commerce_cloud_update_order_external_status. salesforce_commerce_cloud_update_order_status (can cancel or fail an order) and salesforce_commerce_cloud_update_order_payment_status are installed switched off. No tool refunds, captures or otherwise moves money, and none creates orders.
Products and catalogs: salesforce_commerce_cloud_search_products (phrase in id and name), salesforce_commerce_cloud_query_products (full query: 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. Text fields are localized objects (default plus locales such as de-DE); online and searchable flags are per site.
Inventory: salesforce_commerce_cloud_get_inventory_list, salesforce_commerce_cloud_get_inventory_record and salesforce_commerce_cloud_update_inventory_record work on B2C inventory lists (Merchant Tools, Products and Catalogs, Inventory) by list id and product id; there is no call to list all records of a list. Omnichannel Inventory (OCI) is not covered.
Customers: salesforce_commerce_cloud_search_customers (phrase in customer number, e-mail, names, company), salesforce_commerce_cloud_get_customer, salesforce_commerce_cloud_list_customer_addresses and salesforce_commerce_cloud_list_customer_groups. Customer lists are often named after the site; see Merchant Tools, Customers, Customer Lists.
Site and ids: the site id set on the connector (SFCC_SITE_ID) is used when a tool's site_id is left out; order calls fail without one. Product, category and order ids are strings; the orderNo is the number the shopper sees. Times are ISO 8601 in UTC.
Paging and limits: lists take limit and offset (orders, product and customer search up to 200 per page, catalogs, categories, variations, addresses and groups up to 50). Order lists return no total and stop at offset plus limit 10,000: narrow by date. Search answers carry total. Salesforce throttles busy instances: 429 comes with Retry-After in seconds, 503 means load shedding, 504 means the call took longer than 60 seconds. Errors are problem documents with title and detail; 403 with "Access denied for organization" means the tenant id or the role tenant filter is wrong, and a 403 on one API means its scope is missing from the API client.
Step 2 — Install the adapter
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
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
Salesforce Commerce Cloudtools.
Available tools
| Tool | What it does |
|---|---|
salesforce_commerce_cloud_list_orders | List the orders of a site, newest first by default: orderNo, status, paymentStatus, shippingStatus, exportStatus, confirmationStatus… |
salesforce_commerce_cloud_get_order | Get one order by order number: statuses, customerInfo (customerNo, email), billingAddress, productItems (productId, productName, quantity… |
salesforce_commerce_cloud_update_order_shipping_status | Set the shipping status of an order: not_shipped, part_shipped or shipped. Answers 204. The shopper is not notified by this call |
salesforce_commerce_cloud_update_order_export_status | Set the export status of an order (whether your OMS or ERP picked it up): not_exported, ready, exported or failed. Setting exported… |
salesforce_commerce_cloud_update_order_confirmation_status | Set the confirmation status of an order: confirmed or not_confirmed. Answers 204 |
salesforce_commerce_cloud_update_order_external_status | Set the external status of an order, a free value your OMS or ERP uses (for example IN_PICKING). Answers 204 |
salesforce_commerce_cloud_update_order_status | Set the order status: created, new, completed, cancelled, failed or failed_with_reopen. Cancelling or failing an order releases its… |
salesforce_commerce_cloud_update_order_payment_status | Set the payment status flag of an order: not_paid, part_paid or paid. It only changes the flag (no money moves), but finance and OMS… |
salesforce_commerce_cloud_search_products | Search products by a phrase in their id and name (Admin Products API): total and hits with id, name, type (master, variant, item, set… |
salesforce_commerce_cloud_query_products | Search products with a full Salesforce search query: term, text, range and bool queries on id, name, online, searchable, type… |
salesforce_commerce_cloud_get_product | Get one product by id: name, descriptions, type, brand, ean, upc, manufacturer, online and searchable per site, price and currency, ats and… |
salesforce_commerce_cloud_list_product_variations | List the variants of a master product: productId, variationValues (for example color and size) and online flag. Up to 50 per page |
salesforce_commerce_cloud_update_product | Change product fields (partial: only the fields sent). Text fields are localized objects such as ` |
salesforce_commerce_cloud_list_catalogs | List the catalogs of the instance: id, name, description, online, isMasterCatalog, assignedSites, rootCategory and the category and product… |
salesforce_commerce_cloud_list_categories | List the categories of a catalog: id, name, parentCategoryId, online, position, description and page metadata. Up to 50 per page |
salesforce_commerce_cloud_get_category | Get one category of a catalog with its subcategories down to the given depth: id, name, online, parentCategoryId, categories and page… |
salesforce_commerce_cloud_get_inventory_list | Get one B2C inventory list: id, description, defaultInStockFlag, useBundleInventoryOnly and the sites it is assigned to |
salesforce_commerce_cloud_get_inventory_record | Get the stock of one product in one inventory list: allocation (amount, resetDate), stockLevel, ats (available to sell), turnover… |
salesforce_commerce_cloud_update_inventory_record | Set the stock allocation of one product in one inventory list (partial update). The allocation replaces the current amount; ats then… |
salesforce_commerce_cloud_search_customers | Search registered customers of a customer list by a phrase in customerNo, email, first name, last name or company: total and hits with… |
salesforce_commerce_cloud_get_customer | Get one registered customer: customerNo, email, firstName, lastName, phone numbers, birthday, gender, companyName, creationDate… |
salesforce_commerce_cloud_list_customer_addresses | List the saved addresses of a customer: addressId, firstName, lastName, address1, address2, city, postalCode, stateCode, countryCode, phone… |
salesforce_commerce_cloud_list_customer_groups | List the customer groups of a site: id, description, type (static or dynamic) and rule. Up to 50 per page |
Example prompts
- "Which orders of site RefArch were placed today, and which are not exported yet?"
- "Show order 00012345 with its shipping and payment status."
- "Find products in the category womens-shoes with less than 10 units in the inventory list."
- "Set the stock of product 701644031206M in inventory list inventory_m to 40."
- "Which customer groups do we have?"
FAQ
Is this the Salesforce CRM connector? No. This is for Salesforce B2C Commerce Cloud through the Salesforce Commerce API (SCAPI) Admin APIs. Sales Cloud and the CRM have their own Salesforce connector and guides.
What does it need? An Account Manager API client with the Salesforce Commerce API role for your tenant and the listed scopes, plus the short code, tenant id and site id from Business Manager. An Account Manager administrator sets it up.
Which tools install switched off? salesforce_commerce_cloud_update_order_status and salesforce_commerce_cloud_update_order_payment_status. Switch them on on the connector page only if the AI should change those statuses.
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?