YunExpress über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → YunExpress klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

YunExpress + Cursor

YunExpress (云途物流) OMS API: Zielländer, Versandarten und Warenarten, Frachtangebote, Versandaufträge mit Sendungsnummern, Labels, Zusteller auf der letzten Meile, Tracking-Events und berechnete Gebühren, Gewichtsänderungen und Abfangen von Sendungen. Das Löschen von Aufträgen ist bei der Installation aus.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

YUNEXPRESS_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein YunExpress-Kundenkonto mit API-Zugang.

1. Melde dich im YunExpress-Kundencenter an (www.yunexpress.cn oder dein YunExpress-Kundenportal) und öffne den Bereich API. Notiere deine Kundennummer (客户编号, z. B. C12345) und das API-Secret (API密钥); gibt es noch keins, beantrage es dort.
2. YunExpress authentifiziert mit Authorization: Basic <token>. Das Token ist das Base64 aus Kundennummer, einem kaufmännischen Und und dem API-Secret (ein &, kein Doppelpunkt). Berechne es einmal auf deinem Rechner, z. B. mit printf '%s' 'C12345&YourApiSecret' | base64, und füge nur das Ergebnis in YUNEXPRESS_API_TOKEN ein. Es wird verschlüsselt gespeichert.
3. Installiere den Connector und rufe yunexpress_list_countries auf: Es listet die Zielländer und bestätigt das Token.

Welche API: Der Connector nutzt die OMS API von YunExpress (Version 1.4.x) auf http://oms.api.yunexpress.com. Dieser Host antwortet nur über einfaches HTTP. YunExpress betreibt außerdem eine neuere Open Platform (openapi.yunexpress.cn), die jede Anfrage mit Zeitstempel und OAuth-Token signiert; die nutzt dieser Connector nicht.

Was er liest: Zielländer mit ihrem zweistelligen Code; die Versandarten (Logistikprodukte) deines Kontos mit Code, chinesischem und englischem Namen und ob sie verfolgbar sind, auf Wunsch nur die für ein Land; Warenarten wie normale Ware oder Ware mit Batterien; Frachtangebote pro Versandart mit Grund-, Einschreibe-, Treibstoff- und weiteren Gebühren, Summe, Währung, abrechenbarem Gewicht und Laufzeit (yunexpress_get_price_quote, mit Postleitzahl für Zuschläge in entlegenen Gebieten); Versandaufträge mit Frachtbriefnummer, Kundenauftragsnummer, Sendungsnummer, Versandart, Status, Gewichten, Empfänger, Zollpositionen und Gebühren; die Absenderadresse eines Auftrags; Tracking mit Paketzustand, Tracking-Status, Zusteller auf der letzten Meile, Zustellnachweis und Events (yunexpress_get_tracking folgt deinen Anzeigeeinstellungen, yunexpress_get_full_tracking liefert den ganzen Verlauf, wo die Versandart das unterstützt); den Zusteller der letzten Meile und seine Nummer; die tatsächlich berechneten Gebühren, sobald YunExpress eine Sendung gewogen und abgerechnet hat.

Ein Paket verschicken: Die KI prüft die Versandarten für das Land und die Warenart, holt ein Angebot ein und ruft dann yunexpress_create_orders mit 1 bis 10 Aufträgen pro Aufruf auf. Jedes Ergebnis hat Success, WayBillNumber, TrackingNumber und TrackType (1 Sendungsnummer vorhanden, 2 ausstehend, 3 keine). Steht die Sendungsnummer noch aus, holt yunexpress_get_tracking_numbers sie später über die Kundenauftragsnummer (die Ergebnisse werden 30 Minuten zwischengespeichert). yunexpress_get_labels liefert die Labels von bis zu 50 Aufträgen als temporäre PDF-URL.

Was er schreibt: yunexpress_create_orders bucht echte Sendungen, yunexpress_update_weight ändert das angemeldete Gewicht, bevor YunExpress das Paket wiegt, und yunexpress_intercept_order bittet YunExpress mit einer Begründung, ein Paket anzuhalten. Vor jedem Schreibzugriff zeigt dir die KI die Aufträge (Empfänger, Versandart, Gewicht, Zollanmeldung) und wartet auf dein Ja. Nach einem unklaren Timeout liest sie den Auftrag mit yunexpress_get_order, bevor sie es erneut versucht, damit nichts doppelt gebucht wird.

Bei der Installation deaktiviert: yunexpress_delete_order, das einen Auftrag löscht, den YunExpress noch nicht erhalten hat, und nicht rückgängig zu machen ist. Ein Administrator schaltet es ein, wenn das Team es braucht.

Zahlen und Einheiten: Gewichte in kg (bis zu 3 Nachkommastellen), Maße in ganzen cm, deklarierte Werte (UnitPrice) pro Stück in der angegebenen CurrencyCode. OrderNumber nimmt die Frachtbriefnummer, deine Kundenauftragsnummer oder die Sendungsnummer; beim Abfangen und Löschen sagt OrderType, welche es ist (1 Frachtbrief, 2 Kundenauftrag, 3 Sendungsnummer). Paketzustände: 0 unbekannt, 1 übermittelt, 2 unterwegs, 3 zugestellt, 4 eingegangen, 5 storniert, 6 Zustellung fehlgeschlagen, 7 zurückgesendet. Tracking-Status: 0 nicht gefunden, 10 Voranmeldung, 20 unterwegs, 30 abholbereit, 40 fehlgeschlagen, 50 zugestellt, 60 Ausnahme, 80 unbekannt, 90 zurückgesendet, 100 storniert.

Limits: Es gibt kein Paging; Listen kommen in einer Antwort. Pro Aufruf gehen 10 Aufträge anzulegen und 50 Labels. Antwortet YunExpress mit Code 10000, ist das Anfragelimit erreicht: Warte einen Moment.

Häufige Fehler: Jede Antwort hat Code (0000 heißt Erfolg), Message, die Daten in Item oder Items und eine RequestId, die du dem YunExpress-Support nennst. HTTP 421 mit ResultCode 401 oder Code 1002 bzw. 1003 heißt, das Token stimmt nicht: Berechne es neu aus Kundennummer und Secret mit dem &. 1004 ist ein Parameterfehler, 1006 keine Daten, 1011 teilweiser Erfolg, 2004 eine doppelte Kundenauftragsnummer, 2005 ein bereits vorhandener Auftrag, 2006 keine Sendungsnummer für diese Versandart, 2009 ein Gewicht, das nicht positiv ist, 2010 eine Versandart, die das Ziel nicht bedient, 9999 ein Plattformfehler.

Der Connector nutzt die Open Platform von YunExpress nicht und verwaltet weder dein Konto noch Rechnungen oder Zahlungen: Die einzigen Kostendaten, die er liest, sind Angebote und die pro Sendung berechneten Gebühren.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die YunExpress-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche YunExpress-Versandarten bedienen Deutschland, und welche davon sind verfolgbar?“
• „Gib mir ein Angebot für ein Paket mit 0,35 kg und 20 x 15 x 5 cm mit Batterie nach Frankreich, pro Versandart mit Summe und Laufzeit.“
• „Leg einen YunExpress-Auftrag für SO-1042 an Anna Muster in Berlin mit der Versandart THPHR an. Zeig mir vorher Empfänger, Gewicht und Zollpositionen.“
• „Wo ist das Paket mit der Sendungsnummer YT2430012345678901, und wer stellt auf der letzten Meile zu?“
• „Hol mir die Labels der heutigen Aufträge SO-1040 bis SO-1045 als ein PDF.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden