> ## Documentation Index > Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Outils et scopes > Les outils proposés par le serveur MCP de Zippendo, les autorisations qui les débloquent et des exemples de demandes. 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](/docs/fr/mcp/authentication). ## 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:`** inclut **`read:`** (`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 | Ressource | Scope de lecture | Scope d'écriture | La lecture permet à l'agent de… | L'écriture lui permet aussi de… | | - | - | - | - | - | | Expéditions | `read:shipments` | `write:shipments` | Lister les expéditions, voir les détails et le suivi, obtenir les étiquettes d'expédition et les documents | Créer, modifier, envoyer, scinder et supprimer des expéditions ; déplacer des colis ; créer des expéditions retour ; récupérer à nouveau une étiquette | | Commandes | `read:orders` | `write:orders` | Lister les commandes et voir leurs détails | Créer, modifier et supprimer des commandes | | Transporteurs | `read:carriers` | `write:carriers` | Lister les transporteurs connectés et leurs offres transporteur | Connecter, mettre à jour et retirer des transporteurs ; rechercher des points relais | | Canaux de vente | `read:order_channels` | `write:order_channels` | Lister les canaux de vente et l'état de leurs webhooks | Créer, modifier et supprimer des canaux ; les synchroniser et les tester ; enregistrer leurs webhooks ; gérer les jetons de paiement et les secrets de signature | | Adresses | `read:addresses` | `write:addresses` | Lister les adresses d'expéditeur, d'enlèvement et de retour | Créer, mettre à jour et supprimer des adresses | | Règles d'expédition | `read:shipping_rules` | `write:shipping_rules` | Lister les règles d'expédition | Créer, modifier et supprimer des règles d'expédition | | Automatisations | `read:automations` | `write:automations` | Lister les automatisations, leurs exécutions et les étapes disponibles | Créer, modifier, supprimer et exécuter des automatisations | | Imprimantes | `read:printers` | `write:printers` | Lister les imprimantes | Enregistrer, approuver, désactiver, modifier et supprimer des imprimantes | | Webhooks | `read:webhooks` | `write:webhooks` | Lister les webhooks et leurs envois | Créer, modifier, tester et supprimer des webhooks | | Intégrations | `read:integrations` | `write:integrations` | Lister les intégrations disponibles, vos connexions et leurs envois | Connecter, modifier, tester et supprimer des intégrations | | Rôles | `read:roles` | `write:roles` | Lister les rôles | Créer, modifier et supprimer des rôles | | Membres de l'équipe | `read:users` | `write:users` | (aucun outil de lecture) | Ajouter un membre de l'équipe à l'organisation | | **Tout** | `read:all` | `write:all` | Tous les outils de lecture ci-dessus | Tous les outils ci-dessus | 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. | Outil | À quoi il sert | | - | - | | `search_documentation` | Recherche dans toute la documentation : guides, référence complète de l'API et pages des SDK. Omettez la requête pour parcourir tout l'index. | | `fetch_documentation` | Lit n'importe quelle page en markdown (les pages de la référence de l'API incluent la description OpenAPI du point d'accès). Passez `openapi` pour la spécification brute complète. | | `get_sdk_reference` | La référence du SDK pour chaque langage (TypeScript, Python, PHP, Go, Ruby) : signatures des méthodes et exemples exécutables. | 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](https://www.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é Les appels d'outils s'exécutent en votre nom, uniquement avec les autorisations que vous avez approuvées. Une connexion appartient à une seule organisation. Elle ne peut ni lire ni modifier les données d'une autre organisation. Un agent ne peut jamais effectuer d'actions réservées au personnel de Zippendo. 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. Prêt à le configurer ? Suivez le guide de configuration de votre outil. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.