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 Microsoft Copilot 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 Microsoft Copilot. 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.
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 + 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.
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.
- 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 esempiof_ecom_zzrf_001). Il tenant id è la parte dopof_ecom_(quizzrf_001). - 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 tokenclient_secret_basic. - Sotto Ruoli aggiungi
Salesforce Commerce APIe, come filtro tenant, il tuo tenant id. - 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. - Inserisci lo short code in
SFCC_SHORT_CODE, il tenant id inSFCC_TENANT_ID, il site id (ad esempioRefArch, da Merchant Tools, Siti) inSFCC_SITE_ID, e l'API client id e la password inSFCC_CLIENT_IDeSFCC_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 Microsoft Copilot
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 mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Salesforce Commerce Cloud. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
salesforce_commerce_cloud_list_orders | Elenca gli ordini di un sito, i più recenti per primi per default: orderNo, status, paymentStatus, shippingStatus, exportStatus, confirmationStatus… |
salesforce_commerce_cloud_get_order | Ottieni un ordine per numero d'ordine: stati, customerInfo (customerNo, email), billingAddress, productItems (productId, productName, quantity… |
salesforce_commerce_cloud_update_order_shipping_status | Imposta 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_status | Imposta 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_status | Imposta lo stato di conferma di un ordine: confirmed o not_confirmed. Risponde 204 |
salesforce_commerce_cloud_update_order_external_status | Imposta 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_status | Imposta 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_status | Imposta 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_products | Cerca 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_products | Cerca prodotti con una query di ricerca Salesforce completa: term, text, range e bool queries su id, nome, online, searchable, type… |
salesforce_commerce_cloud_get_product | Ottieni 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_variations | Elenca 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_product | Cambia i campi del prodotto (parziale: solo i campi inviati). I campi di testo sono oggetti localizzati come ` |
salesforce_commerce_cloud_list_catalogs | Elenca i cataloghi dell'istanza: id, nome, descrizione, online, isMasterCatalog, assignedSites, rootCategory e la categoria e prodotto… |
salesforce_commerce_cloud_list_categories | Elenca le categorie di un catalogo: id, nome, parentCategoryId, online, posizione, descrizione e metadati della pagina. Fino a 50 per pagina |
salesforce_commerce_cloud_get_category | Ottieni 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_list | Ottieni una lista di inventario B2C: id, descrizione, defaultInStockFlag, useBundleInventoryOnly e i siti a cui è assegnata |
salesforce_commerce_cloud_get_inventory_record | Ottieni lo stock di un prodotto in una lista di inventario: allocazione (amount, resetDate), stockLevel, ats (available to sell), turnover… |
salesforce_commerce_cloud_update_inventory_record | Imposta 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_customers | Cerca clienti registrati di una lista clienti tramite una frase in customerNo, email, nome, cognome o azienda: totale e hits con… |
salesforce_commerce_cloud_get_customer | Ottieni un cliente registrato: customerNo, email, firstName, lastName, numeri di telefono, compleanno, genere, companyName, creationDate… |
salesforce_commerce_cloud_list_customer_addresses | Elenca gli indirizzi salvati di un cliente: addressId, firstName, lastName, address1, address2, city, postalCode, stateCode, countryCode, phone… |
salesforce_commerce_cloud_list_customer_groups | Elenca 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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?