ChatGPT en de OpenAI API verbinden met de Easyship MCP-server

In dit artikel wordt uitgelegd hoe je Easyship met OpenAI gebruikt, zodat je verzendtaken kunt beheren, waaronder tarieven vergelijken, zendingen aanmaken, labels kopen, ophalingen plannen en leveringen volgen, allemaal via natuurlijke taal.

Optie Geschikt voor Hoe maak je verbinding?
Deel 1: Easyship-plugin voor ChatGPT Iedereen die vanuit een ChatGPT-chat wil verzenden, zonder code Meld je aan bij Easyship en autoriseer (OAuth). Je hebt geen API-token nodig.
Deel 2: OpenAI Responses API of Agents SDK Ontwikkelaars die hun eigen AI-agents of apps met OpenAI bouwen Easyship API-token

Deel 1: De Easyship-plugin gebruiken met ChatGPT

Voordat je begint

Je hebt het volgende nodig:

  • Een ChatGPT-account op chatgpt.com

  • Een actief Easyship-account

Voor deze optie heb je geen Easyship API-token nodig.

Stap 1: Installeer de Easyship-plugin

  1. Log in bij ChatGPT

  2. Ga naar Plugins

  3. Zoek naar Easyship

  4. Klik op Install plugin

 

Stap 2: Autoriseer Easyship

  1. Klik na de installatie op Connect

  2. Je wordt doorgestuurd naar Easyship om je aan te melden. Log in op je Easyship-account als je dat nog niet hebt gedaan

  3. Controleer de gevraagde machtigingen en klik op Authorize

  4. Je keert terug naar ChatGPT en de Easyship-plugin wordt weergegeven als Connected

Let op: Er is geen afzonderlijke testomgeving voor MCP-acties. Voor elke actie die credits verbruikt, zoals het genereren van labels, worden echte kosten in rekening gebracht.

Stap 3: Begin Easyship in een chat te gebruiken

  1. Open een nieuwe chat in ChatGPT

  2. Typ @easyship en selecteer Easyship - Shipping MCP in de vervolgkeuzelijst

  3. Typ je prompt om te beginnen

Probeer een prompt zoals:

Ik wil een pakket verzenden van New York, VS naar Toronto, Canada. Herkomst: 350 5th Avenue, New York, US 10001. Bestemming: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Pakket: 1,98 lb, 6 × 4 × 2 cm. Artikel: zakelijke documenten, aantal 1, HS-code 4911.99, aangegeven waarde $1,00 USD, categorie documenten, DDU. Laat me de goedkoopste en voordeligste verzendopties zien, met levertijden en namen van vervoerders.

Deel 2: Easyship MCP gebruiken met de OpenAI Responses API of Agents SDK

Voordat je begint

Je hebt het volgende nodig:

  • Toegang tot de OpenAI Responses API of Agents SDK
  • Toegang tot je Easyship-dashboard
  • Een Easyship-account (API-toegang is zonder extra kosten beschikbaar voor alle abonnementen)

Stap 1: Haal je Easyship API-token op

  1. Ga naar je Easyship-dashboard en klik op Connect
  2. Klik op New Integration
  3. Scrol omlaag naar API Integration
  4. Selecteer onder Integration Type de optie I am developing a custom integration
  5. Geef de sleutel de naam Easyship MCP, zodat je deze gemakkelijk kunt terugvinden
  6. Behoud de standaardversie 2024-09 en klik op Connect
  7. Klik op de volgende pagina op Access Token en kopieer het token met de kopieerknop

Vereiste scopes: Je API-token moet de volgende scopes bevatten. Als scopes ontbreken, werken sommige tools niet, terwijl andere blijven werken.

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:read

Je kunt scopes op elk moment controleren en bijwerken via Dashboard → Connect → API, zonder een nieuw token aan te maken.

Stap 2: Voeg de Easyship MCP-server toe aan de Responses API

Geef de Easyship MCP-server door als tool in je aanroep responses.create(). Raadpleeg de documentatie over MCP-tools van OpenAI voor de volledige referentie.

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)

Vervang YOUR_EASYSHIP_TOKEN door het API-token dat je in stap 1 hebt gekopieerd.

Opmerking: require_approval: "never" zorgt ervoor dat het model Easyship-tools automatisch aanroept zonder te wachten op bevestiging. Stel dit in op "always" als je wilt dat het model om goedkeuring vraagt voordat het acties uitvoert, zoals het aanmaken van zendingen of kopen van labels.

Beveiliging: Sla je API-token nooit hardcoded op in broncode en deel het niet in een chatvenster. Sla het op als omgevingsvariabele, bijvoorbeeld EASYSHIP_API_ACCESS_TOKEN, en verwijs er tijdens runtime naar. Als je het token per ongeluk openbaar maakt, trek je sleutel dan onmiddellijk in en roteer deze via het Easyship-dashboard onder Connect → API.

Stap 3: Controleer de verbinding

Voer je script uit. Als de Easyship MCP-server correct is verbonden, roept het model de Easyship-tools automatisch aan en retourneert het verzendresultaten in resp.output_text.

Als je een verbindings- of authenticatiefout ziet, controleer dan je token en bevestig dat alle vereiste scopes zijn ingeschakeld in het Easyship-dashboard.

Stap 4: Probeer het uit

Probeer na het maken van de verbinding een prompt zoals:

Ik wil een pakket verzenden van New York, VS naar Toronto, Canada. Herkomst: 350 5th Avenue, New York, US 10001. Bestemming: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Pakket: 1,98 lb, 6 × 4 × 2 cm. Artikel: zakelijke documenten, aantal 1, HS-code 4911.99, aangegeven waarde $1,00 USD, categorie documenten, DDU. Laat me de goedkoopste en voordeligste verzendopties zien, met levertijden en namen van vervoerders.

Bekijk de Easyship MCP Developer Docs voor een volledige lijst met beschikbare tools en workflows.

ChatGPT-interface voor consumenten — binnenkort beschikbaar

Voor een directe integratie met de ChatGPT-interface voor consumenten op chat.openai.com is OAuth-ondersteuning vereist. Dit is momenteel nog niet beschikbaar voor de Easyship MCP-server. Zodra OAuth wordt ondersteund, kunnen gebruikers Easyship rechtstreeks vanuit de ChatGPT-interface verbinden, zonder code.

Veelgestelde vragen

Kan ik een bestaand API-token gebruiken of heb ik een nieuw token nodig? 

Je kunt een bestaand token van je Easyship-account gebruiken. Zorg er wel voor dat het alle vereiste scopes uit stap 1 heeft. Als sommige scopes ontbreken, werken bepaalde tools niet, terwijl andere wel werken.

Werkt dit met de ChatGPT-app of chat.openai.com? 

Nog niet. De integratie met de Responses API en Agents SDK is momenteel beschikbaar voor ontwikkelaars die met OpenAI bouwen. Voor de ChatGPT-interface voor consumenten is OAuth-ondersteuning van de MCP-server vereist; deze komt binnenkort beschikbaar.

Wat doet require_approval: "never"? 

Met deze instelling roept het OpenAI-model de Easyship MCP-tools automatisch aan zonder bij elke toolaanroep om goedkeuring van de gebruiker te vragen. Stel dit in op "always" als je wilt dat het model om bevestiging vraagt voordat het acties uitvoert, zoals het aanmaken van zendingen of kopen van labels.

Wat moet ik doen als het model de Easyship-tools niet aanroept? 

Controleer nogmaals je token en of de server_url is ingesteld op https://mcp.easyship.com/mcp. Zorg ervoor dat de waarde van de Authorization-header begint met Bearer (met een spatie), gevolgd door je token. Controleer ook of alle vereiste scopes zijn ingeschakeld in het Easyship-dashboard.

Wat moet ik doen als niet alle tools zijn geladen?

  • Controleer of je Easyship API-token geldig en actief is
  • Bevestig dat alle vereiste scopes zijn ingeschakeld in het Easyship-dashboard
  • Controleer de netwerkverbinding op de machine waarop het script wordt uitgevoerd
  • Controleer de OpenAI API-respons op foutmeldingen met betrekking tot de MCP-server

Waarom werkt mijn Easyship API-token niet? 

Controleer de scopes van je token in het Easyship-dashboard onder Connect → API. Een token kan voor sommige acties werken en voor andere niet, afhankelijk van de scopes die het bevat. Schakel voor volledige toegang tot alle tools alle scopes uit stap 1 in.

Wat gebeurt er als ik niet alle vereiste scopes toeken? 

Alleen de tools die overeenkomen met de toegekende scopes werken. Andere tools retourneren een fout. Je kunt scopes bijwerken in het Easyship-dashboard zonder een nieuw token aan te maken.

Moet ik betalen voor het Easyship API-token? 

Nee. Easyship biedt API-toegang voor alle abonnementen zonder extra kosten. Als je de inbegrepen API-limieten van je abonnement overschrijdt, kunnen extra kosten van toepassing zijn. Zie [abonnementen en inbegrepen limieten].

Kan ik hetzelfde Easyship-token gebruiken met andere clients (Claude, Cursor enzovoort)? 

Ja. Hetzelfde Easyship API-token werkt met elke MCP-client. Houd rekening met snelheidslimieten en voorkom conflicterende bewerkingen, zoals het gelijktijdig bewerken van dezelfde zending vanuit twee clients.

Was dit artikel nuttig?
Aantal gebruikers dat dit nuttig vond: 0 van 0
Populaire onderwerpen