> ## 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.

# Serveur MCP

> Connectez des outils d'IA comme Claude, ChatGPT et Cursor à vos données Zippendo grâce au Model Context Protocol (MCP).

Le connecteur MCP permet à des outils d'IA comme Claude, ChatGPT et Cursor de travailler avec vos données Zippendo : demandez en langage courant, et l'assistant crée des expéditions, suit des colis et lit vos commandes à votre place.

Zippendo exploite son propre **MCP (Model Context Protocol) server** (serveur MCP). Un outil d'IA connecté utilise les mêmes autorisations et les mêmes contrôles que l'application Zippendo. Il fonctionne avec tout client MCP, notamment Claude Code, Claude Desktop, Claude sur le web, Cursor, VS Code (GitHub Copilot), Windsurf, ChatGPT, Codex CLI, Gemini CLI et vos propres agents.

<Card title="URL du connecteur" icon="server" horizontal>
  ```
  https://api.zippendo.com/mcp
  ```

  HTTP en flux continu (Streamable HTTP), protégé par OAuth 2.1. Ajoutez l'URL à votre outil d'IA et connectez-vous : rien à installer et aucun jeton à copier.
</Card>

## Comment se connecter

Ajoutez `https://api.zippendo.com/mcp` à votre outil d'IA comme connecteur MCP personnalisé. L'outil ouvre la page de connexion Zippendo dans votre navigateur, où vous choisissez l'organisation et approuvez les autorisations. Votre outil maintient ensuite la connexion à jour tout seul.

Dans l'application Zippendo, **Apps & integrations** → **Catalog** → **MCP (AI agents)** → **Connect** vous guide à travers les mêmes étapes pour votre outil. Voir [Connecter votre agent](/docs/fr/mcp/connect) pour chaque outil.

## Ce que vous pouvez faire

Une fois connecté, l'agent peut travailler sur l'ensemble de vos données Zippendo, dans la limite des autorisations que vous approuvez :

* **Shipments** : créer, scinder, envoyer et suivre des expéditions ; obtenir les étiquettes et les documents.
* **Orders** : lire les commandes importées par vos canaux de vente et les transformer en expéditions.
* **Carriers** : lister les transporteurs connectés et leurs offres transporteur, et rechercher des points relais.
* **Addresses and shipping rules** : lire et gérer les adresses de l'expéditeur et les règles d'expédition.
* **Automations, webhooks, printers and more** : l'essentiel de ce que propose l'API.

Les outils exacts dépendent des autorisations que vous accordez. Voir [Outils et scopes](/docs/fr/mcp/tools) pour la liste complète.

## Prérequis

* Un compte Zippendo ayant accès à au moins une organisation. Un membre de l'équipe limité à une marque ne peut pas connecter d'agent.
* Un client MCP qui prend en charge les connecteurs distants. Certains outils d'IA ne proposent les connecteurs personnalisés que sur les formules payantes (par exemple ChatGPT). Voir [Connecter votre agent](/docs/fr/mcp/connect).

## Fonctionnement

L'URL du connecteur est un serveur MCP Streamable HTTP intégré à l'API Zippendo. Il offre les mêmes outils que **Zippy**, l'assistant de l'application Zippendo. Chaque appel d'outil passe par la véritable API, avec la même connexion, les mêmes contrôles d'autorisation, les mêmes limites d'offre et la même validation que n'importe quelle autre requête. L'agent agit **comme vous**, uniquement dans l'organisation et avec les autorisations que vous avez approuvées, et jamais avec les droits du personnel de Zippendo.

<CardGroup cols={3}>
  <Card title="Connecter votre agent" icon="plug" href="/docs/fr/mcp/connect">
    Configuration pas à pas pour Claude, Cursor, VS Code, ChatGPT et d'autres.
  </Card>

  <Card title="Authentification" icon="shield-check" href="/docs/fr/mcp/authentication">
    Comment fonctionne la connexion, comment choisir une organisation et limiter les autorisations.
  </Card>

  <Card title="Outils et périmètres" icon="wrench" href="/docs/fr/mcp/tools">
    Quels outils chaque autorisation débloque, avec des exemples de requêtes.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.