Skip to main content
Les outils sont les actions que votre agent d’IA peut effectuer dans Zippendo pour vous, comme créer une expédition ou lire une commande. Le serveur MCP propose un outil pour chaque action de l’API, et votre agent ne voit que les outils autorisés par les autorisations que vous approuvez.

​
Comment les outils correspondent aux autorisations

Chaque outil nécessite une autorisation (un scope) qui correspond à la ressource et à l’action :
  • Lire des données nécessite un scope read:. Lister les expéditions, par exemple, nécessite read:shipments.
  • Modifier des données nécessite le scope write: correspondant. Créer une expédition, par exemple, nécessite write:shipments.
Les scopes s’emboîtent, ce qui permet d’accorder large ou étroit :
  • write:all inclut read:all et chaque scope write: du tableau ci-dessous.
  • read:all inclut chaque scope read: du tableau ci-dessous.
  • write:<resource> inclut read:<resource> (write:shipments inclut read:shipments).
Un agent qui n’a reçu que read:shipments voit les outils de lecture des expéditions (liste, détails, suivi, documents), mais aucun des outils qui créent, envoient ou suppriment des expéditions.

​
Référence des scopes

L’écran de consentement peut aussi afficher d’autres autorisations, comme les organisations, les membres de l’équipe (org_members), les portails de retour et les jetons d’API. Elles ne débloquent aucun outil MCP aujourd’hui.
Accordez l’ensemble le plus restreint qui fait le travail. read:all plus write:shipments est un bon choix par défaut pour un assistant qui fait des rapports sur tout mais n’agit que sur les expéditions.

​
Exemples de demandes

Une fois connecté, parlez à votre agent en langage naturel. Il choisit les bons outils et interroge Zippendo :
  • « Combien d’expéditions sont encore en attente, et chez quels transporteurs sont-elles ? »
  • « Crée une expédition pour la commande #10421 avec PostNord et donne-moi le numéro de suivi. »
  • « Scinde l’expédition de la commande #10388 en deux colis et envoie les deux. »
  • « Quelles commandes des dernières 24 heures n’ont pas encore d’expédition ? »
  • « Suis l’expédition shp_8f3kd9 et dis-moi si elle est en retard. »
  • « Ajoute une règle d’expédition qui envoie les commandes de plus de 10 kg avec GLS. »

​
Outils de documentation et de SDK

Outre les outils d’action, le serveur MCP permet à un agent de lire la documentation de Zippendo, afin de vous aider à construire une intégration dans votre langage de programmation. Ces outils ne nécessitent aucun scope et tous les agents connectés les ont. L’agent a pour consigne de privilégier le SDK de votre langage, et de n’utiliser la spécification OpenAPI brute que s’il n’existe pas de SDK. Le contenu provient en direct de zippendo.com/docs et des dépôts des SDK, il est donc toujours à jour. Essayez des demandes comme :
  • « Avec le SDK Python de Zippendo, écris un script qui crée une expédition pour une commande et affiche le numéro de suivi. »
  • « Comment m’authentifier auprès de l’API Zippendo en Go ? Montre-moi la configuration du SDK. »
  • « Je suis en PHP. Écris un gestionnaire de webhook qui vérifie la signature et réagit à shipment.dispatched. »

​
Modèle de sécurité

Agit en votre nom

Les appels d’outils s’exécutent en votre nom, uniquement avec les autorisations que vous avez approuvées.

Une seule organisation

Une connexion appartient à une seule organisation. Elle ne peut ni lire ni modifier les données d’une autre organisation.

Aucun accès du personnel

Un agent ne peut jamais effectuer d’actions réservées au personnel de Zippendo.

Validation complète

Chaque appel passe les mêmes contrôles de connexion, de limites de l’offre et de validation que l’application.
Supprimer des expéditions, des commandes, des transporteurs, des adresses, des règles d’expédition ou des rôles, envoyer une expédition, et créer ou révoquer des jetons de paiement et des secrets de signature nécessitent tous une confirmation explicite dans l’appel d’outil : l’agent doit donc vous demander d’abord. Certaines actions sensibles, comme la facturation et la gestion des jetons d’API, sont entièrement exclues des outils et aucun agent ne peut les utiliser, quelles que soient ses autorisations.

​
Les mêmes outils alimentent Zippy

Le serveur MCP partage ses outils avec Zippy, l’assistant de l’application Zippendo. Seul l’endroit diffère : Zippy fonctionne dans l’application, tandis que MCP permet à votre propre outil d’IA d’utiliser les mêmes actions. Les deux appliquent les mêmes autorisations, limites d’organisation et validations.

Connecter votre agent

Prêt à le configurer ? Suivez le guide de configuration de votre outil.