Comment connecter ChatGPT et l’API OpenAI au serveur MCP Easyship

Cet article explique comment utiliser Easyship avec OpenAI afin de gérer les tâches d’expédition, notamment comparer les tarifs, créer des expéditions, acheter des étiquettes, planifier des enlèvements et suivre les livraisons, le tout en langage naturel.

Vous aurez besoin des éléments suivants :

• D’un compte ChatGPT sur chatgpt.com

• D’un compte Easyship actif

Vous n’avez pas besoin d’un jeton d’API Easyship pour cette option.

1. Connectez-vous à ChatGPT

2. Accédez à Plugins

3. Recherchez Easyship

4. Cliquez sur Install plugin

 

1. Après l’installation, cliquez sur Connect

2. Vous serez redirigé vers Easyship pour vous connecter. Connectez-vous à votre compte Easyship si ce n’est pas déjà fait

3. Vérifiez les autorisations demandées, puis cliquez sur Authorize

4. Vous serez redirigé vers ChatGPT et le plug-in Easyship apparaîtra comme Connected

À noter : Il n’existe pas d’environnement de test distinct pour les actions MCP. Toute action qui consomme des crédits, comme la génération d’étiquettes, entraînera des frais réels.

1. Ouvrez une nouvelle conversation dans ChatGPT

2. Saisissez @easyship et sélectionnez Easyship - Shipping MCP dans le menu déroulant

3. Saisissez votre invite pour commencer

Essayez une invite comme celle-ci :

Je souhaite expédier un colis de New York, États-Unis, à Toronto, Canada. Origine : 350 5th Avenue, New York, US 10001. Destination : 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Colis : 1,98 lb, 6 × 4 × 2 cm. Article : documents commerciaux, quantité : 1, code HS 4911.99, valeur déclarée : 1,00 $ USD, catégorie : documents, DDU. Affiche-moi les options d’expédition les moins chères et offrant le meilleur rapport qualité-prix, avec les délais de livraison et les noms des transporteurs.

Partie 2 : utiliser Easyship MCP avec l’API Responses d’OpenAI ou le SDK Agents

Avant de commencer

Vous aurez besoin des éléments suivants :

• Un accès à l’API Responses d’OpenAI ou au SDK Agents
• Un accès à votre tableau de bord Easyship
• Un compte Easyship (l’accès à l’API est disponible avec tous les forfaits, sans frais supplémentaires)

Étape 1 : obtenir votre jeton d’API Easyship

1. Accédez à votre tableau de bord Easyship et cliquez sur Connect
2. Cliquez sur New Integration
3. Faites défiler la page jusqu’à API Integration
4. Sous Integration Type, sélectionnez I am developing a custom integration
5. Nommez la clé Easyship MCP pour la retrouver facilement
6. Conservez la version par défaut 2024-09, puis cliquez sur Connect
7. Sur la page suivante, cliquez sur Access Token, puis copiez-le à l’aide du bouton de copie

Champs d’application requis : votre jeton d’API doit inclure les champs d’application suivants. Si certains champs sont manquants, certains outils échoueront tandis que d’autres continueront de fonctionner.

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

Vous pouvez vérifier et mettre à jour les champs d’application à tout moment dans Dashboard → Connect → API, sans créer de nouveau jeton.

Étape 2 : ajouter le serveur MCP Easyship à l’API Responses

Transmettez le serveur MCP Easyship en tant qu’outil dans votre appel responses.create(). Consultez la documentation des outils MCP d’OpenAI pour obtenir la référence complète.

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)

Remplacez YOUR_EASYSHIP_TOKEN par le jeton d’API copié à l’étape 1.

Remarque : require_approval: "never" indique au modèle d’appeler automatiquement les outils Easyship sans interrompre l’exécution pour demander une confirmation. Définissez cette valeur sur "always" si vous souhaitez que le modèle demande une autorisation avant d’effectuer des actions telles que la création d’expéditions ou l’achat d’étiquettes.

Sécurité : ne codez jamais votre jeton d’API en dur dans le code source et ne le partagez pas dans une fenêtre de conversation. Stockez-le en tant que variable d’environnement, par exemple EASYSHIP_API_ACCESS_TOKEN, et faites-y référence au moment de l’exécution. Si vous l’exposez accidentellement, révoquez et renouvelez immédiatement votre clé dans le tableau de bord Easyship, sous Connect → API.

Étape 3 : vérifier la connexion

Exécutez votre script. Si le serveur MCP Easyship est correctement connecté, le modèle appellera automatiquement les outils Easyship et renverra les résultats d’expédition dans resp.output_text.

Si vous rencontrez une erreur de connexion ou d’authentification, vérifiez votre jeton et confirmez que tous les champs d’application requis sont activés dans le tableau de bord Easyship.

Étape 4 : essayer

Une fois connecté, essayez une invite comme celle-ci :

Je souhaite expédier un colis de New York, États-Unis, à Toronto, Canada. Origine : 350 5th Avenue, New York, US 10001. Destination : 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Colis : 1,98 lb, 6 × 4 × 2 cm. Article : documents commerciaux, quantité : 1, code HS 4911.99, valeur déclarée : 1,00 $ USD, catégorie : documents, DDU. Affiche-moi les options d’expédition les moins chères et offrant le meilleur rapport qualité-prix, avec les délais de livraison et les noms des transporteurs.

Pour obtenir la liste complète des outils et workflows disponibles, consultez la documentation destinée aux développeurs Easyship MCP.

Interface utilisateur grand public de ChatGPT — bientôt disponible

L’intégration directe avec l’interface utilisateur grand public de ChatGPT à l’adresse chat.openai.com nécessite la prise en charge d’OAuth. Cette fonctionnalité n’est pas encore disponible pour le serveur MCP Easyship. Une fois OAuth pris en charge, les utilisateurs pourront connecter Easyship directement depuis l’interface ChatGPT, sans aucun code.

FAQ

Puis-je utiliser un jeton d’API existant ou dois-je en créer un nouveau ? 

Vous pouvez utiliser un jeton existant de votre compte Easyship. Assurez-vous simplement qu’il dispose de tous les champs d’application requis indiqués à l’étape 1. Si certains champs sont manquants, certains outils échoueront tandis que d’autres fonctionneront.

Cela fonctionne-t-il avec l’application ChatGPT ou chat.openai.com ? 

Pas encore. L’intégration avec l’API Responses et le SDK Agents est disponible dès maintenant pour les développeurs qui créent des solutions avec OpenAI. L’interface utilisateur grand public de ChatGPT nécessite la prise en charge d’OAuth par le serveur MCP, qui sera disponible prochainement.

Que fait require_approval: "never" ? 

Ce paramètre indique au modèle OpenAI d’appeler automatiquement les outils MCP Easyship sans interrompre l’exécution pour demander l’autorisation de l’utilisateur à chaque appel d’outil. Définissez cette valeur sur "always" si vous souhaitez que le modèle demande une confirmation avant d’effectuer des actions telles que la création d’expéditions ou l’achat d’étiquettes.

Que faire si le modèle n’appelle pas les outils Easyship ? 

Vérifiez votre jeton et assurez-vous que le server_url est https://mcp.easyship.com/mcp. Vérifiez que la valeur de l’en-tête Authorization commence par Bearer (avec un espace), suivie de votre jeton. Confirmez également que tous les champs d’application requis sont activés dans le tableau de bord Easyship.

Que faire si tous les outils ne sont pas chargés ?

• Vérifiez que votre jeton d’API Easyship est valide et actif
• Confirmez que tous les champs d’application requis sont activés dans le tableau de bord Easyship
• Vérifiez la connexion réseau de la machine qui exécute le script
• Vérifiez la réponse de l’API OpenAI pour détecter les éventuels messages d’erreur liés au serveur MCP

Pourquoi mon jeton d’API Easyship ne fonctionne-t-il pas ? 

Vérifiez les champs d’application de votre jeton dans le tableau de bord Easyship, sous Connect → API. Un jeton peut fonctionner pour certaines actions, mais échouer pour d’autres selon les champs d’application dont il dispose. Pour accéder à tous les outils, activez tous les champs d’application indiqués à l’étape 1.

Que se passe-t-il si je n’accorde pas tous les champs d’application requis ? 

Seuls les outils correspondant aux champs d’application accordés fonctionneront. Les autres outils renverront une erreur. Vous pouvez mettre à jour les champs d’application dans le tableau de bord Easyship sans créer de nouveau jeton.

Dois-je payer pour le jeton d’API Easyship ? 

Non. Easyship fournit un accès à l’API avec tous les forfaits, sans frais supplémentaires. Si vous dépassez les limites d’API incluses dans votre forfait, des frais de dépassement peuvent s’appliquer. Consultez [les forfaits et limites incluses].

Puis-je utiliser le même jeton Easyship avec d’autres clients (Claude, Cursor, etc.) ? 

Oui. Le même jeton d’API Easyship fonctionne avec n’importe quel client MCP. Tenez compte des limites de débit et évitez d’exécuter des opérations conflictuelles, comme modifier la même expédition depuis deux clients simultanément.