Mit Easyship MCP können Sie Ihre Versandabläufe in natürlicher Sprache verwalten. Geben Sie einfach ein, was Sie benötigen – ganz so, als würden Sie mit einem Assistenten chatten.
Statt zwischen verschiedenen Tools zu wechseln oder Sendungen manuell zu bearbeiten, können Sie Tarife vergleichen, Versandetiketten erstellen, Sendungen verfolgen, Bestellungen synchronisieren, Adressen überprüfen, Abholungen verwalten, Steuern und Zollgebühren berechnen und vieles mehr.
In diesem Artikel:
- Für wen ist dieser Artikel gedacht?
- Unterstützte Plattformen
- Was Sie benötigen
- Schnelle Einrichtung
- Umfang der API-Token-Berechtigungen
- Verfügbare Aktionen
- Häufig gestellte Fragen
Für wen ist dieser Artikel gedacht?
Easyship MCP wurde entwickelt für:
- E-Commerce-Händler
- Operations- und Fulfillment-Teams
- Kundensupport-Mitarbeiter
- Alle, die Versand und Logistik verwalten
Programmierkenntnisse sind nicht erforderlich – grundlegende Kenntnisse im Umgang mit Einstellungen und API-Schlüsseln sind für die Ersteinrichtung hilfreich.
Unterstützte Plattformen
Easyship MCP ist mit jeder Plattform kompatibel, die das Model Context Protocol unterstützt. Wie Sie die Verbindung herstellen, hängt von der jeweiligen App ab:
- Mit Easyship anmelden (OAuth): Kein API-Token erforderlich. Sie melden sich bei Easyship an und autorisieren den Zugriff direkt in der App.
- API-Token: Sie erstellen ein Easyship-API-Token und fügen es in den MCP-Einstellungen der App hinzu.
| Plattformtyp | Unterstützte Apps | Unterstützte Apps |
| Chat-/Assistenten-Apps | ChatGPT, Grok (grok.com), Claude (Desktop, Claude Code und mehr) | ChatGPT und Grok: Mit Easyship anmelden (OAuth). Claude: API-Token. Eine native Claude-Verbindung mit Easyship-Anmeldung (OAuth) wird in Kürze verfügbar sein. |
| KI-Entwicklungsumgebungen | Cursor, Windsurf, Google Antigravity | API-Token |
| Cloud-KI und APIs | OpenAI (Responses API, Agents SDK), Google Gemini (CLI, Code Assist und Browser), Grok (xAI API und Browser) | API-Token |
| Workflow-Automatisierung | n8n, make.com, Zapier, Celigo | API-Token |
| Skills-First / Hybrid | Perplexity, OpenClaw | Easyship Skill (auf ClawHub verfügbar) |
Was Sie benötigen
Stellen Sie vor dem Start sicher, dass Sie Folgendes haben:
- Ein aktives Easyship-Konto
- Eine MCP-kompatible App (siehe oben unter „Unterstützte Plattformen“)
- Ein Easyship-API-Token, sofern Ihre App eine Verbindung über ein API-Token herstellt (für ChatGPT oder Grok nicht erforderlich)
Verbindung herstellen
Option A: Mit Easyship anmelden (OAuth): ChatGPT und Grok
Es ist kein API-Token erforderlich. Sie verbinden Easyship innerhalb der App und autorisieren den Zugriff mit Ihren Easyship-Anmeldedaten.
- Fügen Sie Easyship in Ihrer App hinzu (installieren Sie das Easyship-Plug-in in ChatGPT oder fügen Sie in Grok eine benutzerdefinierte Verbindung hinzu).
- Melden Sie sich bei Ihrem Easyship-Konto an, wenn Sie weitergeleitet werden.
- Überprüfen Sie die Berechtigungen und klicken Sie auf Autorisieren
- Kehren Sie zu Ihrer App zurück. Easyship wird als verbunden angezeigt und Sie können mit der Eingabe von Prompts beginnen.
Eine schrittweise Anleitung für Ihre jeweilige Plattform finden Sie hier:
- So verbinden Sie ChatGPT und die OpenAI API mit dem Easyship-MCP-Server
- So verbinden Sie Grok mit dem Easyship-MCP-Server
Option B: API-Token: Cursor, Claude, OpenAI API und andere MCP-Clients
API-Token abrufen
- Melden Sie sich bei Easyship an und gehen Sie zu Connect > New Integration.
- Scrollen Sie nach unten und wählen Sie API Integration aus.
- Wählen Sie unter Integration Type die Option I am developing a custom integration aus.
- Nennen Sie den Schlüssel Easyship MCP, damit Sie ihn leicht wiederfinden.
- Behalten Sie die Standardversion 2024-09 bei und klicken Sie auf Connect.
- Klicken Sie auf Access Token und kopieren Sie es über die Kopierschaltfläche.
⚠️ Sicherheitshinweis: Bewahren Sie Ihr Token geheim auf. Fügen Sie Ihr API-Token niemals in eine Chatnachricht ein. Fügen Sie es nur in den Einstellungen Ihrer App hinzu, wo es sicher gespeichert wird. Jeder, der über Ihr Token verfügt, kann über Ihr Konto Versandetiketten kaufen.
Verbinden
- Fügen Sie den Easyship-MCP-Server in Ihrer ausgewählten App hinzu.
- Fügen Sie Ihr API-Token ein, wenn Sie dazu aufgefordert werden.
- Speichern Sie die Einstellungen und stellen Sie die Verbindung her.
Eine schrittweise Anleitung für Ihre jeweilige Plattform finden Sie hier:
- Easyship-MCP-Einrichtungsanleitung für Cursor
- So verbinden Sie ChatGPT und die OpenAI API mit dem Easyship-MCP-Server
- Easyship-MCP-Entwicklerdokumentation
⚠️ Hinweis: Für MCP-Aktionen gibt es keine separate Testumgebung. Für jede Aktion, die Guthaben verbraucht (z. B. das Erstellen von Versandetiketten), fallen echte Kosten an. Wenn Sie eine Verbindung über ein API-Token herstellen, empfehlen wir, für den ersten Durchlauf ein Test-API-Token mit eingeschränkten Berechtigungen zu verwenden. Bitte überprüfen Sie Ihre Preismodelle und enthaltenen Limits.
Umfang der API-Token-Berechtigungen
Dieser Abschnitt gilt nur, wenn Sie eine Verbindung über ein API-Token herstellen. Wenn Sie sich über Easyship anmelden (OAuth), werden die Berechtigungen erteilt, sobald Sie auf Autorisieren klicken.
Ihr Easyship-API-Token benötigt die folgenden Berechtigungsumfänge. Ohne diese schlagen einige Tools fehl:
| Berechtigungsumfang | Verwendung |
| public.shipment:read | Sendungen auflisten, abrufen und verfolgen |
| public.shipment:write | Sendungen erstellen, aktualisieren, löschen und stornieren |
| public.label:write | Versandetiketten kaufen |
| public.pickup:read | Abholungen auflisten und Abholzeitfenster abrufen |
| public.pickup:write | Abholungen erstellen und stornieren |
| public.address_validation:write | Internationale Adressen validieren |
| public.address_validation_domestic:write | US-Adressen validieren |
| public.shipment_document:read | Metadaten zu Handelsrechnungen abrufen |
| public.transaction_record:read | Transaktionen und Abrechnungen anzeigen |
| public.analytics:read | Alle Analysetools |
| public.rate:read | Versanddienstleister und Tarife vergleichen |
| public.track:read | Zustellstatus von Paketen verfolgen |
Verfügbare Aktionen
Tarife
| Tool | Funktion | Diesen Prompt ausprobieren |
| get_rates | Vergleichen Sie Versanddienstleister mit vorab ausgehandelten, vergünstigten Tarifen und Lieferzeiten. | „Ich möchte ein 0,05 kg schweres Paket (6×2×4 cm) von 350 5th Avenue, New York, USA, an 220 Yonge Street, Toronto, Kanada, versenden. Zeige mir die günstigsten Optionen und die Optionen mit dem besten Preis-Leistungs-Verhältnis einschließlich der Lieferzeiten.“ |
Sendungen
| Tool | Funktion | Diesen Prompt ausprobieren |
| create_shipment | Starten Sie eine Sendung mit Adressen und Paketdetails. Speichern Sie sie als Entwurf oder kaufen Sie ein Versandetikett, sobald alles bereit ist. | „Bitte erstelle eine Sendung als Entwurf von Jane Sender, 350 5th Avenue, New York, NY, an John Recipient, 220 Yonge Street, Toronto, ON. Paket: 0,12 kg, 22×15×3 cm. Kaufe noch kein Versandetikett.“ |
| create_label | Kaufen und erstellen Sie ein Versandetikett für eine bestehende Sendung. | „Kaufe ein Versandetikett für die Sendung ESSG10006001 und gib mir den Download-Link.“ |
| get_shipment | Rufen Sie den Status und die Kosten einer Sendung sowie Links zum Herunterladen des Versandetiketts, Lieferscheins oder der Rechnung ab. | „Rufe die Sendung ESSG10006001 auf. Ich benötige alle Details und Dokumentlinks – 4×6-Versandetikett, Lieferschein und Handelsrechnung im A4-Format.“ |
| list_shipments | Durchsuchen oder suchen Sie Ihre Sendungen nach Land, Status und weiteren Kriterien. | „Zeige mir Seite 1 meiner Sendungen, 20 pro Seite. Schließe stornierte Sendungen aus. Zeige nur Sendungen nach Kanada mit erstelltem oder gedrucktem Versandetikett.“ |
| update_shipment | Bearbeiten Sie die Details einer bestehenden Sendung, bevor sie versendet wird. | „Aktualisiere für die Sendung ESSG10006001 die Telefonnummer des Empfängers auf +1 416-555-0200 und füge Suite 400 als Adresszeile 2 hinzu. Belasse alles andere unverändert.“ |
| cancel_shipment | Stornieren Sie eine Sendung, die noch nicht abgeholt wurde. | „Storniere die Sendung ESSG10006001 und teile mir mit, ob die Stornierung erfolgreich war oder welcher Fehler zurückgegeben wurde.“ |
| delete_shipment | Entfernen Sie eine Sendung als Entwurf oder eine noch nicht versendete Sendung. | „Lösche die Sendung ESSG10006001 – sie ist noch ein Entwurf. Bestätige, wenn sie gelöscht wurde.“ |
| track_shipment | Sehen Sie, wo sich ein Paket befindet, wann es voraussichtlich zugestellt wird und welche aktuellen Tracking-Ereignisse vorliegen. | „Verfolge die Sendung ESSG10006001. Wie lautet der aktuelle Status, gibt es eine voraussichtliche Zustellzeit und was waren die letzten drei Tracking-Ereignisse?“ |
Adressvalidierung
| Tool | Funktion | Diesen Prompt ausprobieren |
| validate_address | Prüfen Sie, ob eine Adresse zustellbar ist, und erhalten Sie Korrekturvorschläge. | „Ist diese Adresse für den Versand mit Easyship gültig: 1600 Amphitheatre Parkway, Building 43, Mountain View, CA 94043, US? Ersetze sie nicht automatisch – zeige nur, ob sie gültig ist, sowie empfohlene Korrekturen.“ |
Abholungen
| Tool | Funktion | Diesen Prompt ausprobieren |
| get_pickup_slots | Sehen Sie, wann ein Versanddienstleister Ihre Pakete abholen kann, bevor Sie die Abholung buchen. | „Rufe für die Sendung ESSG10006001 die ID des Versanddienstleisters ab und ermittle anschließend die verfügbaren Abholzeitfenster. Fasse die nächsten drei Tage mit den verfügbaren Zeitfenstern zusammen.“ |
| create_pickup | Buchen Sie einen Versanddienstleister, der ein oder mehrere Pakete beim selben Versanddienstleister abholt. | „Plane für die Sendungen ESSG10006001 und ESSG10006002 am 14. April 2026 eine Abholung. Ermittle die Versanddienstleister-ID aus der ersten Sendung und bestätige nach der Erstellung die Abhol-ID.“ |
| list_pickups | Zeigen Sie geplante Abholungen an, gefiltert nach Versanddienstleister, Datum oder Status. | „Zeige meine Abholungen: Seite 1, 25 pro Seite, Versanddienstleister USPS, Abholdatum 15. April 2026, Status angefordert.“ |
| get_pickup | Öffnen Sie eine Abholung, um alle Details einschließlich Uhrzeit, Versanddienstleister und verknüpfter Sendungen anzuzeigen. | „Gib mir alle Details zur Abholung ESPICKUP-US-2026-0001.“ |
| cancel_pickup | Stornieren Sie eine geplante Abholung. | „Storniere die Abholung ESPICKUP-US-2026-0001 und gib das Ergebnis aus.“ |
| list_pickup_shipments | Sehen Sie, welche Pakete in einer geplanten Abholung enthalten sind. | „Liste für die Abholung ESPICKUP-US-2026-0001 die Sendungs-IDs und Zielorte auf – Seite 1, 20 pro Seite.“ |
Abrechnung und Analysen
| Tool | Funktion | Diesen Prompt ausprobieren |
| list_transactions | Überprüfen Sie Belastungen und Gutschriften auf Ihrem Easyship-Konto nach Datum, Typ oder Sendung. | „Rufe meine Transaktionen ab: Seite 1, 50 pro Seite, vom 1. März bis 9. April 2026, Typ: Sendung.“ |
| list_billing_transactions | Sehen Sie die Einzelposten hinter einer bestimmten Rechnung ein. | „Liste für das Abrechnungsdokument BDOC-2026-03-0042 die Abrechnungstransaktionen auf: Seite 1, 50 pro Seite, zwischen dem 1. und 31. März 2026.“ |
| analytics_shipments | Sehen Sie, wie viele Sendungen Sie im Laufe der Zeit erstellt haben, einschließlich täglicher Trends. | „Zeige die Analyse des Sendungsvolumens vom 9. Januar bis 9. April 2026, einschließlich des täglichen Trends und des Tages mit dem höchsten Volumen.“ |
| analytics_shipped_activity | Sehen Sie, ob Versandetiketten in einem bestimmten Zeitraum tatsächlich verwendet wurden und nicht nur Entwürfe erstellt wurden. | „Was zeigt Easyship für den Zeitraum vom 9. Januar bis 9. April 2026 über die tatsächlich versendeten Sendungen?“ |
| analytics_status_breakdown | Sehen Sie eine Aufschlüsselung Ihrer Sendungen nach Bearbeitungsphase. | „Zeige mir die Aufschlüsselung des Sendungsstatus vom 9. Januar bis 9. April 2026 – was ist in Bearbeitung und was abgeschlossen?“ |
| analytics_top_couriers | Sehen Sie, welche Versanddienstleister Sie nach Volumen am häufigsten verwenden. | „Welche Versanddienstleister habe ich vom 9. Januar bis 9. April 2026 am häufigsten verwendet? Ordne sie nach Anzahl und Anteil am Volumen.“ |
| analytics_top_destinations | Sehen Sie, wohin Sie die meisten Pakete versenden. | „Wohin versende ich vom 9. Januar bis 9. April 2026 am meisten? Fasse die wichtigsten Länder und Zonen zusammen.“ |
| analytics_by_channel | Sehen Sie, welche Quelle Ihre Sendungen generiert. | „Schlüssele meine Sendungen der letzten drei Monate nach Vertriebskanal auf, einschließlich Anzahl und prozentualem Anteil je Kanal.“ |
Häufig gestellte Fragen
Benötige ich ein API-Token, um Easyship MCP zu verwenden?
Nicht immer. ChatGPT und Grok stellen die Verbindung her, indem Sie sich mit Ihrem Easyship-Konto anmelden (OAuth); daher ist kein API-Token erforderlich. Apps wie Cursor, Claude Desktop, n8n und die OpenAI API verwenden ein Easyship-API-Token. Unter „Unterstützte Plattformen“ oben erfahren Sie, wie die jeweilige App eine Verbindung herstellt.
Muss ich bestimmte Befehle lernen?
Nein, geben Sie einfach in natürlicher Sprache ein, was Sie benötigen. Versuchen Sie, von Anfang an so viele Details wie möglich anzugeben. Wenn erforderliche Angaben fehlen, fragt der Agent danach oder schlägt Werte zur Auswahl vor.
Kann ich Easyship MCP mit Shopify oder anderen Plattformen verwenden?
Ja. Verbinden Sie Ihren Agenten zusätzlich zu Easyship MCP mit dem MCP von Shopify (oder dem MCP Ihrer Plattform), um plattformübergreifende Versandabläufe an einem Ort zu verwalten.
Gelten meine Easyship-Regeln für die Versandautomatisierung?
Ja. Über MCP verarbeitete Sendungen sind normale Easyship-Sendungen. Daher gelten alle bestehenden Versandregeln, Tarifpräferenzen und Automatisierungseinstellungen.
Werden mir über MCP abgerufene Tarife berechnet?
Nein. Das Abrufen von Tarifen, das Auflisten von Sendungen und die Sendungsverfolgung sind kostenlos. Nur der Kauf von Versandetiketten oder die Buchung von Abholungen verbraucht Guthaben.
Muss ich für die Nutzung von Easyship MCP bezahlen?
Nein. Easyship bietet API-Zugriff für alle Tarife ohne zusätzliche Kosten. Wenn Sie die monatlichen Limits überschreiten, können Gebühren für die Überschreitung anfallen. Weitere Informationen finden Sie unter API-Preismodelle und -Limits.
Kann ich Easyship MCP mit mehreren Apps verbinden?
Ja. Sie können Easyship mit beliebig vielen MCP-Apps verbinden. OAuth-Apps wie ChatGPT und Grok stellen jeweils über eine eigene Easyship-Anmeldung die Verbindung her. Für Apps, die ein API-Token verwenden, funktioniert dasselbe Token mit Cursor, Claude, Gemini und weiteren Apps. Beachten Sie die Ratenlimits und vermeiden Sie gleichzeitig ausgeführte, miteinander in Konflikt stehende Vorgänge.
Kann ich mehrere Sendungen gleichzeitig bearbeiten?
Ja. Sie können große Bestellmengen mit einfachen Prompts bearbeiten – laden Sie eine CSV-Datei hoch oder bitten Sie den Agenten, Ihre letzten X Sendungen abzurufen und automatisch für alle Versandetiketten zu erstellen. Der Agent wählt jede Sendung einzeln aus und kauft dafür ein Versandetikett. Sendungen, für die vor dem Kauf des Versandetiketts Ihre Eingaben erforderlich sind, werden gekennzeichnet.
Warum wird mir der Fehler „Subscription inactive“ angezeigt und wie kann ich ihn beheben?
Ihr Easyship-Abonnement ist nicht aktiv, daher können Anfragen von Ihrem Konto nicht verarbeitet werden. Reaktivieren Sie Ihren Tarif oder aktualisieren Sie Ihre Zahlungsmethode im Easyship-Dashboard und versuchen Sie es anschließend erneut. Sie müssen die Verbindung nicht erneut herstellen.