AliExpress MCP-Server für Bestellungen und Lager

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → AliExpress Seller, füge den App-Schlüssel und das Geheimnis ein, klicke auf Authorize und melde dich mit dem Verkäuferkonto des Shops an, mint einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

AliExpress Verkäufer

Lass deine KI deinen AliExpress-Shop betreiben: Bestellungen und Lieferadressen, Versanddeklarationen mit deinem eigenen Versanddienstleister, Produkte mit Preisen und Lagerbestand, Kategorien, Streitigkeiten und Abrechnungsunterlagen. Verwendet deine eigene Verkäufer-App auf der AliExpress Open Platform.

Einrichtung

Was du benötigst: ein AliExpress Verkäuferkonto, ein Entwicklerkonto auf der AliExpress Open Platform und eine eigene App in der Kategorie Seller-inhouse Developer. AliExpress überprüft das Entwicklerprofil und muss diese App-Kategorie genehmigen, bevor die App erstellt werden kann: niemand außer AliExpress kann dies beschleunigen, und es kann ablehnen. In den chinesischen FAQ werden 2 bis 5 Werktage für die Entwicklerüberprüfung genannt; für die Kategorie wird keine Zeit angegeben.

1. Gehe zu https://openservice.aliexpress.com und klicke auf Konto erstellen (oder melde dich an). Vervollständige dann dein Profil unter deiner Benutzer-ID, Profil: wähle den Entwicklertyp, fülle die Felder aus und lade die Dokumente hoch, die AliExpress verlangt. AliExpress überprüft das Profil.
2. Öffne die App-Konsole und klicke auf Erstellen. Klicke in der Liste der App-Kategorien auf Beantragen bei Seller-inhouse Developer (für einen AliExpress Verkäufer, der eine App für den eigenen Gebrauch erstellt), schreibe, warum du sie benötigst, in das Feld Grund und klicke auf OK. Die Kategorie zeigt Ausstehend, bis AliExpress sie genehmigt, dann Aktiv. Es kann nur eine App pro Kategorie erstellt werden.
3. Klicke bei der genehmigten Kategorie auf App erstellen. Gib einen App-Namen ein und als Callback-URL die Adresse dieses Servers gefolgt von /api/iop-auth/callback (auf AnythingMCP Cloud: https://cloud.anythingmcp.com/api/iop-auth/callback), dann klicke auf Absenden.
4. Klicke auf APP-Übersicht, dann auf Verwalten deiner App. Kopiere den App-Schlüssel in ALIEXPRESS_SELLER_APP_KEY. Klicke unter Basisinformationen auf Anzeigen und kopiere das App-Geheimnis in ALIEXPRESS_SELLER_APP_SECRET.
5. Sieh dir auf derselben Seite die API-Berechtigungsgruppe an: Eine Gruppe, die als Inaktiv gekennzeichnet ist, muss mit Beantragen und einem Grund angefordert werden, bevor ihre APIs antworten.
6. Gib unter App-Konsole, App-Verwaltung, Authentifizierungsverwaltung das Verkäuferkonto deines Shops in die Verkäuferautorisierungsliste ein und reiche es ein. Eine selbstentwickelte App kann bis zu 50 Shops binden, und nur Shops, die rechtlich mit dem Entwickler verbunden sind: dasselbe Unternehmen, Mutter- und Tochtergesellschaft, dieselbe Muttergesellschaft oder derselbe rechtliche Vertreter oder Mehrheitsaktionär.
7. Klicke auf der Connector-Seite auf Authorize. AliExpress zeigt seine Anmeldeseite an: wähle das Land, gib das Verkäuferkonto und das Passwort des Shops ein und klicke auf Sign in And Authorize. Du kommst selbstständig zu AnythingMCP zurück.

Token-Lebensdauer: AnythingMCP speichert das Zugriffstoken und das Aktualisierungstoken verschlüsselt, liest aus der Antwort von AliExpress, wie lange sie gültig sind (expires_in und refresh_expires_in, in Sekunden) und erneuert das Zugriffstoken selbstständig. Eine Erneuerung bringt ein neues Aktualisierungstoken, verschiebt jedoch nicht das Enddatum des Aktualisierungstokens. Wenn dieses Datum erreicht ist (oder AliExpress refresh_expires_in 0 antwortet), klicke erneut auf Authorize. Die Seite Authentifizierungsverwaltung zeigt die Laufzeiten deiner App an; das chinesische Handbuch von AliExpress nennt 365 Tage für das Zugriffstoken und 730 Tage für das Aktualisierungstoken einer selbstentwickelten Verkäufer-App.

Wie es signiert: Jeder Aufruf geht an /sync mit dem API-Namen in method, plus app_key, access_token, einem Millisekunden timestamp, sign_method=sha256 und sign, dem Großbuchstaben HMAC-SHA256 aller Parameter, die nach Namen sortiert sind, mit dem App-Geheimnis als Schlüssel. Das Geheimnis verlässt AnythingMCP niemals.

Wo du anfangen kannst

• Der Shop: aliexpress_seller_get_seller_profile (Verkäufer-ID, Land, Angebotswährung, Produktanzahl) und aliexpress_seller_get_shop_info (Shop-ID, Name und URL).
• Bestellungen: aliexpress_seller_list_orders mit order_status WAIT_SELLER_SEND_GOODS listet, was versendet werden muss; aliexpress_seller_get_order gibt Beträge, Unterbestellungen und Sendungsverfolgung an; aliexpress_seller_get_order_receipt_info die Lieferadresse.
• Versand mit deinem eigenen Versanddienstleister: aliexpress_seller_list_order_shipping_services sagt pro Unterbestellung, ob sie mit deinem eigenen Versanddienstleister (DBS) oder mit Plattformlogistik versendet wird; aliexpress_seller_list_shipment_providers gibt die Anbieter-Codes an; aliexpress_seller_declare_shipment sendet den Versanddienstleister und die Sendungsverfolgungsnummer an AliExpress und kostet nichts; aliexpress_seller_modify_shipment korrigiert es (höchstens zweimal, innerhalb von zehn Tagen). aliexpress_seller_list_packages zeigt die Pakete und ihren Status an.
• Plattformlogistik (bei der Installation deaktiviert, da sie einen Logistikdienst für den Shop bestellen): aliexpress_seller_list_seller_addresses für die Abholadresse, aliexpress_seller_pack_order um das Paket zu erstellen, aliexpress_seller_ship_platform_package um es zu übergeben, aliexpress_seller_cancel_package um ein Paket rückgängig zu machen. Das Drucken des Frachtbriefs ist nicht enthalten: AliExpress gibt ihn als Datei in der Antwort zurück, drucke ihn aus dem Verkäuferzentrum.
• Produkte: aliexpress_seller_list_products nach Status, aliexpress_seller_get_product mit jedem SKU, aliexpress_seller_update_prices und aliexpress_seller_update_stock nach sku_code, aliexpress_seller_set_products_online, und aliexpress_seller_set_products_offline (deaktiviert). Das Posten, Bearbeiten und Löschen von Produkten ist nicht enthalten.
• Katalogeinstellungen: aliexpress_seller_list_categories, aliexpress_seller_list_publishable_categories und aliexpress_seller_list_freight_templates.
• Streitigkeiten: aliexpress_seller_list_disputes und aliexpress_seller_get_dispute sind Leseoperationen. aliexpress_seller_accept_dispute_solution ist deaktiviert: einen Vorschlag anzunehmen ist verbindlich und kann den Käufer erstatten.
• Geld: aliexpress_seller_list_settlement_bills listet die Abrechnungsunterlagen. Der Connector bezahlt, erstattet oder zieht niemals selbst ab.

IDs und Formate

• Bestell-, Unterbestell-, Produkt- und Streitigkeits-IDs sind lange Zahlen: übergebe sie als Text, nur Ziffern. Die Unterbestell-ID (child_id in der Bestellliste, id in child_order_list einer Bestellung) ist das, was die Versandtools tradeOrderItemId nennen.
• Bestellzeiten sind US-Pazifikzeit, geschrieben yyyy-MM-dd HH:mm:ss. Paket- und Streitigkeitsfilter verwenden Unix-Zeit in Millisekunden. Abrechnungszeiträume werden als YYYY/MM/dd geschrieben, ihre Freigabedaten sind Unix-Millisekunden.
• Beträge sind Objekte mit amount (einem Dezimalstring) und currency_code; Preise, die du sendest, sind Dezimalstrings in der Währung des Produkts.
• Listen beginnen bei 1: Bestellungen und Streitigkeiten bis zu 50 pro Seite, Pakete bis zu 50, Produkte weniger als 100. Preis- und Lageraktualisierungen benötigen maximal 20 Produkte mit jeweils 200 SKUs.
• order_status FINISH umfasst abgeschlossene und geschlossene Bestellungen und wird nur auf Anfrage zurückgegeben. endReason im extend_map seiner Unterbestellungen unterscheidet sie.

Antworten und Fehler: Ergebnisse befinden sich unter aliexpress_..._response (dem API-Namen mit Unterstrichen). Viele Aufrufe antworten mit 200 und tragen ihr eigenes Urteil in sich: result.success mit errorCode und errorMessage (oder error_code und error_message), update_success mit update_failed_list für Preis- und Lageraktualisierungen. Lies es immer, bevor du dem Benutzer sagst, dass ein Schreibvorgang erfolgreich war. Ablehnungen des Gateways kommen als error_response mit einem code: IllegalAccessToken, wenn die Autorisierung abgelaufen ist (AnythingMCP erneuert das Token einmal und versucht es erneut), InvalidAppkey oder IncompleteSignature, wenn Schlüssel und Geheimnis nicht übereinstimmen, InsufficientPermission, wenn der App die API-Berechtigungsgruppe fehlt, und ein Aufrufgrenzencode, wenn das Kontingent der App-Kategorie aufgebraucht ist.

Voraussetzungen: ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_APP_SECRET

Installiere den Connector lokal

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

Öffne http://localhost:3000/connectors/store, wähle AliExpress Seller und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Welche AliExpress-Bestellungen warten darauf, dass ich sie versende?"
• "Deklariere den Versand der Bestellung 8187654321098765 mit Cainiao-Sendungsverfolgung LP00123456789012."
• "Welche Streitigkeiten sind offen, und was verlangen die Käufer?"
• "Setze den Lagerbestand von SKU AE-CASE-14-BLK auf 300 und den Preis auf 4,99 USD."
• "Zeige die Abrechnungsunterlagen des letzten Monats."

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT