Shippo über MCP mit ChatGPT verbinden

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

Shippo + ChatGPT

Lass deine KI den Versand über Shippo erledigen: Adressen prüfen, Live-Tarife deiner Versanddienstleister vergleichen, Labels kaufen und erstatten lassen, Pakete verfolgen, Zollpapiere vorbereiten und Scan Forms erstellen. Der Testmodus ist kostenlos.

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:

SHIPPO_API_TOKEN

Schritt 1 — Zugangsdaten holen

1. Registriere dich kostenlos unter apps.goshippo.com/join, öffne dann das API-Portal unter portal.goshippo.com/api-config/api und geh zu API Configuration → Developer keys.
2. Klicke auf Create new test key, um alles kostenlos auszuprobieren, oder auf Create new live key, um echte Labels zu kaufen. Kopiere den Key sofort: Shippo zeigt ihn nur ein einziges Mal an. Test-Keys beginnen mit shippo_test_, Live-Keys mit shippo_live_.
3. Trage den Key genau so in SHIPPO_API_TOKEN ein, wie er angezeigt wird, ohne das Wort ShippoToken, und installiere dann den Connector.
4. Starte mit shippo_list_carrier_accounts: Das Tool sollte die eigenen Versandkonten von Shippo auflisten (zum Beispiel USPS), die in den USA sofort nutzbar sind, zusammen mit den Carrier-Namen, die shippo_get_tracking erwartet.

Test oder live: Das entscheidet der Key. Mit einem Test-Key sind Labels kostenlos und tragen das Wasserzeichen „SAMPLE - DO NOT MAIL“, Sendungsnummern werden nie aktualisiert, Erstattungen gelingen immer, und Manifeste (Scan Forms) gibt es nicht. Ein Test-Key sieht nur Testdaten, ein Live-Key nur Live-Daten. Versandkonten, die du in Shippo mit deinen eigenen Zugangsdaten beim Versanddienstleister verbindest, funktionieren nur in dem Modus, in dem sie angelegt wurden.

Ein Label kostet Geld: Mit einem Live-Key belastet shippo_buy_label dein Shippo-Konto sofort mit dem Labelpreis (plus eventueller Versicherung). Deshalb nennt die KI vorher Versanddienstleister, Service, Preis und beide Adressen und wartet auf dein Ja. shippo_create_shipment holt nur Live-Tarife ab und kauft nichts. Der Link zum Label läuft nach einer Weile ab; shippo_get_label liefert einen neuen. shippo_request_refund storniert ein Label, das danach nicht mehr verwendet werden kann, und fordert das Geld beim Versanddienstleister zurück. Das geht nur für unbenutzte Labels, die höchstens 90 Tage alt sind, und die Erstattung dauert Tage bis Wochen.

Berechtigungen und Nur lesen: Ein Key darf alles, was dein Shippo-Konto darf. Für ein Setup, das nie Geld ausgibt und keine Labels storniert, deaktiviere shippo_buy_label, shippo_request_refund und shippo_create_manifest. Die KI kann dann weiterhin Adressen prüfen, Tarife vergleichen, Pakete verfolgen und frühere Labels nachschlagen.

Internationale Sendungen: Sie brauchen eine Zollerklärung. Die KI legt mit shippo_create_customs_item eine Position pro Produkt an (Beschreibung, Menge, Nettogewicht, Wert, Ursprungsland, Zolltarifnummer), danach mit shippo_create_customs_declaration die Erklärung mit einer Person, die die Angaben bestätigt, und hängt sie an die Sendung. Halte Zolltarifnummern und Warenwerte deiner Produkte bereit.

Adressprüfung: shippo_validate_address speichert die geprüfte, vereinheitlichte Adresse (zum Beispiel mit der ZIP+4-Postleitzahl) als neue Adresse und lässt das Original unverändert; Sendungen gehen dann an die neue. Mit einem Test-Key kommen Adressen außerhalb der USA ungeprüft zurück; mit einem Live-Key ist ihre Prüfung kostenpflichtig.

Limits: Pro Minute erlaubt Shippo 500 Anlegevorgänge und 4.000 Abrufe einzelner Objekte, aber nur 50 Listenabfragen (10 mit einem Test-Key). Wird ein Limit überschritten, antwortet Shippo mit 429: Warte eine Minute und versuche es erneut.

Häufige Fehler: 401 Token does not exist heißt, dass der Key falsch ist oder gelöscht wurde: Erstelle unter API Configuration → Developer keys einen neuen und trage ihn ohne das Wort ShippoToken ein. 400 nennt das Feld, das fehlt oder ungültig ist, zum Beispiel eine Adresse, die der Versanddienstleister ablehnt. 422 oder ein Label mit Status ERROR heißt, dass der Versanddienstleister abgelehnt hat, etwa weil der Service diese Strecke nicht abdeckt oder Zolldaten fehlen; die Meldungen nennen den Grund. Ein Label oder eine Erstattung mit Status QUEUED oder WAITING wird noch bearbeitet: Frag ein paar Sekunden später noch einmal nach.

Der Connector kümmert sich nicht um Batches, Bestellungen, Abholungen, Webhooks außer der Registrierung für Sendungsverfolgung und nicht um das Verbinden eigener Versandkonten.

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 ChatGPT 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.

ChatGPT verbindet MCP-Server als eigene Apps im Entwicklermodus (Developer mode). Den gibt es in den kostenpflichtigen Tarifen, nicht im kostenlosen. In Business- und Enterprise-Workspaces muss ihn eventuell erst ein Admin freigeben.

1. Öffne in ChatGPT Settings → Security and login und aktiviere Developer mode.
2. Geh zu chatgpt.com/plugins und klicke auf +.
3. Gib einen Namen und eine kurze Beschreibung ein, z. B. Name: Shippo.
4. Trag unter Connection die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und erstelle die Verbindung.
5. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an (OAuth) und erlaubst den Zugriff.

Verfügbare Tools

Beispiel-Prompts

• „Vergleiche die Tarife von UPS und USPS für ein 2-kg-Paket (30 x 20 x 15 cm) von unserer gespeicherten Lageradresse an 350 5th Ave, New York, NY 10118, und zeig mir die günstigste und die schnellste Option.“
• „Wo ist das Paket mit der USPS-Sendungsnummer 9400111899223197428490 gerade, und wann soll es ankommen?“
• „Kauf das günstigste USPS-Label für die Bestellung von Acme Ltd an 233 S Wacker Dr, Chicago, IL 60606, und gib mir Sendungsnummer und Link zum Label.“
• „Bereite die Zollpapiere für 3 Keramiktassen im Gesamtwert von 45 USD an einen Kunden in Toronto, Kanada, vor und zeig mir dann die verfügbaren Tarife.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Connectors? Nein. Eigene MCP-Verbindungen brauchen den Entwicklermodus, und den gibt es nur in kostenpflichtigen Tarifen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden