Collegare SHEIN Seller MCP a Microsoft Copilot

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Venditore SHEIN, incolla l'App ID e l'App Secret, clicca su Authorize with Provider e approva con l'account principale del negozio su SHEIN, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Venditore SHEIN + Microsoft Copilot

Fai lavorare la tua IA con il tuo negozio venditore SHEIN: ordini, indirizzo dell'acquirente e caricamento del tracciamento, tracciamento dei pacchi, prodotti con prezzi e stock, aggiornamenti di stock e prezzi, categorie e attributi, casi post-vendita e resi.

Prerequisiti

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

SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

Passo 1 — Ottieni le credenziali

Cosa ti serve: un account sviluppatore della SHEIN Open Platform di tipo Venditore Auto-Sviluppato (verificato con le informazioni del commerciante del negozio), un'app approvata della modalità di cooperazione del negozio e l'account principale del negozio per approvarla. Circa 20 minuti di lavoro, più le revisioni di SHEIN dell'account e dell'app.

1. Registrati su https://open.sheincorp.com, scegli il tipo di sviluppatore Venditore Auto-Sviluppato e invia le informazioni del commerciante richieste (tutte sono nel backend del venditore). Il tipo non può essere cambiato una volta approvato.
2. Nella console apri Gestione Applicazioni e crea un'applicazione. Scegli il tipo di applicazione della modalità di cooperazione del negozio: Auto-Gestito o Semi-Gestito per un negozio di marketplace (un negozio in più modalità ha bisogno di un'app per modalità). Nome, icona e descrizione sono mostrati ai venditori e non possono essere modificati dopo l'invio. SHEIN esamina l'app; fino a quando non è approvata non ci sono App ID o App Secret validi.
3. Nella pagina dei dettagli dell'app controlla il Pacchetto di Permessi API: le API di ordine, prodotto, inventario, post-vendita e reso devono essere sottoscritte (di solito concesse con l'approvazione; altrimenti clicca su Richiedi Pacchetto di Permessi). Aggiungi l'indirizzo IP in uscita di questo server alla whitelist IP dell'app: SHEIN rifiuta le chiamate di produzione da qualsiasi altro indirizzo (openapi00002). Nella pagina di configurazione di AnythingMCP Cloud viene mostrato l'indirizzo.
4. Copia l'App ID in SHEIN_APP_ID e l'App Secret in SHEIN_APP_SECRET, e scegli l'indirizzo API per SHEIN_API_HOST: https://openapi.sheincorp.com per app auto-gestite e semi-gestite, https://openapi.sheincorp.cn per app completamente gestite, operate da SHEIN e altre app.
5. Installa il connettore e clicca su Authorize with Provider (l'ultimo passo della guida di configurazione lo fa). Si apre la pagina di SHEIN: accedi al backend del venditore con l'account principale del negozio e clicca sul pulsante di autorizzazione. SHEIN rimanda il browser a <SERVER_URL>/api/shein-auth/callback (su AnythingMCP Cloud: https://cloud.anythingmcp.com/api/shein-auth/callback) e il connettore recupera la chiave del negozio entro i 10 minuti consentiti da SHEIN.

La chiave del negozio: SHEIN fornisce l'openKeyId e il secretKey del negozio (il secretKey criptato con l'App Secret, che AnythingMCP decripta una sola volta); entrambi sono memorizzati in modo criptato nel connettore. SHEIN non documenta una durata e nessun rinnovo per essi. Un'autorizzazione termina quando il venditore dissocia l'app o reimposta la chiave, il negozio è chiuso, SHEIN la reimposta o la dissocia, o scade: le chiamate quindi falliscono con openapi00004 ("L'utente è scaduto"), il connettore mostra che ha bisogno di una nuova autorizzazione, e qualcuno clicca di nuovo su Authorize with Provider.

Come firma: ogni chiamata porta x-lt-openKeyId, x-lt-timestamp (millisecondi Unix) e x-lt-signature: cinque caratteri casuali seguiti dal Base64 dell'HMAC-SHA256 in minuscolo di openKeyId&timestamp&path, chiave con il secretKey più quei cinque caratteri. La query non è firmata. Un timestamp è valido per 5 minuti, quindi l'orologio del server deve essere corretto.

Da dove iniziare: shein_get_store_info controlla l'autorizzazione e nomina il negozio; shein_list_sites fornisce i codici dei siti e le valute.

• Ordini: shein_list_orders (una finestra di al massimo 48 ore è obbligatoria), poi shein_get_orders per un massimo di 30 alla volta. Solo gli ordini con stockMode 3 sono spediti dal venditore; printOrderStatus 1 significa che l'ordine può essere gestito ora.
• Spediscilo tu stesso: shein_get_order_address (handle_type 2 sposta anche l'ordine da spedire), shein_list_warehouse_addresses, shein_list_shipping_channels, poi shein_upload_tracking_numbers per pezzo (goodsId). shein_get_logistics_track segue il pacco. SHEIN segna l'ordine come spedito quando il corriere lo scansiona. shein_confirm_out_of_stock è disattivato all'installazione.
• Prodotti: shein_search_products (codici, stato di scaffale, prezzi, stock e blocchi di campagna), shein_list_products (tutti i codici), shein_get_product (un SPU completo). Per nuove inserzioni: shein_get_category_tree, shein_get_attribute_templates, shein_list_brands. shein_set_skc_shelf_status è disattivato all'installazione.
• Stock e prezzi: shein_list_warehouses, shein_get_stock, shein_update_stock (con una chiave di idempotenza per riga), shein_update_prices (gli aumenti possono attendere la revisione dei prezzi di SHEIN). shein_get_sku_sales fornisce le unità vendute per negozi gestiti.
• Post-vendita: shein_list_after_sales_orders e shein_get_after_sales_orders, shein_list_return_orders e shein_get_return_orders solo in lettura; shein_sign_return_order è disattivato all'installazione.

Codici, tempi e importi: i codici SPU, SKC e SKU (spuName, skcName, skuCode) sono di SHEIN; supplierCode e supplierSku sono quelli del venditore. Un SKU venduto più volte ha un goodsId per pezzo, e i numeri di tracciamento, le cancellazioni e le ricevute di reso funzionano per goodsId. I valori di goodsId sono numeri a 64 bit: il connettore legge ogni id troppo lungo per un numero JavaScript come testo con le sue cifre esatte, e gli strumenti prendono gli id come testo e li inviano a SHEIN come numeri, quindi copiali esattamente come un ordine o un reso li mostra. Le finestre di ordine, post-vendita e reso sono ora di Pechino (UTC+8) come yyyy-MM-dd HH:mm:ss; i dettagli dell'ordine rispondono con yyyy-MM-dd'T'HH:mm:ss.SSSZ, gli eventi di tracciamento con millisecondi Unix. Gli importi sono decimali nella valuta nominata accanto a loro (orderCurrency, currency, currencyCode).

Limiti: ogni API ha il proprio limite di chiamate al secondo per app (20 per la ricerca di prodotti, 30 a 300 per le altre), rispondendo con openapi00006 o 832213 quando superato. Le liste di ordini e resi paginano per 30, la ricerca di prodotti per 10; una finestra d'ordine restituisce al massimo 10.000 ordini, la lista di prodotti al massimo 50.000 codici. Lo stesso SKC e sito possono cambiare stato di scaffale una volta ogni 20 minuti.

Risposte ed errori: SHEIN risponde con code "0" e il risultato in info; qualsiasi altro code è un errore con msg e un traceId da citare al supporto SHEIN entro tre giorni. Il connettore richiede messaggi in inglese (language: en). openapi00001: la firma è stata rifiutata; con un orologio del server corretto questo significa che la chiave del negozio è cambiata (ri-autorizzata o reimpostata altrove), quindi autorizza di nuovo. openapi00002: l'indirizzo IP di questo server non è sulla whitelist dell'app. openapi00003: l'app non ha permessi per questa API, l'API non è per la modalità del negozio, o l'account sviluppatore è disabilitato. openapi00004: l'autorizzazione è terminata; autorizza di nuovo. Le chiamate di scrittura che richiedono una lista rispondono con code 0 e nominano le righe rifiutate (failedList, failure_results o info).

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 mostra YOUR_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.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. 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.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Venditore SHEIN.
6. 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

Esempi di prompt

• "Quali ordini SHEIN delle ultime 24 ore posso gestire ora?"
• "Carica il numero di tracciamento UPS 1Z999AA10123456784 per entrambi i pezzi dell'ordine GSH12345678901."
• "Quali dei miei SKU hanno meno di 10 unità in stock?"
• "Imposta lo stock del codice SKU I8xk2m4p0q nel mio magazzino principale a 60."
• "Quali ordini di reso e casi post-vendita sono arrivati questa settimana, e cosa dicono gli acquirenti?"

FAQ

Devo incollare una chiave o un token del negozio? No. Devi incollare l'App ID e l'App Secret della tua app SHEIN approvata e cliccare su Authorize with Provider. La pagina di SHEIN chiede all'account principale del negozio di approvare, e il connettore recupera e memorizza la chiave del negozio da solo. Quando l'autorizzazione termina, clicca di nuovo su Authorize with Provider.

Per quali negozi funziona? Ordini, tracciamento, aggiornamenti di stock e resi sono per negozi auto-gestiti e semi-gestiti; i prezzi possono essere impostati solo da negozi auto-gestiti. Prodotti, categorie, marchi, siti e letture di stock funzionano anche per negozi completamente gestiti. Scegli l'indirizzo API del tuo tipo di app: openapi.sheincorp.com per auto-gestiti e semi-gestiti, openapi.sheincorp.cn per completamente gestiti. SHEIN accetta solo chiamate da indirizzi sulla whitelist dell'app; nella pagina di configurazione di AnythingMCP Cloud viene mostrato l'indirizzo da aggiungere.

Quali strumenti sono installati disattivati? shein_confirm_out_of_stock, che annulla una riga d'ordine, shein_set_skc_shelf_status, che toglie i prodotti dallo scaffale, e shein_sign_return_order, che conferma un reso. Niente nel connettore muove denaro, prenota logistica pagata o decide un caso post-vendita.

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

• Pagina di atterraggio del connettore
• Collegati a Claude