Come collegare AliExpress Dropshipping a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → AliExpress Dropshipping, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

AliExpress Dropshipping + Gemini

Fai trovare alla tua AI i prodotti AliExpress per il tuo negozio: ricerca con i tuoi prezzi da dropshipper, dettagli di prodotti e SKU, opzioni e costi di consegna, stato degli ordini e tracking, con l'invio degli ordini disponibile su richiesta.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ALIEXPRESS_DS_APP_KEY, ALIEXPRESS_DS_APP_SECRET, ALIEXPRESS_DS_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 20 minuti, più la verifica del tuo profilo sviluppatore e della categoria dell'app da parte di AliExpress.

1. Accedi ad AliExpress con un account acquirente (non un account venditore) e accetta l'accordo del Dropshipping Program nel DS Center su https://ds.aliexpress.com.
2. Su https://openservice.aliexpress.com clicca Create Account (o accedi), apri il tuo profilo e scegli il tipo di sviluppatore Dropshipping (individual) o Dropshipping (corporation). AliExpress verifica il profilo.
3. Nella App Console clicca Create, richiedi la categoria di app Dropshipping, poi crea l'app con un tuo URL di callback (https). Un account Open Platform non può contenere sia un'app Dropshipping sia un'app Affiliate, quindi il connettore AliExpress Affiliate richiede un account separato.
4. Nella pagina di panoramica dell'app copia l'App Key in ALIEXPRESS_DS_APP_KEY e l'App Secret (clicca View) in ALIEXPRESS_DS_APP_SECRET.
5. Apri lo strumento di test delle API su https://openservice.aliexpress.com/app/index.htm#/api/test, scegli la tua app, clicca Get Token e accedi con l'account acquirente del dropshipper. Copia l'access_token in ALIEXPRESS_DS_ACCESS_TOKEN.
6. Finché l'app è in stato di test i suoi token durano circa un giorno: clicca Apply Online nella console. I token di un'app di dropshipping online durano di solito 30 giorni; la pagina Auth Management della console mostra per quanto.
7. Installa il connettore ed esegui aliexpress_dropshipping_get_member_benefits per verificare il token.

Scadenza del token: AnythingMCP non rinnova l'access token. Quando scade, ogni chiamata fallisce con un errore di autenticazione: ottieni un nuovo token come al passo 5 e incollalo in ALIEXPRESS_DS_ACCESS_TOKEN. In ogni caso AliExpress chiede periodicamente un nuovo accesso, al più tardi circa 60 giorni dopo l'autorizzazione.

Richieste firmate: ogni chiamata porta l'access token e una firma HMAC-SHA256 creata con l'App Secret, che non lascia mai AnythingMCP. Un timestamp sfasato di più di due ore viene rifiutato.

Sourcing: l'AI cerca prodotti per parola chiave e categoria, con i prezzi per il paese di destinazione nella tua valuta, e legge un prodotto ai prezzi del tuo account dropshipper: descrizione, immagini, negozio e ogni SKU con il suo sku_attr, prezzo e disponibilità. Per uno SKU, una quantità e un paese elenca le opzioni di consegna con costo, tempi di consegna, se il tracking è incluso e il logistics_service_name che serve a un ordine. Legge anche i vantaggi da dropshipper del tuo account.

Dopo l'ordine: l'AI legge un ordine tramite il suo id ordine AliExpress (stato, importi, prodotti, stato logistico) e il relativo tracking: corriere, numero di tracking, arrivo stimato ed eventi.

Disattivato all'installazione: aliexpress_dropshipping_create_order. Invia un ordine su AliExpress con l'indirizzo del tuo cliente e gli articoli. Attivalo tra i tool del connettore solo se l'AI può inviare ordini, e conferma ogni ordine. Gli ordini vengono creati non pagati: li paghi su AliExpress.

Formati: i prezzi sono stringhe decimali nella valuta richiesta; gli id di prodotti, SKU e ordini sono numeri lunghi, mantenuti come testo. I paesi sono codici a due lettere. Gli orari di tracking sono in millisecondi Unix. Le ricerche restituiscono pagine di fino a 50 prodotti.

Errori comuni: un codice relativo all'access token significa che il token è scaduto o appartiene a un'altra app; InvalidAppKey o IncompleteSignature significa che App Key e App Secret non corrispondono; InsufficientPermission significa che all'app manca l'API, quindi controlla la sua categoria; i codici di limite delle chiamate significano che la quota è esaurita. Quando si ordina, un indirizzo che AliExpress non riesce a validare restituisce B_DROPSHIPPER_DELIVERY_ADDRESS_VALIDATE_FAIL.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di AliExpress Dropshipping.

Tool disponibili

Esempi di prompt

• "Trova supporti per telefono che posso spedire in Germania, con prezzi in EUR, e mostrami i dieci con la valutazione migliore."
• "Mostrami tutte le varianti del prodotto 1005006123456789 con prezzo e disponibilità per la consegna in Francia."
• "Quali sono le opzioni di consegna per 2 unità di questo SKU verso gli Stati Uniti, e quali includono il tracking?"
• "Qual è lo stato dell'ordine AliExpress 8187654321098765?"
• "Dov'è il pacco dell'ordine 8187654321098765, e quando dovrebbe arrivare?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot