Amazon Shipping MCP-Server: Tarife und Sendungen

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Amazon Shipping, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

Amazon Shipping

Amazon Shipping API v2 (SP-API) für Unternehmen, die mit Amazon als Anbieter versenden: Tarife vergleichen, Pakete verfolgen, Etiketten und Dokumente erneut abrufen, Schließfächer und Abholstellen finden und Abholformulare lesen. Kauf, Ein-Klick-Kauf und Stornierung sind enthalten, aber deaktiviert. Private SP-API-App mit der Amazon Logistics-Rolle.

Einrichtung

Die Einrichtung dauert etwa 20 Minuten. Du benötigst die Plus Amazon Bewertungen.

1. Du benötigst ein Amazon Shipping-Konto. Verkäufer auf Amazon verwenden ihr Seller Central-Konto; andere Versender erstellen ein Konto unter https://solutionproviderportal.amazon.com (kein Verkäuferkonto erforderlich) und schließen die Entwickler-Identitätsprüfung ab.
2. Vervollständige das Entwicklerprofil: Wähle für Datenzugriff Privater Entwickler: Ich baue Anwendung(en), die mein eigenes Unternehmen mit Amazon Services APIs integrieren, wähle für Rollen Amazon Logistics. Amazon antwortet innerhalb von etwa 5 Werktagen.
3. Erstelle einen SP-API-App-Client mit dem Namen AmazonShipping_YourCompany, mit der Shipping Geschäftseinheit und der Amazon Logistics Rolle, und antworte Nein auf die Delegation des Zugriffs auf eingeschränkte (PII) Daten.
4. Wähle unter LWA-Zugangsdaten Anzeigen und kopiere die Client-ID (amzn1.application-oa2-client.…) in SPAPI_CLIENT_ID und das Client-Geheimnis in SPAPI_CLIENT_SECRET.
5. Autorisiere die App für dein eigenes Konto (App autorisieren) und kopiere das Refresh-Token (Atzr|…) in SPAPI_REFRESH_TOKEN.
6. Wähle die Region in SPAPI_ENDPOINT und dein Amazon Shipping-Land in AMAZON_SHIPPING_BUSINESS_ID. Vereinigte Staaten: Nordamerika. Vereinigtes Königreich, Frankreich, Italien, Spanien, Indien, Vereinigte Arabische Emirate, Saudi-Arabien, Ägypten: Europa. Japan: Fernost.

Der Connector tauscht das Refresh-Token unter https://api.amazon.com/auth/o2/token gegen einstündige Zugriffstoken aus und sendet sie im Header x-amz-access-token; der Header x-amzn-shipping-business-id trägt das Land. Die Variablen haben die gleichen Namen wie im Amazon Seller Central-Connector, aber die App muss die Amazon Logistics-Rolle haben: die Zugangsdaten einer Verkaufs-App ohne diese Rolle antworten mit 403.

Vor dem ersten echten Etikett: Amazon fordert jede neue Integration auf, ein Testetikett zu erstellen und genehmigen zu lassen (Amazon Shipping Test Label Guide) und bestätigt dann das erste Versanddatum. Halte die Kauf-Tools deaktiviert, bis dies erledigt ist.

Wo du anfangen kannst: amazon_shipping_get_rates mit der Absenderadresse, dem Ziel und einem Paket gibt die Dienstleistungen und Preise zurück; amazon_shipping_get_tracking verfolgt ein Paket anhand der Tracking-ID und der Carrier-ID.

Tarife: amazon_shipping_get_rates benötigt für jedes Paket eine packageClientReferenceId von dir, Abmessungen, Gewicht, den versicherten Wert und mindestens einen Artikel. channel_details.channelType ist EXTERNAL für Bestellungen aus deinem eigenen Shop und AMAZON (mit der Amazon-Bestell-ID) für Amazon-Bestellungen. Die Antwort enthält ein requestToken und eine rateId pro Dienst; beide werden benötigt, um zu kaufen und verfallen nach 10 Minuten. Wenn ein Tarif requiresAdditionalInputs angibt, lies das Schema mit amazon_shipping_get_additional_inputs.

Tracking und Dokumente: amazon_shipping_get_tracking gibt den Zusammenfassungsstatus und die Ereignishistorie zurück; amazon_shipping_get_shipment_documents gibt das Etikett eines gekauften Pakets erneut zurück (base64) und benötigt die Versand-ID und deine packageClientReferenceId. amazon_shipping_get_access_points findet Schließfächer und Zähler in der Nähe einer Postleitzahl.

Abholformulare: amazon_shipping_get_unmanifested_shipments zeigt, was noch auf ein Manifest wartet, amazon_shipping_get_collection_form_history und amazon_shipping_get_collection_form lesen frühere Formulare, und amazon_shipping_get_carrier_accounts listet verbundene Carrier-Konten auf. amazon_shipping_generate_collection_form schließt die offenen Sendungen eines Carriers ab und ist standardmäßig deaktiviert.

Kauf (deaktiviert): amazon_shipping_purchase_shipment kauft einen Tarif, amazon_shipping_one_click_shipment kauft nach Dienst-ID ohne Tarifanfrage, amazon_shipping_direct_purchase_shipment kauft für eine Amazon-Bestellung mit dem Dienst, den Amazon auswählt, und amazon_shipping_cancel_shipment storniert eine gekaufte Sendung vor der Übergabe. Jeder Kauf wird dem Amazon Shipping-Konto belastet. Übergebe einen Idempotenzschlüssel und verwende ihn erneut, wenn du es erneut versuchst, damit ein Timeout nicht doppelt kauft.

Formate: Beträge sind Objekte mit value und unit (der Währung); Gewichte verwenden GRAMM, KILOGRAMM, UNZE oder PFUND und Abmessungen ZOLL oder ZENTIMETER; Zeiten sind im ISO 8601-Format. Antworten sind in payload eingekapselt; Fehler kommen als errors, eine Liste von code, message und details.

Limits: 80 Aufrufe pro Sekunde mit einem Burst von 100 bei den meisten Operationen; der Antwortheader x-amzn-RateLimit-Limit zeigt das angewandte Limit an. Ein 429 bedeutet warten und erneut versuchen.

Voraussetzungen: SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

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 Amazon Shipping und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Vergleiche die Amazon Shipping-Tarife für ein 2 kg Paket von Manchester M1 1AE nach London SW1A 1AA."
• "Verfolge das Amazon Shipping-Paket QA0123456789 und sag mir den letzten Scan."
• "Finde Amazon-Schließfächer in der Nähe der Postleitzahl EC1A 1BB."
• "Hole das Etikett der Sendung, die ich heute Morgen gekauft habe, erneut."
• "Welche Sendungen sind noch nicht auf einem Abholformular?"

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT