AliExpress MCP con Claude: collegare gli ordini

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Venditore AliExpress, incolla la chiave dell'app e il segreto, clicca su Authorize e accedi con l'account venditore del negozio, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Venditore AliExpress + Claude

Fai gestire il tuo negozio AliExpress dalla tua AI: ordini e indirizzi di consegna, dichiarazioni di spedizione con il tuo corriere, prodotti con prezzi e disponibilità, categorie, controversie e rendiconti di liquidazione. Utilizza la tua app venditore sulla Piattaforma Aperta di AliExpress.

Prerequisiti

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

ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_APP_SECRET

Passo 1 — Ottieni le credenziali

Cosa ti serve: un account venditore AliExpress, un account sviluppatore sulla Piattaforma Aperta di AliExpress e un'app di tua proprietà nella categoria Sviluppatore interno venditore. AliExpress esamina il profilo dello sviluppatore e deve approvare quella categoria di app prima che l'app possa essere creata: nessuno tranne AliExpress può accelerare questo processo, e può rifiutare. Le sue FAQ cinesi indicano da 2 a 5 giorni lavorativi per la revisione dello sviluppatore; non viene fornito alcun tempo per la categoria.

1. Su https://openservice.aliexpress.com clicca su Crea Account (o accedi). Poi completa il tuo profilo sotto il tuo ID utente, Profilo: scegli il tipo di sviluppatore, compila i campi e carica i documenti richiesti da AliExpress. AliExpress esamina il profilo.
2. Apri la Console App e clicca su Crea. Nella lista delle categorie di app clicca su Richiedi su Sviluppatore interno venditore (per un venditore AliExpress che costruisce un'app per uso personale), scrivi perché ne hai bisogno nel campo Motivo e clicca su OK. La categoria mostra In attesa fino a quando AliExpress non la approva, poi Attiva. Può essere creata solo un'app per categoria.
3. Sulla categoria approvata clicca su Crea App. Inserisci un nome per l'app e, come URL di callback, l'indirizzo di questo server seguito da /api/iop-auth/callback (su AnythingMCP Cloud: https://cloud.anythingmcp.com/api/iop-auth/callback), poi clicca su Invia.
4. Clicca su Panoramica APP, poi su Gestisci sulla tua app. Copia la App Key in ALIEXPRESS_SELLER_APP_KEY. Sotto Informazioni di base clicca su Visualizza e copia il App Secret in ALIEXPRESS_SELLER_APP_SECRET.
5. Nella stessa pagina guarda Gruppo di permessi API: un gruppo contrassegnato come Inattivo deve essere richiesto con Richiedi e un motivo prima che le sue API rispondano.
6. Sotto Console App, Gestione App, Gestione Autenticazione inserisci l'account venditore del tuo negozio nella whitelist di autorizzazione venditore e invia. Un'app sviluppata autonomamente può legare fino a 50 negozi, e solo negozi che sono legalmente collegati allo sviluppatore: la stessa azienda, la società madre e la controllata, la stessa società madre, o lo stesso rappresentante legale o azionista di maggioranza.
7. Sulla pagina del connettore clicca su Authorize. AliExpress mostra la sua pagina di accesso: seleziona il paese, inserisci l'account venditore e la password del negozio e clicca su Sign in And Authorize. Torni su AnythingMCP da solo.

Durata del token: AnythingMCP conserva il token di accesso e il token di aggiornamento crittografati, legge quanto durano dalla risposta di AliExpress (expires_in e refresh_expires_in, in secondi) e rinnova il token di accesso autonomamente. Un rinnovo porta un nuovo token di aggiornamento ma non sposta la data di scadenza del token di aggiornamento. Quando quella data viene raggiunta (o AliExpress risponde refresh_expires_in 0), clicca di nuovo su Authorize. La pagina Gestione Autenticazione mostra le durate della tua app; la guida cinese di AliExpress indica 365 giorni per il token di accesso e 730 giorni per il token di aggiornamento di un'app venditore sviluppata autonomamente.

Come firma: ogni chiamata va a /sync con il nome API in method, più app_key, access_token, un timestamp in millisecondi, sign_method=sha256 e sign, l'HMAC-SHA256 in maiuscolo di tutti i parametri ordinati per nome, chiave con il App Secret. Il segreto non lascia mai AnythingMCP.

Da dove iniziare

• Il negozio: aliexpress_seller_get_seller_profile (id venditore, paese, valuta di quotazione, conteggi dei prodotti) e aliexpress_seller_get_shop_info (id negozio, nome e URL).
• Ordini: aliexpress_seller_list_orders con order_status WAIT_SELLER_SEND_GOODS elenca ciò che deve essere spedito; aliexpress_seller_get_order fornisce importi, sotto-ordini e tracciamento; aliexpress_seller_get_order_receipt_info l'indirizzo di consegna.
• Spedizione con il tuo corriere: aliexpress_seller_list_order_shipping_services indica per ogni sotto-ordine se viene spedito con il tuo corriere (DBS) o con la logistica della piattaforma; aliexpress_seller_list_shipment_providers fornisce i codici dei fornitori; aliexpress_seller_declare_shipment invia il corriere e il numero di tracciamento ad AliExpress e non costa nulla; aliexpress_seller_modify_shipment lo corregge (massimo due volte, entro dieci giorni). aliexpress_seller_list_packages mostra i pacchi e il loro stato.
• Logistica della piattaforma (disattivata all'installazione, perché ordinano un servizio di logistica per il negozio): aliexpress_seller_list_seller_addresses per l'indirizzo di ritiro, aliexpress_seller_pack_order per creare il pacco, aliexpress_seller_ship_platform_package per consegnarlo, aliexpress_seller_cancel_package per annullare un pacco. La stampa della lettera di vettura non è inclusa: AliExpress la restituisce come file all'interno della risposta, stampala dal centro venditori.
• Prodotti: aliexpress_seller_list_products per stato, aliexpress_seller_get_product con ogni SKU, aliexpress_seller_update_prices e aliexpress_seller_update_stock per sku_code, aliexpress_seller_set_products_online, e aliexpress_seller_set_products_offline (disattivato). Pubblicare, modificare ed eliminare prodotti non sono inclusi.
• Impostazioni del catalogo: aliexpress_seller_list_categories, aliexpress_seller_list_publishable_categories e aliexpress_seller_list_freight_templates.
• Controversie: aliexpress_seller_list_disputes e aliexpress_seller_get_dispute sono letture. aliexpress_seller_accept_dispute_solution è disattivato: accettare una proposta è vincolante e può rimborsare l'acquirente.
• Denaro: aliexpress_seller_list_settlement_bills elenca i rendiconti di liquidazione. Il connettore non paga, rimborsa o ritira mai autonomamente.

Id e formati

• Gli id di ordine, sotto-ordine, prodotto e controversia sono numeri lunghi: passali come testo, solo cifre. L'id del sotto-ordine (child_id nella lista degli ordini, id in child_order_list di un ordine) è ciò che gli strumenti di spedizione chiamano tradeOrderItemId.
• I tempi degli ordini sono Orario del Pacifico degli Stati Uniti, scritti yyyy-MM-dd HH:mm:ss. I filtri per pacchi e controversie prendono il tempo Unix in millisecondi. I periodi di liquidazione sono scritti YYYY/MM/dd, le loro date di rilascio sono millisecondi Unix.
• Gli importi sono oggetti con amount (una stringa decimale) e currency_code; i prezzi che invii sono stringhe decimali nella valuta del prodotto.
• Le pagine delle liste partono da 1: ordini e controversie fino a 50 per pagina, pacchi fino a 50, prodotti meno di 100. Gli aggiornamenti di prezzo e disponibilità prendono al massimo 20 prodotti con 200 SKU ciascuno.
• order_status FINISH copre ordini completati e chiusi, ed è restituito solo quando richiesto. endReason nella extend_map dei suoi sotto-ordini li distingue.

Risposte ed errori: i risultati si trovano sotto aliexpress_..._response (il nome API con underscore). Molte chiamate rispondono 200 e portano il loro stesso verdetto all'interno: result.success con errorCode e errorMessage (o error_code e error_message), update_success con update_failed_list per aggiornamenti di prezzo e disponibilità. Leggi sempre prima di dire all'utente che una scrittura ha funzionato. I rifiuti del gateway arrivano come error_response con un code: IllegalAccessToken quando l'autorizzazione è scaduta (AnythingMCP rinnova il token una volta e riprova), InvalidAppkey o IncompleteSignature quando chiave e segreto non corrispondono, InsufficientPermission quando l'app non ha il gruppo di permessi API, e un codice di limite di chiamata quando la quota della categoria dell'app è esaurita.

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 Claude

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

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

1. In Claude, apri Personalizza → Connettori.
2. Clicca su +, poi su Aggiungi connettore personalizzato.
3. Inserisci un nome, ad esempio Venditore AliExpress, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Aggiungi.
4. Clicca su Collegati e accedi a AnythingMCP (OAuth) per consentire l'accesso.

Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.

Strumenti disponibili

Esempi di prompt

• "Quali ordini AliExpress stanno aspettando che io spedisca?"
• "Dichiara la spedizione dell'ordine 8187654321098765 con tracciamento Cainiao LP00123456789012."
• "Quali controversie sono aperte e cosa chiedono gli acquirenti?"
• "Imposta la disponibilità dello SKU AE-CASE-14-BLK a 300 e il prezzo a 4,99 USD."
• "Mostra i rendiconti di liquidazione del mese scorso."

FAQ

Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Devo incollare un token di accesso? No. Devi incollare la App Key e il App Secret della tua app Sviluppatore interno venditore, aggiungere il negozio alla whitelist venditore dell'app e cliccare su Authorize sulla pagina del connettore. La pagina di accesso di AliExpress richiede l'account venditore del negozio, e il connettore conserva e rinnova i token autonomamente.

Cosa copre e cosa no? Ordini e indirizzi di consegna, dichiarazioni di spedizione con il tuo corriere, pacchi, prodotti con prezzi e disponibilità, categorie, modelli di spedizione, controversie e rendiconti di liquidazione. Pubblicare o modificare prodotti e messaggi degli acquirenti non sono coperti.

Quali strumenti sono installati disattivati? Gli strumenti di logistica della piattaforma (aliexpress_seller_pack_order, aliexpress_seller_ship_platform_package, aliexpress_seller_cancel_package), aliexpress_seller_set_products_offline e aliexpress_seller_accept_dispute_solution. Attivali sulla pagina del connettore solo se l'AI deve usarli.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a ChatGPT
• Collegati a Cursor
• Collegati a Gemini
• Collegati a Meta Muse
• Collegati a Microsoft Copilot