Shippo über MCP mit Gemini 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 + Gemini

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 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 Anleitung YOUR_SERVER_ID zeigt.

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" }
    }
  }
}

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 gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Shippo-Tools aufrufen.

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

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

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