Zusammenfassung
UPS APIs für Versender: Pakete anhand der Sendungsnummer oder Referenz verfolgen, US-Adressen validieren, Tarife und Transitzeiten vergleichen, Abgabe- und Access Point-Standorte finden, Landekosten schätzen, Etiketten wiederherstellen und Abholungen anfragen. 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 Gemini verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde UPS in der geführten Einrichtung und trag deine MCP-URL in Gemini 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 + Gemini
UPS APIs für Versender: Pakete anhand der Sendungsnummer oder Referenz verfolgen, US-Adressen validieren, Tarife und Transitzeiten vergleichen, Abgabe- und Access Point-Standorte finden, Landekosten schätzen, Etiketten wiederherstellen und Abholungen anfragen. Die Erstellung von Sendungen, Stornierungen und Abholungen sind enthalten, aber deaktiviert. OAuth-Client-ID und Geheimnis aus dem UPS Developer Portal.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
Schritt 1 — Zugangsdaten erhalten
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, Bewertung, Zeit in Transit, Locator und für die deaktivierten Tools Versand, Abholung und Landekostenangebot. Ein fehlendes Produkt beantwortet nur mit 401 oder 403 für seine Tools.
- Kopiere die Client-ID in
UPS_CLIENT_IDund das Client Secret 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 anfangen: 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 Mehrpaketsendung). Daten sind YYYYMMDD und Zeiten HHMMSS in der lokalen Zeit des Scans; gmtDate, gmtTime und gmtOffset geben denselben Moment in UTC an. Lese 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 Vertragsraten 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 Herkunftslandes. 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 erneut zurück und kostet nichts. ups_create_shipment erstellt eine Sendung, die UPS dem Konto in Rechnung stellt, und ups_void_shipment storniert eine, bevor sie abgeholt wird; beide sind standardmäßig 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 standardmäßig 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.
Limits: 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 sieht vor, dass nur eine Nummer pro Aufruf verfolgt wird: Schleifen über lange Listen schnell sind nicht erlaubt.
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 Gemini 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 AnleitungYOUR_SERVER_IDzeigt.
Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte
geminineu. - Führe in der Gemini CLI
/mcpaus (odergemini mcp listim Terminal) —anythingmcpsollte als verbunden erscheinen. - Leg los: Gemini CLI kann jetzt die
UPS-Tools aufrufen.
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 angegeben hast (Bestellnummer, Rechnungsnummer). Gibt das gleiche zurück… |
ups_track_shipment_packages | Verfolge jedes Paket einer Mehrpaketsendung von UPS anhand einer seiner Sendungsnummern: pro Paket die Sendungsnummer, aktuellen Status, letzten… |
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 | Bepreist 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 ein RatedShipment pro Dienst mit seinem Code, 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, Kundenzentren 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 | Erhalte das Etikett einer bereits existierenden Sendung erneut, anhand der Sendungsnummer. Gibt LabelRecoveryResponse.LabelResults mit dem Etikett als… zurück |
ups_get_pickup_rate | Gibt an, was eine Abholung von UPS auf Abruf an 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 dem Abholstatus… zurück |
ups_create_shipment | Erstellt 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 | Storniert (annulliert) 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 | Bucht eine Abholung von UPS auf Abruf: ein Fahrer kommt am angegebenen Tag zur Adresse. UPS erhebt eine Abholgebühr auf deinem Konto, daher ist das Tool… |
ups_cancel_pickup | Storniert 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."
FAQ
Woher stammen die UPS-Zugangsdaten? Aus einer App im UPS Developer Portal (developer.ups.com), erstellt mit dem ups.com-Profil, das dein Versenderkonto besitzt. Füge die Produkte Tracking, Adressvalidierung, Bewertung, Zeit in Transit und Locator hinzu, kopiere dann die Client-ID und das Client Secret. UPS_ACCOUNT_NUMBER ist deine 6-stellige Versendernummer.
Was deckt es ab und was nicht? Tracking nach Nummer oder Referenz, US-Adressvalidierung (nur Vereinigte Staaten und Puerto Rico), Tarife und Transitzeiten, Abgabe- und Access Point-Standorte, Schätzungen der Landekosten, Etikettenwiederherstellung und Abholangebote. Es verwendet Produktions-Zugangsdaten, nicht das UPS-Testsystem.
Kann es Sendungen erstellen oder Abholungen buchen? ups_create_shipment, ups_void_shipment, ups_create_pickup und ups_cancel_pickup sind standardmäßig deaktiviert, da sie Geld kosten. Füge die Produkte Versand und Abholung zu deiner App hinzu und schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.
Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.
Nächste Schritte
War dieser Guide hilfreich?