Amazon Shipping MCP mit Microsoft Copilot verbinden

💡 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 + Microsoft Copilot

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

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:

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

Schritt 1 — Zugangsdaten erhalten

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

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 Rolle Amazon Logistics, und antworte mit Nein auf die Delegierung 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 Rolle Amazon Logistics haben: die Zugangsdaten einer Verkaufs-App ohne diese Rolle antworten mit 403.

Vor dem ersten echten Etikett: Amazon verlangt von jeder neuen Integration, 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 anfangen: 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.

Preise: 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 Preis 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 Abholfächer und -stellen 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 verknüpfte 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 Preis, amazon_shipping_one_click_shipment kauft ohne Preisabfrage nach Dienst-ID, 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 POUND und Abmessungen ZOLL oder ZENTIMETER; Zeiten sind ISO 8601. Antworten sind in payload eingewickelt; 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.

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Amazon Shipping-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Eingabeaufforderungen

• "Vergleiche die Amazon Shipping Preise 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-Abholfä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?"

FAQ

Woher kommen die Zugangsdaten? Von einer privaten SP-API-App mit der Rolle Amazon Logistics, erstellt in Seller Central oder, ohne Verkäuferkonto, im Amazon Solution Provider Portal. Kopiere die LWA-Client-ID und das Geheimnis, autorisiere die App für dein eigenes Konto, um das Refresh-Token zu erhalten, und wähle deine Region und dein Amazon Shipping-Land.

Welche Länder werden abgedeckt? Die Länder, in denen Amazon Shipping tätig ist: die Vereinigten Staaten, das Vereinigte Königreich, Frankreich, Italien, Spanien, Indien, die Vereinigten Arabischen Emirate, Saudi-Arabien, Ägypten und Japan. Es ist für Pakete gedacht, die mit Amazon als Carrier versendet werden, auch für Bestellungen, die nicht von Amazon stammen.

Kann es Etiketten kaufen oder Sendungen stornieren? amazon_shipping_purchase_shipment, amazon_shipping_direct_purchase_shipment, amazon_shipping_one_click_shipment, amazon_shipping_cancel_shipment und amazon_shipping_generate_collection_form sind standardmäßig deaktiviert. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden