Connecter Claude ou ChatGPT aux données de votre flotte avec MCP

Le Model Context Protocol (MCP) est un standard ouvert qui permet à un assistant IA comme Claude ou ChatGPT d’appeler des outils dans un autre système. Konvoi expose un serveur MCP à l’adresse https://konvoi.ai/api/mcp. Ajoutez cette URL comme connecteur personnalisé dans Claude, ChatGPT, Claude Code ou Cursor, connectez-vous avec votre propre identifiant Konvoi, et l’assistant répond à vos questions à partir de vos véhicules, chauffeurs, amendes, pleins et données télématiques. Il lit avec votre rôle, rien de plus, et ne peut rien modifier de lui-même : chaque changement qu’il suggère devient une proposition qu’une personne approuve dans Konvoi Dispatch. Les clients IA via MCP sont en bêta privée : Dispatch et les clients IA (MCP) doivent être activés pour votre espace de travail avant que vous puissiez vous connecter.

Ce qu’est MCP, en termes simples

Seul, un assistant IA ne connaît que ce que vous collez dans la conversation. MCP lui donne une manière standard de demander des données à un autre système. Ce système publie une liste d’outils, comme « lister les véhicules », « obtenir la consommation de carburant » ou « localiser un véhicule », chacun avec une description et les paramètres qu’il attend. Quand vous posez une question, l’assistant choisit les outils nécessaires, les appelle, lit les résultats et rédige sa réponse.

Pour un gestionnaire de flotte, cela signifie que vous n’exportez plus de tableur pour interroger une IA. Vous demandez « Quels camions n’ont pas roulé la semaine dernière ? » et l’assistant va chercher la réponse dans Konvoi, avec pour chaque véhicule un lien vers Konvoi.

Pour le service informatique : le serveur parle Streamable HTTP, sans état, en POST uniquement. L’authentification se fait par OAuth avec PKCE (S256), et les jetons sont liés à l’URL du serveur. Tout client MCP capable de se connecter à des serveurs distants en HTTP avec OAuth fonctionne. La référence complète du protocole et la liste à jour des outils se trouvent sur la page développeur MCP.

Ce que signifie donner à une IA l’accès aux données de flotte

Connecter un client, c’est décider de deux choses : ce que l’assistant peut voir, et où vont ces données.

Ce qu’il peut voir. La connexion agit en votre nom. Elle atteint chaque espace de travail que vous pouvez ouvrir et où Dispatch et les clients IA sont activés, avec votre rôle dans cet espace. Au moment d’autoriser la connexion, vous pouvez la limiter à certains espaces de travail. Si votre rôle ne voit pas quelque chose dans Konvoi, l’assistant ne le voit pas non plus : un outil dont le rôle minimum est supérieur au vôtre répond ROLE_REQUIRED.

Où vont les données. Les données sur lesquelles vous posez une question sont envoyées au client que vous utilisez. Interrogez Claude sur les amendes d’un chauffeur et ces amendes partent chez Anthropic dans le cadre de la conversation ; avec ChatGPT, chez OpenAI. L’écran de consentement de Konvoi le précise avant que vous cliquiez sur Allow. Vérifiez que la politique IA de votre entreprise autorise ce client avant de le connecter.

Le modèle de sécurité : lire avec votre rôle, proposer le reste

Le serveur MCP de Konvoi suit une seule règle : l’assistant lit, les personnes décident.

• Accès en lecture avec votre propre rôle. La lecture des données de flotte (Read fleet data) fait toujours partie d’une connexion, et chaque appel s’exécute avec votre rôle dans l’espace de travail.
• Les modifications sont des propositions. Proposer des modifications (Propose changes) est un accès distinct, que vous cochez ou non lors de la connexion. Même avec cet accès, un outil propose_* ne change rien lui-même. Il crée une proposition dans Konvoi Dispatch et en renvoie le lien.
• Qui approuve. Les propositions courantes, comme l’attribution d’une amende à un chauffeur, s’approuvent ou se rejettent dans le client quand il peut vous le demander, sinon dans Konvoi Dispatch. Les propositions marquées Admin approves, comme un message à un chauffeur, une demande de document, la fusion de véhicules ou la clôture d’un dossier carburant, exigent un administrateur de l’espace de travail dans Konvoi Dispatch.
• Traçabilité. Une modification approuvée s’exécute au nom de la personne qui l’approuve, avec son rôle. Chaque appel et chaque décision sont journalisés.
• Le texte externe est signalé. Le texte venu de l’extérieur de Konvoi, comme les documents scannés et les e-mails, est marqué comme non fiable. Les clients ont pour consigne de le traiter comme des données, jamais comme des instructions, pour qu’une lettre scannée ne puisse pas piloter l’assistant.
• Des jetons de courte durée. Les jetons d’accès valent 1 heure. Les jetons de rafraîchissement changent à chaque utilisation et expirent après 30 jours sans usage. Toutes vos connexions sont révoquées d’un coup si vous changez de mot de passe, vous déconnectez partout ou désactivez l’authentification à deux facteurs.

La manière dont Konvoi traite vos données en général est décrite sur la page sécurité.

Avant de commencer

• Un espace de travail où Dispatch et les clients IA (MCP) sont activés. C’est une bêta privée. Si le client renvoie DISPATCH_OFF, ce n’est pas encore activé pour cet espace : demandez à un administrateur de l’espace de travail ou contactez Konvoi pour rejoindre la bêta.
• Votre identifiant Konvoi, avec votre passkey ou votre seconde étape si vous en utilisez une.
• Un client MCP qui se connecte à des serveurs distants en HTTP avec OAuth. Claude, ChatGPT, Claude Code, Cursor et VS Code en sont tous capables. Les connecteurs personnalisés ne sont pas inclus dans toutes les formules de tous les clients : vérifiez la vôtre.

L’URL du serveur est la même pour tous les clients : https://konvoi.ai/api/mcp. Dans Konvoi, vous la trouvez aussi sous Dispatch → Connect.

Pas à pas : connecter votre client

Les libellés de l’application Konvoi sont repris tels qu’ils s’affichent, en anglais.

Claude

1. Ouvrez Paramètres → Connecteurs (Settings → Connectors).
2. Choisissez Ajouter un connecteur personnalisé (Add custom connector).
3. Collez l’URL du serveur.
4. Connectez-vous à Konvoi et autorisez l’accès.

ChatGPT

1. Ouvrez Paramètres → Connecteurs → Avancé (Settings → Connectors → Advanced).
2. Activez le mode développeur (Developer mode).
3. Créez un connecteur avec l’URL du serveur et l’authentification OAuth.
4. Connectez-vous à Konvoi et autorisez l’accès.

Claude Code

Lancez ceci dans un terminal :

claude mcp add --transport http konvoi https://konvoi.ai/api/mcp

Lancez ensuite /mcp dans Claude Code et connectez-vous à Konvoi.

Cursor et VS Code

Dans Cursor, ajoutez le serveur à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "konvoi": {
      "url": "https://konvoi.ai/api/mcp"
    }
  }
}

Dans VS Code, lancez MCP: Add Server → HTTP et collez l’URL du serveur. Connectez-vous à Konvoi quand on vous le demande.

L’écran de consentement de Konvoi

Chaque client aboutit sur la même page Konvoi, « Connect [client] to Konvoi ». Elle indique sous quel compte vous êtes connecté et vous demande deux choses :

• Workspaces (espaces de travail) : All workspaces with Dispatch (tous les espaces avec Dispatch), ou Only these workspaces (seulement ceux-ci).
• Access (accès) : Read fleet data, toujours actif, et Propose changes, facultatif.

Cliquez sur Allow et vous revenez dans votre client, connecté.

Pour les scripts et automatisations sans fenêtre de connexion, créez un jeton personnel via Profile → AI clients → Create personal token et envoyez-le comme jeton bearer. Les jetons personnels valent 30, 90 ou 365 jours, et ne s’affichent qu’une seule fois.

Exemples de questions

Inutile de connaître le nom des outils. Posez la question comme à un collègue, précisez l’espace de travail si vous en avez plusieurs, et demandez des liens pour pouvoir vérifier la source.

Flotte et véhicules

• « Quels camions n’ont pas roulé hier, et lesquels ont un traceur devenu muet ? »
• « Où se trouve 1-ABC-123 en ce moment, et où était-il ce matin ? »
• « Quel est le coût total de possession de nos cinq tracteurs les plus anciens cette année ? »

Carburant

• « Montre la consommation de carburant de septembre par chauffeur, du pire au meilleur. »
• « Quels dossiers carburant sont encore ouverts, et que dit chacun d’eux ? »

Amendes, documents et autorisations

• « Quelles amendes sont arrivées cette semaine, et qui avait chaque véhicule à ce moment-là ? Propose les attributions. »
• « Qu’est-ce qui expire dans les 30 prochains jours : assurances, contrôles techniques, autorisations ? »

Konvoi publie aussi des prompts prêts à l’emploi, les mêmes scénarios que dans Dispatch : traiter les amendes de la semaine, passer le carburant au crible, voir ce qui expire dans les 30 prochains jours, et une revue hebdomadaire de la flotte. Les clients qui prennent en charge les prompts MCP les affichent dans leur menu de prompts ou de commandes slash.

Limites

Le serveur applique des limites fixes, pour qu’une connexion très active ne ralentisse pas les autres :

• Par connexion : 120 appels par minute, 5 simultanés.
• Outils lourds (analyses et rapports exécutés côté Konvoi) : 10 appels par minute par connexion.
• Par personne : 300 appels par minute sur l’ensemble des connexions.
• Taille d’un résultat : 100 Ko. Les listes plus longues sont raccourcies, et le résultat indique ce qui a été coupé.

Au-delà d’une limite, l’outil répond RATE_LIMITED avec le nombre de secondes à attendre.

Les limites pratiques comptent davantage :

• L’assistant peut se tromper. Il peut mal lire un tableau ou tirer une conclusion que les données ne soutiennent pas. Avant d’agir sur un chiffre important, ouvrez le lien et vérifiez-le dans Konvoi.
• Il ne connaît que ce qui se trouve dans Konvoi. Si un export de cartes carburant n’a jamais été importé, aucun assistant ne trouvera ces pleins.
• C’est une bêta. Les outils et leur comportement peuvent encore évoluer. La liste des outils sur la page développeur est générée par le serveur lui-même : elle est donc toujours à jour.

Retirer une connexion

• Profile → AI clients liste vos connexions. Disconnect en met fin immédiatement.
• Un administrateur de l’espace de travail peut retirer une connexion de son espace dans Dispatch → Connect. La connexion de cette personne continue de fonctionner pour ses autres espaces de travail.

Si vous préférez ne pas connecter de client externe, les mêmes questions fonctionnent aussi dans Konvoi même, dans le chat de Konvoi Dispatch.