Connecter votre agent

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.

URL du connecteur

https://api.zippendo.com/mcp

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.

La configurer depuis l’application Zippendo

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

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.

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.

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.

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.

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.

Ajouter le serveur

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

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.

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

.mcp.json

{
  "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

Ouvrir Connectors

Allez dans Settings → Connectors et cliquez sur Add custom connector.

Ajouter l'URL

Nommez-le Zippendo, saisissez https://api.zippendo.com/mcp et cliquez sur Add.

Se connecter

Cliquez sur Connect pour ouvrir la connexion dans le navigateur, puis approuvez l’organisation et les permissions.

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.

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.

Ouvrir les paramètres MCP

Ouvrez Cursor Settings → Tools & MCP → New MCP Server. Cela ouvre votre mcp.json.

Ajouter le serveur

mcp.json

{
  "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.

Se connecter

Une commande Login apparaît à côté du serveur. Cliquez dessus pour lancer la connexion dans le navigateur.

Installation en un clic : Add Zippendo to Cursor. Cursor vous demande d’approuver et écrit l’entrée pour vous.

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.

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.

S'authentifier

Une action Auth apparaît au-dessus de l’entrée du serveur dans mcp.json. Terminez la connexion dans le navigateur.

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

.vscode/mcp.json

{
  "servers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Windsurf

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zippendo": {
      "serverUrl": "https://api.zippendo.com/mcp"
    }
  }
}

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.

ChatGPT

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

Activer le Developer Mode

Activez Settings → Connectors → Advanced → Developer Mode.

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.

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

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.

~/.codex/config.toml

[mcp_servers.zippendo]
url = "https://api.zippendo.com/mcp"

CLI

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.

~/.gemini/settings.json

{
  "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 :

{
  "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

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.

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.

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.

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.

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.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Connecter votre agent

URL du connecteur

La configurer depuis l’application Zippendo

Claude Code

Claude Desktop

Claude sur le web

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Tout autre client MCP

Dépannage

URL du connecteur

​La configurer depuis l’application Zippendo

​Claude Code

​Claude Desktop

​Claude sur le web

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​ChatGPT

​OpenAI Codex CLI

​Gemini CLI

​Tout autre client MCP

​Dépannage

La configurer depuis l’application Zippendo

Claude Code

Claude Desktop

Claude sur le web

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Tout autre client MCP

Dépannage