Easyship MCP vous permet de gérer vos opérations d’expédition en langage naturel. Il vous suffit de saisir ce dont vous avez besoin, comme si vous discutiez avec un assistant.
Au lieu de passer d’un outil à l’autre ou de gérer manuellement les expéditions, vous pouvez comparer les tarifs, générer des étiquettes, suivre les expéditions, synchroniser les commandes, vérifier les adresses, gérer les enlèvements, calculer les taxes et les droits de douane, et bien plus encore.
Dans cet article :
- À qui s’adresse cette solution ?
- Plateformes prises en charge
- Ce dont vous avez besoin
- Configuration rapide
- Portée du jeton d’API
- Actions disponibles
- FAQ
À qui s’adresse cette solution ?
Easyship MCP est conçu pour :
- les marchands e-commerce
- les équipes chargées des opérations et de la gestion des expéditions
- les agents du service client
- toute personne qui gère les expéditions et la logistique
Aucune compétence en programmation n’est requise : une connaissance de base des paramètres et des clés d’API est toutefois utile pour la configuration initiale.
Plateformes prises en charge
Easyship MCP est compatible avec toute plateforme prenant en charge le Model Context Protocol. La méthode de connexion dépend de l’application :
- Se connecter avec Easyship (OAuth) : aucun jeton d’API n’est requis. Vous vous connectez à Easyship et autorisez l’accès depuis l’application.
- Jeton d’API : vous créez un jeton d’API Easyship et l’ajoutez aux paramètres MCP de l’application.
| Type de plateforme | Applications prises en charge | Applications prises en charge |
| Applications de chat / assistants | ChatGPT, Grok (grok.com), Claude (Desktop, Claude Code et autres) | ChatGPT et Grok : se connecter avec Easyship (OAuth). Claude : jeton d’API. Un connecteur Claude natif avec connexion Easyship (OAuth) sera bientôt disponible. |
| Environnements de développement avec IA | Cursor, Windsurf, Google Antigravity | Jeton d’API |
| IA et API cloud | OpenAI (Responses API, Agents SDK), Google Gemini (CLI, Code Assist et navigateur), Grok (API xAI et navigateur) | Jeton d’API |
| Automatisation des flux de travail | n8n, make.com, Zapier, Celigo | Jeton d’API |
| Approche orientée compétences / hybride | Perplexity, OpenClaw | Easyship Skill (disponible sur ClawHub) |
Ce dont vous avez besoin
Avant de commencer, assurez-vous de disposer des éléments suivants :
- un compte Easyship actif
- une application compatible avec MCP (voir la section Plateformes prises en charge ci-dessus)
- un jeton d’API Easyship, uniquement si votre application se connecte avec un jeton d’API (inutile pour ChatGPT ou Grok)
Comment se connecter
Option A : Se connecter avec Easyship (OAuth) : ChatGPT et Grok
Aucun jeton d’API n’est requis. Vous connectez Easyship depuis l’application et autorisez l’accès avec vos identifiants Easyship.
- Ajoutez Easyship dans votre application (installez le plug-in Easyship dans ChatGPT ou ajoutez un connecteur personnalisé dans Grok)
- Connectez-vous à votre compte Easyship lorsque vous êtes redirigé
- Vérifiez les autorisations et cliquez sur Autoriser
- Retournez dans votre application. Easyship apparaîtra comme connecté et vous pourrez commencer à saisir des requêtes
Pour obtenir des instructions détaillées pour votre plateforme, consultez :
- Comment connecter ChatGPT et l’API OpenAI au serveur MCP Easyship
- Comment connecter Grok au serveur MCP Easyship
Option B : Jeton d’API : Cursor, Claude, API OpenAI et autres clients MCP
Obtenir votre jeton d’API
- Connectez-vous à Easyship et accédez à Connecter > Nouvelle intégration.
- Faites défiler la page vers le bas et sélectionnez Intégration d’API.
- Sous Type d’intégration, sélectionnez Je développe une intégration personnalisée.
- Nommez la clé Easyship MCP pour pouvoir l’identifier facilement.
- Conservez la version par défaut 2024-09 et cliquez sur Connecter.
- Cliquez sur Jeton d’accès et copiez-le à l’aide du bouton de copie.
⚠️ Avertissement de sécurité : gardez votre jeton secret. Ne collez jamais votre jeton d’API dans un message de chat. Ajoutez-le uniquement dans les paramètres de votre application, où il est stocké de manière sécurisée. Toute personne disposant de votre jeton peut acheter des étiquettes sur votre compte.
Se connecter
- Ajoutez le serveur MCP Easyship dans l’application de votre choix.
- Collez votre jeton d’API lorsque vous y êtes invité.
- Enregistrez et connectez-vous.
Pour obtenir des instructions détaillées pour votre plateforme, consultez :
- Guide de configuration d’Easyship MCP pour Cursor
- Comment connecter ChatGPT et l’API OpenAI au serveur MCP Easyship
- Documentation destinée aux développeurs d’Easyship MCP
⚠️ À savoir : 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îne des frais réels. Si vous vous connectez avec un jeton d’API, nous vous recommandons d’utiliser un jeton d’API de test avec des portées limitées lors de votre première utilisation. Consultez vos offres tarifaires et limites incluses.
Portées du jeton d’API
Cette section s’applique uniquement si vous vous connectez avec un jeton d’API. Si vous vous connectez avec vos identifiants Easyship (OAuth), les autorisations sont accordées lorsque vous cliquez sur Autoriser.
Votre jeton d’API Easyship nécessite les portées suivantes. Sans celles-ci, certains outils ne fonctionneront pas :
| Portée | Utilisée pour |
| public.shipment:read | Répertorier, consulter et suivre les expéditions |
| public.shipment:write | Créer, mettre à jour, supprimer et annuler des expéditions |
| public.label:write | Acheter des étiquettes d’expédition |
| public.pickup:read | Répertorier les enlèvements et obtenir les créneaux d’enlèvement |
| public.pickup:write | Créer et annuler des enlèvements |
| public.address_validation:write | Valider les adresses internationales |
| public.address_validation_domestic:write | Valider les adresses aux États-Unis |
| public.shipment_document:read | Récupérer les métadonnées des factures commerciales |
| public.transaction_record:read | Consulter les transactions et la facturation |
| public.analytics:read | Tous les outils d’analyse |
| public.rate:read | Comparer les options et tarifs des transporteurs |
| public.track:read | Suivre l’état de livraison des colis |
Actions disponibles
Tarifs
| Outil | Fonction | Essayez cette requête |
| get_rates | Compare les options des transporteurs avec des tarifs réduits négociés à l’avance et les délais de livraison. | « Je veux expédier un colis de 0,05 kg (6×2×4 cm) depuis le 350 5th Avenue, New York, États-Unis, vers le 220 Yonge Street, Toronto, Canada. Affiche-moi les options les moins chères et offrant le meilleur rapport qualité-prix, avec les délais de livraison. » |
Expéditions
| Outil | Fonction | Essayez cette requête |
| create_shipment | Commence une expédition avec les adresses et les détails du colis. Enregistre-la comme brouillon ou achète une étiquette lorsqu’elle est prête. | « Crée une expédition brouillon depuis Jane Sender, 350 5th Avenue, New York, NY, vers John Recipient, 220 Yonge Street, Toronto, ON. Colis : 0,12 kg, 22×15×3 cm. N’achète pas encore d’étiquette. » |
| create_label | Achete et génère une étiquette d’expédition pour une expédition existante. | « Achète une étiquette pour l’expédition ESSG10006001 et donne-moi le lien de téléchargement. » |
| get_shipment | Consulte l’état et les coûts d’une expédition, ainsi que les liens permettant de télécharger son étiquette, son bordereau d’expédition ou sa facture. | « Affiche l’expédition ESSG10006001. J’ai besoin de tous les détails et des liens vers les documents : étiquette 4×6, bordereau d’expédition et facture commerciale A4. » |
| list_shipments | Parcourt ou recherche vos expéditions par pays, état et autres critères. | « Affiche la page 1 de mes expéditions, 20 par page. Exclue celles qui ont été annulées. Affiche uniquement les expéditions avec une étiquette générée ou imprimée, à destination du Canada. » |
| update_shipment | Modifie les détails d’une expédition existante avant son envoi. | « Pour l’expédition ESSG10006001, remplace le numéro de téléphone de destination par +1 416-555-0200 et ajoute Suite 400 comme ligne d’adresse 2. Ne modifie rien d’autre. » |
| cancel_shipment | Annule une expédition qui n’a pas encore été enlevée. | « Annule l’expédition ESSG10006001 et indique-moi si l’opération a réussi ou quelle erreur s’est produite. » |
| delete_shipment | Supprime une expédition brouillon ou qui n’a pas encore été envoyée. | « Supprime l’expédition ESSG10006001 : elle est encore à l’état de brouillon. Confirme-moi lorsque c’est terminé. » |
| track_shipment | Indique où se trouve un colis, son estimation de livraison et les événements de suivi récents. | « Suis l’expédition ESSG10006001. Quel est le dernier état, y a-t-il une date de livraison estimée et quels sont les trois derniers événements de suivi ? » |
Validation des adresses
| Outil | Fonction | Essayez cette requête |
| validate_address | Vérifie si une adresse est livrable et propose des corrections. | « Cette adresse est-elle valide pour une expédition Easyship : 1600 Amphitheatre Parkway, Building 43, Mountain View, CA 94043, US ? Ne la remplace pas automatiquement : indique seulement si elle est valide et les corrections recommandées. » |
Enlèvements
| Outil | Fonction | Essayez cette requête |
| get_pickup_slots | Indique quand un transporteur peut enlever vos colis avant la réservation. | « Pour l’expédition ESSG10006001, recherche l’identifiant du service du transporteur, puis récupère les créneaux d’enlèvement disponibles. Résume les trois prochains jours avec les créneaux disponibles. » |
| create_pickup | Réserve un transporteur pour enlever un ou plusieurs colis auprès du même transporteur. | « Planifie un enlèvement pour les expéditions ESSG10006001 et ESSG10006002 le 14 avril 2026. Récupère l’identifiant du transporteur depuis la première expédition et confirme l’identifiant de l’enlèvement une fois celui-ci créé. » |
| list_pickups | Affiche les enlèvements que vous avez planifiés, filtrés par transporteur, date ou état. | « Affiche mes enlèvements : page 1, 25 par page, transporteur USPS, date d’enlèvement 15 avril 2026, état demandé. » |
| get_pickup | Ouvre un enlèvement pour afficher tous les détails, notamment l’heure, le transporteur et les expéditions associées. | « Donne-moi tous les détails de l’enlèvement ESPICKUP-US-2026-0001. » |
| cancel_pickup | Annule un enlèvement planifié. | « Annule l’enlèvement ESPICKUP-US-2026-0001 et indique le résultat. » |
| list_pickup_shipments | Indique quels colis sont inclus dans un enlèvement planifié. | « Pour l’enlèvement ESPICKUP-US-2026-0001, répertorie les identifiants des expéditions et les destinations : page 1, 20 par page. » |
Facturation et analyses
| Outil | Fonction | Essayez cette requête |
| list_transactions | Consulte les frais et les crédits de votre compte Easyship par date, type ou expédition. | « Affiche mes transactions : page 1, 50 par page, du 1er mars au 9 avril 2026, type : expédition. » |
| list_billing_transactions | Affiche les éléments détaillés d’une facture donnée. | « Pour le document de facturation BDOC-2026-03-0042, répertorie les transactions de facturation, page 1, 50 par page, du 1er au 31 mars 2026. » |
| analytics_shipments | Indique le nombre d’expéditions créées au fil du temps, notamment les tendances quotidiennes. | « Affiche les analyses du volume d’expéditions du 9 janvier au 9 avril 2026, avec la tendance quotidienne et le jour de pointe. » |
| analytics_shipped_activity | Indique si les étiquettes ont réellement été utilisées au cours d’une période donnée, et pas seulement si des brouillons ont été créés. | « Du 9 janvier au 9 avril 2026, que montre Easyship concernant l’activité d’expédition réelle au cours de cette période ? » |
| analytics_status_breakdown | Affiche la répartition de vos expéditions par étape. | « Affiche la répartition des états des expéditions du 9 janvier au 9 avril 2026 : qu’est-ce qui est en cours et qu’est-ce qui est terminé ? » |
| analytics_top_couriers | Indique les transporteurs que vous utilisez le plus en fonction du volume. | « Du 9 janvier au 9 avril 2026, quels transporteurs ai-je le plus utilisés ? Classe-les avec le nombre d’expéditions et leur part du volume. » |
| analytics_top_destinations | Indique où vous envoyez le plus de colis. | « Du 9 janvier au 9 avril 2026, où est-ce que j’expédie le plus ? Résume les principaux pays et zones. » |
| analytics_by_channel | Indique quelle source génère vos expéditions. | « Pour les trois derniers mois, répartis mes expéditions par canal de vente, avec le nombre et le pourcentage pour chaque canal. » |
FAQ
Ai-je besoin d’un jeton d’API pour utiliser Easyship MCP ?
Pas toujours. ChatGPT et Grok se connectent avec votre compte Easyship (OAuth), aucun jeton d’API n’est donc requis. Les applications comme Cursor, Claude Desktop, n8n et l’API OpenAI utilisent un jeton d’API Easyship. Consultez la section Plateformes prises en charge ci-dessus pour savoir comment chaque application se connecte.
Dois-je apprendre des commandes spécifiques ?
Non, saisissez simplement ce dont vous avez besoin en langage courant. Essayez d’inclure autant de détails que possible dès le départ. S’il manque une information requise, l’agent vous la demandera ou vous proposera des valeurs parmi lesquelles choisir.
Puis-je utiliser cette solution avec Shopify ou d’autres plateformes ?
Oui. Connectez votre agent au MCP de Shopify (ou au MCP de votre plateforme) en parallèle d’Easyship MCP pour gérer vos flux d’expédition multiplateformes au même endroit.
Mes règles d’automatisation des expéditions Easyship s’appliquent-elles ?
Oui. Les expéditions traitées via MCP sont des expéditions Easyship standard. Toutes vos règles d’expédition, préférences tarifaires et configurations d’automatisation existantes s’appliquent donc.
Des frais me seront-ils facturés pour récupérer les tarifs via MCP ?
Non. La récupération des tarifs, la liste des expéditions et le suivi sont gratuits. Seuls l’achat d’étiquettes ou la réservation d’enlèvements consomment des crédits.
Dois-je payer pour utiliser Easyship MCP ?
Non. Easyship fournit un accès à l’API avec toutes les offres, sans frais supplémentaires. Des frais de dépassement peuvent s’appliquer si vous dépassez les limites mensuelles. Consultez toutes les offres tarifaires et limites de l’API pour plus de détails.
Puis-je connecter Easyship MCP à plusieurs applications ?
Oui. Vous pouvez connecter Easyship à autant d’applications MCP que vous le souhaitez. Les applications OAuth (comme ChatGPT et Grok) se connectent chacune avec leurs propres identifiants Easyship. Pour les applications qui utilisent un jeton d’API, le même jeton fonctionne avec Cursor, Claude, Gemini et d’autres applications. Tenez compte des limites de débit et évitez d’exécuter des opérations conflictuelles en même temps.
Puis-je traiter plusieurs expéditions à la fois ?
Oui. Vous pouvez traiter des commandes en nombre à l’aide de simples requêtes : importez un fichier CSV ou demandez à l’agent de récupérer vos X dernières expéditions et de générer automatiquement des étiquettes pour chacune d’elles. L’agent sélectionnera chaque expédition et achètera une étiquette pour celle-ci une par une, et signalera les expéditions pour lesquelles vos informations sont nécessaires avant l’achat de l’étiquette.
Pourquoi l’erreur « Subscription inactive » s’affiche-t-elle et comment la corriger ?
Votre abonnement Easyship n’est pas actif et les requêtes de votre compte ne peuvent donc pas être traitées. Réactivez votre offre ou mettez à jour votre mode de paiement dans le tableau de bord Easyship, puis réessayez. Vous n’avez pas besoin de vous reconnecter.