Guida al connettore9 minuti di lettura23 tool MCP7 lingue

Salesforce Commerce Cloud MCP con Gemini CLI

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

HCA cura del team HelpCodeAggiornato 9 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Salesforce Commerce Cloud

Salesforce Commerce Cloud

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.

tool

23

Regione

INTL

Categoria

E-commerce

Autenticazione

OAuth 2.0

Env vars richieste

SFCC_SHORT_CODESFCC_TENANT_IDSFCC_CLIENT_IDSFCC_CLIENT_SECRET
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Configurazione guidata

Collega Salesforce Commerce Cloud a Gemini in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Salesforce Commerce Cloud con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Prova a chiedere

Prompt di esempio per Salesforce Commerce Cloud

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Salesforce Commerce Cloud · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Salesforce Commerce Cloud, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Salesforce Commerce Cloud + Gemini

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Requisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

SFCC_SHORT_CODE, SFCC_TENANT_ID, SFCC_CLIENT_ID, SFCC_CLIENT_SECRET

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 15 minuti. Hai bisogno di un amministratore di Account Manager.

  1. In Business Manager apri Amministrazione, Sviluppo Sito, Impostazioni API Salesforce Commerce e annota il Short Code (8 caratteri) e l'ID Organizzazione (f_ecom_ seguito dal tenant id, ad esempio f_ecom_zzrf_001). Il tenant id è la parte dopo f_ecom_ (qui zzrf_001).
  2. In Account Manager (https://account.demandware.com) apri Client API, Aggiungi Client API. Imposta una password (questo diventa il client secret) e il metodo di autenticazione dell'endpoint token client_secret_basic.
  3. Sotto Ruoli aggiungi Salesforce Commerce API e, come filtro tenant, il tuo tenant id.
  4. Sotto Scope Consentiti (e Scope Predefiniti) aggiungi esattamente: sfcc.orders.rw sfcc.products.rw sfcc.catalogs sfcc.inventory-lists.rw sfcc.customerlists sfcc.customergroups. Salva e assicurati che il client sia attivo.
  5. Inserisci lo short code in SFCC_SHORT_CODE, il tenant id in SFCC_TENANT_ID, il site id (ad esempio RefArch, da Merchant Tools, Siti) in SFCC_SITE_ID, e l'API client id e la password in SFCC_CLIENT_ID e SFCC_CLIENT_SECRET.

Il connettore richiede https://account.demandware.com/dwsso/oauth2/access_token per un token di credenziali client con lo scope SALESFORCE_COMMERCE_API: più il tuo tenant id e gli scope sopra, e lo riutilizza fino alla scadenza (circa 30 minuti). Un token copre un'istanza (tenant); per staging e produzione installa il connettore due volte.

Dove iniziare: salesforce_commerce_cloud_list_orders (i più recenti per primi, filtra per stato e data), poi salesforce_commerce_cloud_get_order. Per i prodotti salesforce_commerce_cloud_search_products con una frase, poi salesforce_commerce_cloud_get_product.

Ordini: salesforce_commerce_cloud_list_orders, salesforce_commerce_cloud_get_order. Stati: salesforce_commerce_cloud_update_order_shipping_status, salesforce_commerce_cloud_update_order_export_status (un OMS o ERP segna gli ordini esportati; questo finalizza il loro inventario), salesforce_commerce_cloud_update_order_confirmation_status, salesforce_commerce_cloud_update_order_external_status. salesforce_commerce_cloud_update_order_status (può annullare o fallire un ordine) e salesforce_commerce_cloud_update_order_payment_status sono installati disattivati. Nessun strumento rimborsa, cattura o sposta denaro, e nessuno crea ordini.

Prodotti e cataloghi: salesforce_commerce_cloud_search_products (frase in id e nome), salesforce_commerce_cloud_query_products (query completa: 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. I campi di testo sono oggetti localizzati (default più localizzazioni come de-DE); i flag online e ricercabili sono per sito.

Inventario: salesforce_commerce_cloud_get_inventory_list, salesforce_commerce_cloud_get_inventory_record e salesforce_commerce_cloud_update_inventory_record funzionano su liste di inventario B2C (Merchant Tools, Prodotti e Cataloghi, Inventario) per id lista e id prodotto; non c'è chiamata per elencare tutti i record di una lista. L'Inventario Omnicanale (OCI) non è coperto.

Clienti: salesforce_commerce_cloud_search_customers (frase in numero cliente, e-mail, nomi, azienda), salesforce_commerce_cloud_get_customer, salesforce_commerce_cloud_list_customer_addresses e salesforce_commerce_cloud_list_customer_groups. Le liste clienti sono spesso nominate in base al sito; consulta Merchant Tools, Clienti, Liste Clienti.

Sito e id: l'id del sito impostato sul connettore (SFCC_SITE_ID) viene utilizzato quando l'site_id di uno strumento è omesso; le chiamate agli ordini falliscono senza uno. Gli id di prodotto, categoria e ordine sono stringhe; l'orderNo è il numero che il cliente vede. I tempi sono in ISO 8601 in UTC.

Paging e limiti: le liste prendono limit e offset (ordini, ricerca prodotti e clienti fino a 200 per pagina, cataloghi, categorie, variazioni, indirizzi e gruppi fino a 50). Le liste di ordini non restituiscono un totale e si fermano a offset più limit 10.000: restringi per data. Le risposte di ricerca portano il totale. Salesforce limita le istanze occupate: 429 viene con Retry-After in secondi, 503 significa carico eccessivo, 504 significa che la chiamata ha impiegato più di 60 secondi. Gli errori sono documenti di problema con title e detail; 403 con "Accesso negato per l'organizzazione" significa che il tenant id o il filtro tenant del ruolo è errato, e un 403 su una API significa che il suo scope manca dal client API.

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
  2. Salva il file e riavvia gemini.
  3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
  4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Salesforce Commerce Cloud.

Strumenti disponibili

StrumentoCosa fa
salesforce_commerce_cloud_list_ordersElenca gli ordini di un sito, i più recenti per primi per default: orderNo, status, paymentStatus, shippingStatus, exportStatus, confirmationStatus…
salesforce_commerce_cloud_get_orderOttieni un ordine per numero d'ordine: stati, customerInfo (customerNo, email), billingAddress, productItems (productId, productName, quantity…
salesforce_commerce_cloud_update_order_shipping_statusImposta lo stato di spedizione di un ordine: not_shipped, part_shipped o shipped. Risponde 204. Il cliente non viene notificato da questa chiamata
salesforce_commerce_cloud_update_order_export_statusImposta lo stato di esportazione di un ordine (se il tuo OMS o ERP lo ha preso in carico): not_exported, ready, exported o failed. Impostando exported…
salesforce_commerce_cloud_update_order_confirmation_statusImposta lo stato di conferma di un ordine: confirmed o not_confirmed. Risponde 204
salesforce_commerce_cloud_update_order_external_statusImposta lo stato esterno di un ordine, un valore libero utilizzato dal tuo OMS o ERP (ad esempio IN_PICKING). Risponde 204
salesforce_commerce_cloud_update_order_statusImposta lo stato dell'ordine: created, new, completed, cancelled, failed o failed_with_reopen. Annullare o fallire un ordine libera il…
salesforce_commerce_cloud_update_order_payment_statusImposta il flag dello stato di pagamento di un ordine: not_paid, part_paid o paid. Cambia solo il flag (non si muovono soldi), ma finanza e OMS…
salesforce_commerce_cloud_search_productsCerca prodotti tramite una frase nel loro id e nome (Admin Products API): totale e hits con id, nome, tipo (master, variant, item, set…
salesforce_commerce_cloud_query_productsCerca prodotti con una query di ricerca Salesforce completa: term, text, range e bool queries su id, nome, online, searchable, type…
salesforce_commerce_cloud_get_productOttieni un prodotto per id: nome, descrizioni, tipo, marca, ean, upc, produttore, online e ricercabile per sito, prezzo e valuta, ats e…
salesforce_commerce_cloud_list_product_variationsElenca le varianti di un prodotto master: productId, variationValues (ad esempio colore e taglia) e flag online. Fino a 50 per pagina
salesforce_commerce_cloud_update_productCambia i campi del prodotto (parziale: solo i campi inviati). I campi di testo sono oggetti localizzati come `
salesforce_commerce_cloud_list_catalogsElenca i cataloghi dell'istanza: id, nome, descrizione, online, isMasterCatalog, assignedSites, rootCategory e la categoria e prodotto…
salesforce_commerce_cloud_list_categoriesElenca le categorie di un catalogo: id, nome, parentCategoryId, online, posizione, descrizione e metadati della pagina. Fino a 50 per pagina
salesforce_commerce_cloud_get_categoryOttieni una categoria di un catalogo con le sue sottocategorie fino alla profondità data: id, nome, online, parentCategoryId, categorie e pagina…
salesforce_commerce_cloud_get_inventory_listOttieni una lista di inventario B2C: id, descrizione, defaultInStockFlag, useBundleInventoryOnly e i siti a cui è assegnata
salesforce_commerce_cloud_get_inventory_recordOttieni lo stock di un prodotto in una lista di inventario: allocazione (amount, resetDate), stockLevel, ats (available to sell), turnover…
salesforce_commerce_cloud_update_inventory_recordImposta l'allocazione di stock di un prodotto in una lista di inventario (aggiornamento parziale). L'allocazione sostituisce l'importo attuale; ats poi…
salesforce_commerce_cloud_search_customersCerca clienti registrati di una lista clienti tramite una frase in customerNo, email, nome, cognome o azienda: totale e hits con…
salesforce_commerce_cloud_get_customerOttieni un cliente registrato: customerNo, email, firstName, lastName, numeri di telefono, compleanno, genere, companyName, creationDate…
salesforce_commerce_cloud_list_customer_addressesElenca gli indirizzi salvati di un cliente: addressId, firstName, lastName, address1, address2, city, postalCode, stateCode, countryCode, phone…
salesforce_commerce_cloud_list_customer_groupsElenca i gruppi clienti di un sito: id, descrizione, tipo (statico o dinamico) e regola. Fino a 50 per pagina

Esempi di prompt

  • "Quali ordini del sito RefArch sono stati effettuati oggi, e quali non sono ancora stati esportati?"
  • "Mostra l'ordine 00012345 con il suo stato di spedizione e pagamento."
  • "Trova prodotti nella categoria womens-shoes con meno di 10 unità nella lista di inventario."
  • "Imposta lo stock del prodotto 701644031206M nella lista di inventario inventory_m a 40."
  • "Quali gruppi clienti abbiamo?"

FAQ

Questo è il connettore per Salesforce CRM? No. Questo è per Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI). Sales Cloud e il CRM hanno il loro connettore Salesforce e guide.

Di cosa ha bisogno? Un client API Account Manager con il ruolo Salesforce Commerce API per il tuo tenant e gli scope elencati, più lo short code, tenant id e site id da Business Manager. Un amministratore di Account Manager lo configura.

Quali strumenti sono installati disattivati? salesforce_commerce_cloud_update_order_status e salesforce_commerce_cloud_update_order_payment_status. Attivali nella pagina del connettore solo se l'AI deve cambiare quegli stati.

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

Questa guida ti è stata utile?

Collega Salesforce Commerce Cloud a Gemini in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Salesforce Commerce Cloud con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. Senza codice e senza server da gestire.

Guide correlate

Connettori

Salesforce Commerce Cloud MCP con ChatGPT

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Connettori

Salesforce Commerce Cloud MCP con Claude

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Connettori

Salesforce Commerce Cloud MCP con Microsoft Copilot

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Connettori

Salesforce Commerce Cloud MCP con Cursor

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Connettori

Salesforce Commerce Cloud MCP con Meta Muse

Salesforce B2C Commerce Cloud attraverso le API Admin del Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche dei prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), short code, tenant id e site id.

Connettori

Salesforce Commerce Cloud MCP per Claude e ChatGPT

Salesforce B2C Commerce Cloud tramite le API Admin di Salesforce Commerce API (SCAPI): ordini e i loro stati, ricerca e modifiche ai prodotti, cataloghi e categorie, registri delle liste di inventario e clienti registrati. Client API Account Manager (credenziali client), codice breve, tenant id e site id.