Shippo MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 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 Shippo-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-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

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
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden