Guida al connettore6 minuti di lettura25 tool MCP7 lingue

Server Wish MCP: ordini, prodotti e ticket

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

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

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

Wish

Wish

Wish Marketplace API v3 for merchants: orders and fulfillment with tracking, products and variations with prices and inventory per warehouse, categories and attributes, customer support tickets, ratings, penalties, warehouses and shipping settings. OAuth access token from a private app.

tool

25

Regione

INTL

Categoria

E-commerce

Autenticazione

Bearer Token

Env vars richieste

WISH_ACCESS_TOKEN
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

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Configurazione guidata

Collega Wish a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Wish con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. 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 Wish

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

Wish · 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 → Wish, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Wish

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Configurazione

La configurazione richiede circa 10 minuti.

  1. Nel pannello di controllo del commerciante Wish (https://merchant.wish.com) apri il menu Account, Impostazioni API, e clicca su Registrare un'app privata. Inserisci un nome e un URI di reindirizzamento HTTPS di tua proprietà (qualsiasi pagina funziona, il codice deve solo apparire nel suo indirizzo). Wish consente un'app privata per commerciante.
  2. Apri https://merchant.wish.com/v3/oauth/authorize?client_id= seguito dall'ID client dell'app, accedi e approva. Wish reindirizza al tuo URI di reindirizzamento con ?code= nell'indirizzo; il codice è valido per 5 minuti e funziona una sola volta.
  3. Scambia il codice: apri https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=... con i tuoi valori. Copia data.access_token in WISH_ACCESS_TOKEN e conserva data.refresh_token al sicuro.

Durata del token: I token di accesso Wish scadono dopo 30 giorni. Prima di ciò, apri https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=... e incolla il nuovo token di accesso nel connettore (quello vecchio viene revocato). Wish rinnova i token solo con richieste GET, che il rinnovo automatico OAuth del connettore non invia, quindi il rinnovo è manuale per ora.

Da dove iniziare: wish_test_token controlla il token e mostra i suoi ambiti. wish_list_orders con stati APPROVED elenca gli ordini da spedire; wish_list_products elenca il catalogo; wish_list_warehouses fornisce gli ID dei magazzini necessari per l'inventario.

Ordini: wish_list_orders, wish_get_order. Spedisci con wish_fulfill_order (corriere da wish_list_shipping_carriers, numero di tracciamento, paese di origine); la stessa chiamata corregge il tracciamento in seguito. Spedizioni e rimborsi sono asincroni: leggi di nuovo l'ordine per il risultato. wish_list_refund_reasons mostra motivi validi; wish_refund_order rimborsa il cliente ed è installato disattivato.

Prodotti: wish_list_products, wish_get_product, wish_create_product, wish_update_product (prezzo, inventario per magazzino, stato delle varianti per ID variante), wish_create_variation. Categorie: wish_get_categories, wish_get_category, wish_get_category_attributes. wish_delete_product è installato disattivato; disabilita le varianti invece. wish_get_product_rating legge la valutazione.

Ticket clienti: wish_list_tickets (stato AWAITING_MERCHANT necessita di una risposta), wish_get_ticket, wish_reply_to_ticket, wish_update_ticket (chiudi, riapri, appello).

Account: wish_get_account_details, wish_list_penalties, wish_get_shipping_settings, wish_list_warehouses.

Paging: le liste restituiscono fino a limit elementi ordinati per tempo; per la pagina successiva chiama di nuovo con updated_at_max (o created_at_max) impostato sull'ora dell'ultimo elemento. Ogni risposta ha la forma code, message, data; code 0 significa successo.

Ids e formati: gli ID di ordine, prodotto, variante, ticket e magazzino sono stringhe esadecimali di 24 caratteri. I tempi sono in ISO 8601 (2026-11-01T00:00:00Z). I prezzi sono oggetti con amount e currency_code. Gli ambiti del token decidono cosa funziona: un ambito mancante restituisce 403.

Limiti di richiesta: per commerciante e app; l'intestazione Wish-Rate-Limit-Remaining mostra cosa è rimasto e un 429 porta Wish-Rate-Limit-Reset. Cita l'intestazione Wish-Request-Id quando contatti Wish riguardo a una chiamata.

Prerequisiti: WISH_ACCESS_TOKEN

Installa il connettore localmente

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

Apri http://localhost:3000/connectors/store, scegli Wish e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

StrumentoCosa fa
wish_test_tokenControlla che il token di accesso funzioni: restituisce l'ID del commerciante e gli ambiti del token
wish_get_account_detailsL'account del commerciante: id, nome visualizzato, contatto, paese, stato e altri dettagli dell'account
wish_list_ordersElenca gli ordini, aggiornati più di recente per impostazione predefinita: id, stato (APPROVED per spedire, SHIPPED, REFUNDED, REQUIRE_REVIEW), tipo di ordine, prodotto…
wish_get_orderUn ordine per ID: stato, prodotto e variante, quantità, prezzi e pagamento, indirizzo di spedizione, requisiti di evasione e scadenza…
wish_list_shipping_carriersCorrieri di spedizione accettati: tutti i corrieri (GENERAL) o quelli accettati per la politica di Consegna Confermata verso un paese di destinazione…
wish_fulfill_orderSegna un ordine come spedito, o aggiorna il suo tracciamento: corriere, numero di tracciamento e paese di origine. Asincrono; leggi di nuovo l'ordine per vedere il…
wish_list_refund_reasonsMotivi di rimborso validi per un ordine in questo momento (cambiano durante la vita dell'ordine). Leggili appena prima di un rimborso
wish_refund_orderRimborso o annulla un ordine con un motivo da wish_list_refund_reasons. Il cliente riceve indietro i soldi e non può essere annullato; i rimborsi…
wish_list_productsElenca i prodotti, aggiornati più di recente per impostazione predefinita: id, parent_sku, nome, stato, categoria, immagini, varianti (id, sku, prezzo, inventario…
wish_get_productUn prodotto per ID con le sue varianti, prezzi, inventario per magazzino, immagini, attributi, stato di spedizione e revisione
wish_create_productCrea un prodotto con almeno una variante. Necessita di nome, descrizione (testo semplice, fino a 4.000 caratteri), SKU principale, categoria, principale…
wish_update_productAggiorna un prodotto: nome, descrizione, tag, categoria, immagini, prezzi di spedizione predefiniti, stato, o le sue varianti esistenti (per ID variante…
wish_delete_productElimina un'inserzione di prodotto. Non può essere annullato. Installato disattivato; disabilita le varianti con wish_update_product invece
wish_create_variationAggiungi una variante a un prodotto esistente: sku, prezzo, inventario per magazzino, valori delle opzioni e immagine
wish_get_categoriesLa radice dell'albero delle categorie di Wish con le sue categorie figlie (id, nome, is_leaf). Scendi con wish_get_category fino a una foglia per category_id
wish_get_categoryUna categoria per ID con i suoi figli; le categorie foglia possono essere utilizzate come category_id
wish_get_category_attributesAttributi di una categoria (nome, richiesto, valori consentiti) per compilare attributi e opzioni quando si creano prodotti
wish_get_product_ratingValutazione complessiva di un prodotto: valutazione media e conteggi delle valutazioni
wish_list_ticketsTicket di supporto clienti, aggiornati più di recente per impostazione predefinita: id, tipo (ORDER, PRE_PURCHASE, POST_CUSTOMER_SUPPORT), stato (AWAITING_MERCHANT…
wish_get_ticketUn ticket di supporto con i suoi messaggi, ordine correlato e stato
wish_reply_to_ticketRispondi a un ticket nello stato AWAITING_MERCHANT (fino a 2.000 caratteri, Markdown consentito). Wish aggiorna lo stato dopo la risposta
wish_update_ticketChiudi un ticket (CLOSED), riapri uno chiuso (AWAITING_MERCHANT, quando consentito) o fai appello al supporto Wish (AWAITING_WISH)
wish_list_penaltiesPenalità sull'account, le più recenti per prime: id, tipo, importo e valuta, motivo, ordine o prodotto, tempo di creazione e annullamento. Fino a 500 per…
wish_get_shipping_settingsImpostazioni di spedizione del commerciante per ogni paese di destinazione a cui Wish spedisce: paesi abilitati, prezzi di spedizione e regioni
wish_list_warehousesI magazzini del commerciante: id, nome, tipo (magazzino standard per primo), indirizzo. Gli ID dei magazzini sono necessari per l'inventario e i prezzi di spedizione

Esempi di richieste

  • "Quali ordini Wish necessitano di evasione oggi?"
  • "Evasione dell'ordine 64a1b2c3d4e5 con tracciamento USPS 9400111899223197428490."
  • "Quali ticket di supporto stanno aspettando la mia risposta?"
  • "Ci sono nuove penalità sul mio account questo mese?"
  • "Qual è la valutazione del prodotto 5f9e8d7c6b5a?"

Passi successivi

Questa guida ti è stata utile?

Collega Wish a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Wish con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Wish a ChatGPT via MCP: ordini e prodotti

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Connettori

Collegare Wish a Claude via MCP: ordini e scorte

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Connettori

Collegare Wish a Microsoft Copilot via MCP

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Connettori

Collegare Wish a Cursor via MCP: ordini e scorte

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Connettori

Collegare Wish a Gemini CLI via MCP: ordini e ticket

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.

Connettori

Collegare Wish a Meta Muse via MCP: ordini e prodotti

Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.