Zusammenfassung
UPS APIs für Versender: Verfolge Pakete anhand der Sendungsnummer oder Referenz, validiere US-Adressen, vergleiche Tarife und Transitzeiten, finde Abgabe- und Access Point-Standorte, schätze die Gesamtkosten, hole Etiketten zurück und fordere Abholungen an. Die Erstellung von Sendungen, Stornierungen und Abholungen sind enthalten, aber deaktiviert. OAuth-Client-ID und Geheimnis aus dem UPS Developer Portal.
Geführte Einrichtung
UPS in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde UPS in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für UPS
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → UPS, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
UPS
UPS APIs für Versender: Verfolge Pakete anhand der Sendungsnummer oder Referenz, validiere US-Adressen, vergleiche Tarife und Transitzeiten, finde Abgabe- und Access Point-Standorte, schätze die Gesamtkosten, hole Etiketten zurück und fordere Abholungen an. Die Erstellung von Sendungen, Stornierungen und Abholungen sind enthalten, aber deaktiviert. OAuth-Client-ID und Geheimnis aus dem UPS Developer Portal.
Einrichtung
Die Einrichtung dauert etwa 10 Minuten.
- Melde dich unter https://developer.ups.com mit dem ups.com-Profil an, das dein Versenderkonto besitzt (registriere zuerst eines, falls nötig), und öffne die Seite zur Erstellung einer Anwendung.
- Sage, dass du die UPS-Technologie in dein eigenes Geschäft integrieren möchtest, wähle die UPS-Kontonummer, auf die die App abrechnen soll, und benenne die App.
- Füge die Produkte hinzu, die der Connector verwendet: Tracking, Adressvalidierung, Tarifierung, Transitzeit, Locator und für die deaktivierten Tools Versand, Abholung und Kostenschätzung. Ein fehlendes Produkt antwortet nur mit 401 oder 403 für seine Tools.
- Kopiere die Client-ID in
UPS_CLIENT_IDund das Client-Geheimnis inUPS_CLIENT_SECRET. - Gib deine 6-stellige UPS-Kontonummer (Versendernummer) in
UPS_ACCOUNT_NUMBERein.
Der Connector tauscht die Client-ID und das Geheimnis unter https://onlinetools.ups.com/security/v1/oauth/token (Client-Anmeldeinformationen, HTTP Basic) gegen ein kurzlebiges Bearer-Token aus und erneuert es selbstständig. Dies sind Produktions-Zugangsdaten; das UPS-Testsystem (wwwcie.ups.com) wird nicht verwendet.
Wo du anfangen kannst: ups_track_package mit einer Sendungsnummer. Für einen Preis vergleicht ups_shop_rates alle Dienste zwischen zwei Adressen und ups_get_rate bepreist einen Dienst; ups_get_time_in_transit gibt Lieferdaten ohne Preise an.
Tracking: ups_track_package (jede Sendungsnummer), ups_track_by_reference (deine eigene Referenz, z.B. eine Bestellnummer, innerhalb deines Kontos) und ups_track_shipment_packages (alle Pakete einer Mehrpaket-Sendung). Daten sind YYYYMMDD und Zeiten HHMMSS in der lokalen Zeit des Scans; gmtDate, gmtTime und gmtOffset geben denselben Moment in UTC an. Lies den Status aus currentStatus.description und die Scans aus activity, neueste zuerst.
Adressen und Standorte: ups_validate_address deckt nur Straßenadressen in den Vereinigten Staaten und Puerto Rico ab. ups_find_locations findet Abgabeorte und UPS Access Point-Standorte in der Nähe einer Adresse in jedem Land, das UPS bedient.
Tarife: ups_shop_rates und ups_get_rate senden deine Kontonummer als Versendernummer. Veröffentliche Tarife kommen standardmäßig zurück; übergebe rating_options mit NegotiatedRatesIndicator, um die Vertragspreise deines Kontos in NegotiatedRateCharges zu sehen. Beträge sind Strings in der Währung, die neben ihnen genannt wird. Gewichte sind LBS oder KGS und Abmessungen IN oder CM: verwende die Einheiten des Ursprungslandes. ups_quote_landed_cost schätzt Zölle und Steuern für eine grenzüberschreitende Sendung und funktioniert am besten mit einem HS-Code pro Artikel.
Etiketten und Sendungen: ups_recover_label gibt das Etikett einer bestehenden Sendung zurück und kostet nichts. ups_create_shipment erstellt eine Sendung, die UPS dem Konto in Rechnung stellt, und ups_void_shipment storniert eine vor der Abholung; beide sind installiert, aber deaktiviert. Schalte sie im Connector nur ein, wenn der Assistent echte Sendungen erstellen soll. Die Feldnamen von UPS unterscheiden sich zwischen den Aufrufen: die Tarif-Tools nennen die Verpackung PackagingType, das Versand-Tool Packaging.
Abholungen: ups_get_pickup_rate gibt einen Preis für eine Abholung auf Abruf an und ups_get_pending_pickups listet gebuchte Abholungen auf. ups_create_pickup bucht einen Fahrer gegen Gebühr und ups_cancel_pickup storniert per PRN; beide sind installiert, aber deaktiviert.
Fehler: UPS antwortet mit response.errors, einer Liste von code und message. 401 bedeutet, dass die Zugangsdaten oder das Token abgelehnt wurden, 403, dass die App keinen Zugriff auf dieses Produkt hat oder dass UPS das Konto blockiert hat, 404 bei Tracking, dass UPS noch keine Daten für die Nummer hat (Etiketten erscheinen nach dem ersten Scan oder einige Stunden nach der Erstellung), 429, dass das Kontingent der App aufgebraucht ist.
Grenzen: UPS setzt ein Kontingent pro App und Produkt und veröffentlicht die Zahlen nicht in seinen API-Dateien; ein 429 bedeutet, warten und später erneut versuchen. Das Dokumentierte ist, eine Nummer pro Aufruf zu verfolgen: Schleifen über lange Listen schnell sind nicht erlaubt.
Voraussetzungen: UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
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 UPS und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
ups_track_package | Verfolge ein UPS-Paket anhand der Sendungsnummer: aktueller Status mit Code und Beschreibung, jeder Scan (Datum als YYYYMMDD, lokale Zeit als HHMMSS… |
ups_track_by_reference | Finde und verfolge Sendungen deines UPS-Kontos anhand einer Referenznummer, die du auf der Sendung angibst (Bestellnummer, Rechnungsnummer). Gibt dasselbe zurück… |
ups_track_shipment_packages | Verfolge jedes Paket einer Mehrpaket-UPS-Sendung anhand einer seiner Sendungsnummern: pro Paket die Sendungsnummer, aktuellen Status, letzte… |
ups_validate_address | Überprüfe eine Straßenadresse in den Vereinigten Staaten oder Puerto Rico anhand von UPS-Daten. Gibt ValidAddressIndicator, AmbiguousAddressIndicator… zurück |
ups_get_rate | Preis für einen UPS-Dienst für eine Sendung. Gibt RateResponse.RatedShipment mit dem Dienstcode, dem Abrechnungsgewicht, dem Transport, dem Dienst… zurück |
ups_shop_rates | Vergleiche jeden verfügbaren UPS-Dienst zwischen zwei Adressen für eine Sendung. Gibt eine RatedShipment pro Dienst mit seinem Code, der Abrechnung… zurück |
ups_get_time_in_transit | Listet die verfügbaren UPS-Dienste zwischen zwei Orten unter emsResponse.services: serviceLevel und serviceLevelDescription… |
ups_find_locations | Finde UPS-Abgabeorte in der Nähe einer Adresse: UPS Access Point-Standorte, The UPS Store, Kundenservicezentren und Briefkästen. Gibt… zurück |
ups_quote_landed_cost | Schätze Zölle, Steuern und Maklergebühren für eine internationale Sendung, bevor sie versendet wird (UPS Landed Cost Quote). Gibt pro Ware die… zurück |
ups_recover_label | Hole das Etikett einer bereits existierenden Sendung erneut, anhand der Sendungsnummer. Gibt LabelRecoveryResponse.LabelResults mit dem Etikett als… zurück |
ups_get_pickup_rate | Schätze, was eine Abholung auf Abruf bei einer Adresse kosten würde, ohne sie zu buchen. Gibt PickupRateResponse.RateResult mit dem Tariftyp… zurück |
ups_get_pending_pickups | Listet die auf deinem UPS-Konto gebuchten Abholungen auf, die noch nicht stattgefunden haben. Gibt PickupPendingStatusResponse.PendingStatus mit der Abholung… zurück |
ups_create_shipment | Erstelle eine UPS-Sendung und ihr Etikett. UPS stellt die Sendung deinem Konto in Rechnung, sobald dieser Aufruf erfolgreich ist, daher ist das Tool… installiert |
ups_void_shipment | Storniere (widerrufe) eine UPS-Sendung, die erstellt, aber noch nicht abgeholt wurde, oder einzelne Pakete davon. Es kann nicht rückgängig gemacht werden: die Etiketten werden… |
ups_create_pickup | Buche eine Abholung auf Abruf bei UPS: ein Fahrer kommt am angegebenen Tag zur Adresse. UPS berechnet eine Abholgebühr auf dein Konto, daher ist das Tool… installiert |
ups_cancel_pickup | Storniere eine gebuchte UPS-Abholung anhand ihrer Abholanforderungsnummer (PRN). Es kann nicht rückgängig gemacht werden; eine neue Abholung muss gebucht werden. Gibt… zurück |
Beispielaufforderungen
- "Wo ist UPS-Paket 1Z999AA10123456784?"
- "Vergleiche UPS-Tarife von Chicago 60601 nach Austin 78701 für einen 5 lb Karton."
- "Ist 1600 Amphitheatre Pkwy, Mountain View, CA 94043 eine gültige Adresse?"
- "Wann würde ein UPS Ground-Paket von Atlanta nach Seattle gelangen, wenn es heute versendet wird?"
- "Finde UPS Access Point-Standorte in der Nähe von 10115 Berlin."
Nächste Schritte
War dieser Guide hilfreich?