Collegare SHEIN Seller MCP a Cursor

💡 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 + Cursor

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Venditore SHEIN.

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.

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude