In diesem Artikel wird erklärt, wie Sie Easyship mit OpenAI verwenden können, um Versandaufgaben per natürlicher Sprache zu verwalten, einschließlich des Vergleichs von Tarifen, der Erstellung von Sendungen, des Kaufs von Versandetiketten, der Planung von Abholungen und der Sendungsverfolgung.
In diesem Artikel:
- Teil 1: Easyship-Plugin mit ChatGPT verwenden
- Teil 2: Easyship MCP mit der OpenAI Responses API oder dem Agents SDK verwenden
Es gibt zwei Möglichkeiten, eine Verbindung herzustellen:
| Option | Am besten geeignet für | Wie stellen Sie die Verbindung her? |
| Teil 1: Easyship-Plugin für ChatGPT | Alle, die innerhalb eines ChatGPT-Chats versenden möchten, ohne Code schreiben zu müssen | Bei Easyship anmelden und autorisieren (OAuth). Kein API-Token erforderlich. |
| Teil 2: OpenAI Responses API oder Agents SDK | Entwickler, die eigene KI-Agenten oder Apps mit OpenAI erstellen | Easyship-API-Token |
Teil 1: Easyship-Plugin mit ChatGPT verwenden
Vorbereitung
Sie benötigen:
Ein ChatGPT-Konto unter chatgpt.com
Ein aktives Easyship-Konto
Für diese Option benötigen Sie kein Easyship-API-Token.
Schritt 1: Easyship-Plugin installieren
Melden Sie sich bei ChatGPT an
Gehen Sie zu Plugins
Suchen Sie nach Easyship
Klicken Sie auf Plugin installieren
Schritt 2: Easyship autorisieren
Klicken Sie nach der Installation auf Verbinden
Sie werden zu Easyship weitergeleitet, um sich anzumelden. Melden Sie sich bei Ihrem Easyship-Konto an, falls Sie dies noch nicht getan haben
Prüfen Sie die angeforderten Berechtigungen und klicken Sie auf Autorisieren
Sie kehren zu ChatGPT zurück und das Easyship-Plugin wird als Verbunden angezeigt
Hinweis: Es gibt keine separate Testumgebung für MCP-Aktionen. Für jede Aktion, die Guthaben verbraucht (z. B. das Erstellen von Versandetiketten), fallen echte Kosten an.
Schritt 3: Easyship in einem Chat verwenden
Öffnen Sie einen neuen Chat in ChatGPT
Geben Sie @easyship ein und wählen Sie im Dropdown-Menü Easyship – Versand MCP aus
Geben Sie Ihre Eingabe ein, um zu beginnen
Probieren Sie eine Eingabe wie diese:
Ich möchte ein Paket von New York, USA, nach Toronto, Kanada, versenden. Absender: 350 5th Avenue, New York, US 10001. Empfänger: 220 Yonge Street, Toronto, ON, Kanada M5B 2H1. Paket: 1,98 lb, 6 × 4 × 2 cm. Artikel: Geschäftsdokumente, Menge 1, HS-Code 4911.99, deklarierter Wert 1,00 $ USD, Kategorie Dokumente, DDU. Zeige mir die günstigsten Versandoptionen und das beste Preis-Leistungs-Verhältnis mit Lieferzeiten und Namen der Versanddienstleister.
Teil 2: Easyship MCP mit der OpenAI Responses API oder dem Agents SDK verwenden
Vorbereitung
Sie benötigen:
- Zugriff auf die OpenAI Responses API oder das Agents SDK
- Zugriff auf Ihr Easyship-Dashboard
- Ein Easyship-Konto (API-Zugriff ist für alle Tarife ohne zusätzliche Kosten verfügbar)
Schritt 1: Easyship-API-Token abrufen
- Gehen Sie zu Ihrem Easyship-Dashboard und klicken Sie auf Verbinden
- Klicken Sie auf Neue Integration
- Scrollen Sie nach unten zu API-Integration
- Wählen Sie unter Integrationstyp die Option Ich entwickle eine benutzerdefinierte Integration aus
- Nennen Sie den Schlüssel zur leichteren Zuordnung Easyship MCP
- Behalten Sie die Standardversion 2024-09 bei und klicken Sie auf Verbinden
- Klicken Sie auf der nächsten Seite auf Zugriffstoken und kopieren Sie es über die Kopierschaltfläche
Erforderliche Bereiche: Ihr API-Token muss die folgenden Bereiche enthalten. Fehlende Bereiche führen dazu, dass einige Tools fehlschlagen, während andere weiterhin funktionieren.
public.shipment:read public.shipment:write
public.label:write public.pickup:read
public.pickup:write public.address_validation:write
public.address_validation_domestic:write
public.shipment_document:read public.transaction_record:read
public.analytics:read public.rate:read
public.track:readSie können die Bereiche jederzeit unter Dashboard → Verbinden → API prüfen und aktualisieren, ohne ein neues Token zu erstellen.
Schritt 2: Easyship-MCP-Server zur Responses API hinzufügen
Übergeben Sie den Easyship-MCP-Server als Tool in Ihrem Aufruf von responses.create(). Eine vollständige Referenz finden Sie in der Dokumentation zu den MCP-Tools von OpenAI.
python
from openai import OpenAI
client = OpenAI()
resp = client.responses.create(
model="gpt-4.1",
tools=[{
"type": "mcp",
"server_label": "easyship",
"server_url": "https://mcp.easyship.com/mcp",
"require_approval": "never",
"headers": {
"Authorization": "Bearer YOUR_EASYSHIP_TOKEN"
}
}],
input="What are the cheapest shipping options from HK to NYC for a 1.5kg package?"
)
print(resp.output_text)Ersetzen Sie YOUR_EASYSHIP_TOKEN durch das API-Token, das Sie in Schritt 1 kopiert haben.
Hinweis: require_approval: "never" weist das Modell an, Easyship-Tools automatisch aufzurufen, ohne eine Bestätigung abzuwarten. Setzen Sie den Wert auf "always", wenn das Modell vor Aktionen wie dem Erstellen von Sendungen oder dem Kauf von Versandetiketten eine Genehmigung anfordern soll.
Sicherheit: Speichern Sie Ihr API-Token niemals fest im Quellcode und geben Sie es nicht in einem Chatfenster weiter. Speichern Sie es als Umgebungsvariable (z. B. EASYSHIP_API_ACCESS_TOKEN) und greifen Sie zur Laufzeit darauf zu. Falls Sie es versehentlich offengelegt haben, widerrufen und erneuern Sie den Schlüssel umgehend im Easyship-Dashboard unter Verbinden → API.
Schritt 3: Verbindung überprüfen
Führen Sie Ihr Skript aus. Wenn der Easyship-MCP-Server korrekt verbunden ist, ruft das Modell automatisch Easyship-Tools auf und gibt Versandergebnisse in resp.output_text zurück.
Wenn ein Verbindungs- oder Authentifizierungsfehler angezeigt wird, überprüfen Sie Ihr Token und stellen Sie sicher, dass alle erforderlichen Bereiche im Easyship-Dashboard aktiviert sind.
Schritt 4: Ausprobieren
Probieren Sie nach der Verbindung eine Eingabe wie diese aus:
Ich möchte ein Paket von New York, USA, nach Toronto, Kanada, versenden. Absender: 350 5th Avenue, New York, US 10001. Empfänger: 220 Yonge Street, Toronto, ON, Kanada M5B 2H1. Paket: 1,98 lb, 6 × 4 × 2 cm. Artikel: Geschäftsdokumente, Menge 1, HS-Code 4911.99, deklarierter Wert 1,00 $ USD, Kategorie Dokumente, DDU. Zeige mir die günstigsten Versandoptionen und das beste Preis-Leistungs-Verhältnis mit Lieferzeiten und Namen der Versanddienstleister.
Eine vollständige Liste der verfügbaren Tools und Workflows finden Sie in der Easyship-MCP-Entwicklerdokumentation.
ChatGPT-Benutzeroberfläche für Endnutzer – demnächst verfügbar
Die direkte Integration in die ChatGPT-Benutzeroberfläche für Endnutzer unter chat.openai.com erfordert OAuth-Unterstützung. Diese ist für den Easyship-MCP-Server derzeit noch nicht verfügbar. Sobald OAuth unterstützt wird, können Nutzer Easyship direkt über die ChatGPT-Oberfläche und ohne Code verbinden.
Häufig gestellte Fragen
Kann ich ein vorhandenes API-Token verwenden oder benötige ich ein neues?
Sie können ein vorhandenes Token aus Ihrem Easyship-Konto verwenden. Stellen Sie einfach sicher, dass es alle in Schritt 1 aufgeführten erforderlichen Bereiche enthält. Wenn einige Bereiche fehlen, schlagen bestimmte Tools fehl, während andere funktionieren.
Funktioniert dies mit der ChatGPT-App oder chat.openai.com?
Noch nicht. Die Integration mit der Responses API und dem Agents SDK ist heute für Entwickler verfügbar, die mit OpenAI arbeiten. Die ChatGPT-Benutzeroberfläche für Endnutzer erfordert OAuth-Unterstützung durch den MCP-Server, die demnächst verfügbar sein wird.
Was bewirkt require_approval: "never"?
Diese Einstellung weist das OpenAI-Modell an, Easyship-MCP-Tools automatisch aufzurufen, ohne bei jedem Tool-Aufruf eine Benutzerfreigabe anzufordern. Setzen Sie den Wert auf "always", wenn das Modell vor Aktionen wie dem Erstellen von Sendungen oder dem Kauf von Versandetiketten eine Bestätigung anfordern soll.
Was passiert, wenn das Modell keine Easyship-Tools aufruft?
Überprüfen Sie Ihr Token sowie, ob die Einstellung server_url auf https://mcp.easyship.com/mcp lautet. Stellen Sie sicher, dass der Wert des Authorization-Headers mit Bearer (einschließlich des Leerzeichens) beginnt und anschließend Ihr Token folgt. Prüfen Sie außerdem, ob alle erforderlichen Bereiche im Easyship-Dashboard aktiviert sind.
Was passiert, wenn nicht alle Tools geladen werden?
- Überprüfen Sie, ob Ihr Easyship-API-Token gültig und aktiv ist
- Stellen Sie sicher, dass alle erforderlichen Bereiche im Easyship-Dashboard aktiviert sind
- Überprüfen Sie die Netzwerkverbindung des Computers, auf dem das Skript ausgeführt wird
- Überprüfen Sie die Antwort der OpenAI API auf Fehlermeldungen im Zusammenhang mit dem MCP-Server
Warum funktioniert mein Easyship-API-Token nicht?
Überprüfen Sie die Bereiche Ihres Tokens im Easyship-Dashboard unter Verbinden → API. Ein Token kann für einige Aktionen funktionieren und bei anderen fehlschlagen, abhängig davon, welche Bereiche es enthält. Für den vollständigen Zugriff auf alle Tools aktivieren Sie alle in Schritt 1 aufgeführten Bereiche.
Was passiert, wenn ich nicht alle erforderlichen Bereiche gewähre?
Nur die Tools, die den gewährten Bereichen entsprechen, funktionieren. Andere Tools geben einen Fehler zurück. Sie können die Bereiche im Easyship-Dashboard aktualisieren, ohne ein neues Token zu erstellen.
Muss ich für das Easyship-API-Token bezahlen?
Nein. Easyship bietet API-Zugriff für alle Tarife ohne zusätzliche Kosten. Wenn Sie die in Ihrem Tarif enthaltenen API-Limits überschreiten, können Gebühren für die Überschreitung anfallen. Siehe [Tarife und enthaltene Limits].
Kann ich dasselbe Easyship-Token mit anderen Clients (Claude, Cursor usw.) verwenden?
Ja. Dasselbe Easyship-API-Token funktioniert mit jedem MCP-Client. Achten Sie auf Ratenlimits und vermeiden Sie widersprüchliche Vorgänge, z. B. die Bearbeitung derselben Sendung gleichzeitig über zwei Clients.