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

# Connecter votre agent

> Configuration pas à pas pour connecter Claude, Cursor, VS Code, Windsurf, ChatGPT et d'autres agents d'IA au serveur MCP de Zippendo.

Connectez votre outil d'IA à Zippendo pour qu'il puisse travailler à votre place avec vos expéditions, vos commandes et vos transporteurs. Ajoutez l'URL ci-dessous à l'outil comme connecteur MCP personnalisé. L'outil ouvre la connexion Zippendo dans votre navigateur et maintient la connexion à jour tout seul : rien à installer et aucun jeton à coller.

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

<Info>
  Le serveur prend en charge l'enregistrement dynamique des clients : un client conforme n'a donc besoin **que de l'URL**, sans identifiant client, sans secret client et sans jeton à coller. À la première connexion, il trouve la page de connexion, s'enregistre et ouvre votre navigateur pour que vous vous connectiez et approuviez l'accès. Consultez [Authentification](/docs/fr/mcp/authentication).
</Info>

## La configurer depuis l'application Zippendo

L'application vous guide à travers les mêmes étapes pour votre outil :

<Steps>
  <Step title="Ouvrir la carte MCP">
    Allez dans **Apps & integrations** → **Catalog**, trouvez **MCP (AI agents)** et cliquez sur **Connect**. La fenêtre **Connect an AI agent** s'ouvre.
  </Step>

  <Step title="Choisir l'agent">
    Choisissez votre outil d'IA. N'importe quel client MCP fonctionne ; la liste affiche ceux qui ont des instructions dédiées.
  </Step>

  <Step title="Ajouter le connecteur">
    Suivez les étapes pour votre outil. Le **Connector URL** a un bouton **Copy**. Lorsque vous l'avez ajouté, cliquez sur **I've added it**.
  </Step>

  <Step title="Approuver l'accès">
    Terminez la connexion que votre outil a ouverte et approuvez l'organisation et les permissions. La fenêtre se met à jour toute seule dès que la connexion est établie. Cliquez sur **Done**.
  </Step>
</Steps>

Chaque agent connecté apparaît ensuite sur la carte **MCP (AI agents)** avec la date de sa dernière utilisation et le nombre de permissions qu'il possède. Cliquez sur **Disconnect** pour retirer son accès, ou sur **Connect another** pour en ajouter un autre. Les étapes pour chaque outil figurent aussi ci-dessous.

## Claude Code

Ajoutez le serveur avec la CLI, puis authentifiez-vous depuis une session.

<Steps>
  <Step title="Ajouter le serveur">
    ```bash theme={null}
    claude mcp add --transport http zippendo https://api.zippendo.com/mcp
    ```

    Utilisez `--scope user` pour le rendre disponible dans tous les projets, ou `--scope project` pour l'enregistrer dans le fichier `.mcp.json` du dépôt afin que votre équipe en dispose (par défaut, la portée est locale : vous seul, dans le projet en cours).
  </Step>

  <Step title="S'authentifier">
    Démarrez Claude Code, lancez `/mcp`, sélectionnez **zippendo** et choisissez **Authenticate**. Votre navigateur ouvre l'écran de consentement de Zippendo. Approuvez, et vous êtes connecté. Relancez `/mcp` à tout moment pour vérifier l'état ou vous authentifier à nouveau.
  </Step>
</Steps>

Pour partager le serveur avec votre équipe, enregistrez un fichier `.mcp.json` de projet :

```json .mcp.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

Gérez la connexion avec `claude mcp list`, `claude mcp get zippendo` et `claude mcp remove zippendo`.

## Claude Desktop

<Steps>
  <Step title="Ouvrir Connectors">
    Allez dans **Settings → Connectors** et cliquez sur **Add custom connector**.
  </Step>

  <Step title="Ajouter l'URL">
    Nommez-le `Zippendo`, saisissez `https://api.zippendo.com/mcp` et cliquez sur **Add**.
  </Step>

  <Step title="Se connecter">
    Cliquez sur **Connect** pour ouvrir la connexion dans le navigateur, puis approuvez l'organisation et les permissions.
  </Step>
</Steps>

<Note>
  Les connecteurs personnalisés sont disponibles avec Free, Pro, Max, Team et Enterprise. Les offres Free autorisent un seul connecteur personnalisé. Avec Team et Enterprise, un Owner ajoute le connecteur et chaque membre se connecte individuellement.
</Note>

## Claude sur le web

Même compte, mêmes étapes que Claude Desktop.

* **Individuel (Free, Pro, Max) :** **Settings → Connectors → Add custom connector**, saisissez un nom et `https://api.zippendo.com/mcp`, cliquez sur **Add**, puis sur **Connect**.
* **Team et Enterprise :** un **Owner** l'ajoute une fois sous **Organization settings → Connectors → Add → Custom**. Les membres ouvrent ensuite **Settings → Connectors**, trouvent le connecteur et cliquent sur **Connect**. Chaque membre se connecte avec ses propres accès.

## Cursor

Ajoutez-le dans les paramètres ou avec un fichier de configuration.

<Steps>
  <Step title="Ouvrir les paramètres MCP">
    Ouvrez **Cursor Settings → Tools & MCP → New MCP Server**. Cela ouvre votre `mcp.json`.
  </Step>

  <Step title="Ajouter le serveur">
    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "zippendo": {
          "url": "https://api.zippendo.com/mcp"
        }
      }
    }
    ```

    La configuration globale se trouve dans `~/.cursor/mcp.json`, celle de chaque projet dans `.cursor/mcp.json`.
  </Step>

  <Step title="Se connecter">
    Une commande **Login** apparaît à côté du serveur. Cliquez dessus pour lancer la connexion dans le navigateur.
  </Step>
</Steps>

<Tip>
  Installation en un clic : [**Add Zippendo to Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor vous demande d'approuver et écrit l'entrée pour vous.
</Tip>

## VS Code (GitHub Copilot)

Nécessite VS Code 1.102 ou une version ultérieure avec GitHub Copilot. Utilisez les outils depuis Copilot Chat en mode **Agent**.

<Steps>
  <Step title="Ajouter le serveur">
    Palette de commandes → **MCP: Add Server** → **HTTP**, collez `https://api.zippendo.com/mcp`, puis choisissez **Workspace** (écrit `.vscode/mcp.json`) ou **Global**.
  </Step>

  <Step title="S'authentifier">
    Une action **Auth** apparaît au-dessus de l'entrée du serveur dans `mcp.json`. Terminez la connexion dans le navigateur.
  </Step>
</Steps>

La configuration de VS Code utilise une clé `servers` de premier niveau (et non `mcpServers`) :

```json .vscode/mcp.json theme={null}
{
  "servers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

## Windsurf

Modifiez `~/.codeium/windsurf/mcp_config.json` (Cascade → MCP servers → edit raw config).

```json ~/.codeium/windsurf/mcp_config.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "serverUrl": "https://api.zippendo.com/mcp"
    }
  }
}
```

<Warning>
  Windsurf utilise `serverUrl` (et non `url`) pour les serveurs Streamable HTTP. OAuth est pris en charge, mais si la connexion dans le navigateur ne s'ouvre pas, mettez Windsurf à jour vers la dernière version.
</Warning>

## ChatGPT

Les connecteurs MCP personnalisés s'ajoutent via le **Developer Mode**, uniquement dans la version web (pas de fichier de configuration).

<Steps>
  <Step title="Activer le Developer Mode">
    Activez **Settings → Connectors → Advanced → Developer Mode**.
  </Step>

  <Step title="Ajouter le connecteur">
    De retour dans **Connectors**, ajoutez un connecteur personnalisé avec l'URL `https://api.zippendo.com/mcp`. ChatGPT vous demande de vous connecter la première fois.
  </Step>
</Steps>

<Warning>
  Le Developer Mode est en **bêta** sur Plus, Pro, Business, Enterprise et Edu. L'appel complet des outils (actions d'écriture, comme la création d'une expédition) est limité à **Business, Enterprise et Edu**. Plus et Pro sont en pratique en lecture seule. Les actions d'écriture demandent une confirmation à chaque fois. ChatGPT peut modifier les noms de ses menus et sa disponibilité.
</Warning>

## OpenAI Codex CLI

Utilisez une version récente de Codex CLI (les anciennes versions ne prenaient en charge que les serveurs locaux). Ajoutez le serveur dans le fichier de configuration ou avec la CLI.

```toml ~/.codex/config.toml theme={null}
[mcp_servers.zippendo]
url = "https://api.zippendo.com/mcp"
```

```bash CLI theme={null}
codex mcp add zippendo --url https://api.zippendo.com/mcp
codex mcp login zippendo   # opens the browser sign-in
```

Si votre version de Codex n'a ni `--url` ni `codex mcp login`, mettez à jour Codex CLI vers la dernière version.

## Gemini CLI

Modifiez `~/.gemini/settings.json`. Les serveurs Streamable HTTP utilisent le champ `httpUrl`.

```json ~/.gemini/settings.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "httpUrl": "https://api.zippendo.com/mcp"
    }
  }
}
```

Gemini CLI trouve tout seul la connexion OAuth. Dans une session, lancez `/mcp auth` (ou `/mcp` pour voir quels serveurs en ont besoin) pour ouvrir la connexion dans le navigateur.

## Tout autre client MCP

La plupart des clients acceptent la configuration distante standard, avec uniquement l'URL :

```json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

Si votre client suit la spécification d'autorisation MCP, il trouve la page de connexion et exécute OAuth pour vous. Approuvez ensuite l'organisation et les permissions sur la page de connexion Zippendo qu'il ouvre.

## Dépannage

<AccordionGroup>
  <Accordion title="La connexion dans le navigateur ne s'ouvre jamais">
    Vérifiez que votre client prend en charge **MCP distant via OAuth** et que vous utilisez sa dernière version. Certains clients n'ont ajouté les connecteurs distants que dans des versions récentes.
  </Accordion>

  <Accordion title="L'agent ne voit pas un outil dont il a besoin">
    Les outils sont filtrés selon les permissions que vous avez approuvées. Reconnectez-vous et accordez la permission manquante sur l'écran de consentement (par exemple `write:shipments` pour créer des expéditions). Consultez [Outils et scopes](/docs/fr/mcp/tools).
  </Accordion>

  <Accordion title="Il fonctionne dans la mauvaise organisation">
    Chaque connexion appartient à une seule organisation. Déconnectez-vous, reconnectez-vous et choisissez la bonne organisation sur l'écran de consentement. Consultez [Authentification](/docs/fr/mcp/authentication).
  </Accordion>

  <Accordion title="La connexion refuse votre compte">
    Si votre compte de membre de l'équipe est limité à une marque, vous ne pouvez pas connecter d'agent. Demandez à un propriétaire de l'organisation de vous donner accès à toute l'organisation, ou de connecter lui-même l'agent.
  </Accordion>

  <Accordion title="Une configuration avec uniquement une url est rejetée">
    Certains clients ont besoin que le type de transport soit indiqué explicitement. Ajoutez `"type": "http"` à côté de l'`url` (Claude Code, VS Code), ou utilisez l'option HTTP de ce client lorsque vous ajoutez le serveur.
  </Accordion>
</AccordionGroup>


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