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.
In dit artikel:
- Deel 1: De Easyship-plugin gebruiken met ChatGpt
- Deel 2: Easyship MCP gebruiken met de OpenAI Responses API of Agents SDK
Er zijn twee manieren om verbinding te maken:
| 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
Log in bij ChatGPT
Ga naar Plugins
Zoek naar Easyship
Klik op Install plugin
Stap 2: Autoriseer Easyship
Klik na de installatie op Connect
Je wordt doorgestuurd naar Easyship om je aan te melden. Log in op je Easyship-account als je dat nog niet hebt gedaan
Controleer de gevraagde machtigingen en klik op Authorize
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
Open een nieuwe chat in ChatGPT
Typ @easyship en selecteer Easyship - Shipping MCP in de vervolgkeuzelijst
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
- Ga naar je Easyship-dashboard en klik op Connect
- Klik op New Integration
- Scrol omlaag naar API Integration
- Selecteer onder Integration Type de optie I am developing a custom integration
- Geef de sleutel de naam Easyship MCP, zodat je deze gemakkelijk kunt terugvinden
- Behoud de standaardversie 2024-09 en klik op Connect
- 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:readJe 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.