Serveur MCP · OAuth 2.1

Votre TMS, dans l'assistant IA que vous utilisez déjà

Transportial parle le Model Context Protocol. Connectez une fois Claude, ChatGPT, Cursor ou VS Code, connectez-vous, et posez vos questions en langage courant sur les trajets, ordres, véhicules et factures. L'assistant agit en votre nom : il voit ce que vous pouvez voir et ne modifie que ce que vous autorisez.

Connecter votre assistant Guide pas à pas

ClaudeChatGPTClaude CodeCursorVS CodeOAuth 2.1

Assistant IA · Transportial connecté

Quels trajets sont en retard aujourd'hui, et où sont ces camions maintenant ?

search_trips trajets en cours, triés par retard

get_vehicle_locations dernière position des 3 véhicules

Trois trajets sont en retard sur le planning :

T-1042 Rotterdam → Lyon, 45 min de retard. Camion près de Reims, prochain arrêt : déchargement à Lyon.
T-1057 Venlo → Duisbourg, 20 min de retard. En attente au quai de chargement à Venlo.
T-1063 Anvers → Gand, 15 min de retard. Sur la E17, arrivée à 14 h 25.

MCP est le standard ouvert qui permet aux assistants IA d'utiliser d'autres logiciels. Avec le serveur MCP Transportial, votre assistant peut consulter trajets, ordres, véhicules, chauffeurs, clients, devis et factures et, si vous l'y autorisez, les créer et les modifier. Pas d'export ni de copier-coller entre fenêtres : vous demandez, l'assistant fait le travail dans Transportial et vous dit ce qu'il a fait.

Connectez-vous en deux minutes

Ajoutez l'URL du serveur à votre assistant. À la première connexion, une fenêtre Transportial s'ouvre pour que vous vous connectiez et approuviez la connexion.

Claude

claude.ai et l'app de bureau Claude

Ouvrez Paramètres › Connecteurs.
Choisissez Ajouter un connecteur personnalisé.
Nommez-le Transportial et collez l'URL du serveur.
Cliquez sur Connecter, connectez-vous à Transportial et approuvez.

ChatGPT

chatgpt.com, avec le mode développeur

Ouvrez Paramètres › Applications et connecteurs et activez le mode développeur dans les paramètres avancés.
Créez un connecteur avec l'URL du serveur et OAuth comme méthode d'authentification.
Connectez-vous à Transportial et approuvez.
Sélectionnez le connecteur dans un nouveau chat.

Claude Code

Dans votre terminal

Exécutez la commande ci-dessous.
Lancez Claude Code et tapez /mcp.
Choisissez transportial, puis Authenticate, et connectez-vous dans le navigateur.

Terminal

claude mcp add --transport http transportial https://api.app.transportial.com/mcp

Cursor

Global ou par projet

Ajoutez le serveur à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet.
Ouvrez les paramètres MCP dans Cursor et connectez-vous à transportial quand il le demande.
Connectez-vous à Transportial et approuvez.

Ajouter à Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "transportial": {
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

VS Code

Mode agent de GitHub Copilot

Ajoutez le serveur à .vscode/mcp.json, ou exécutez MCP: Add Server depuis la palette de commandes.
Démarrez le serveur et autorisez la connexion quand VS Code le demande.
Connectez-vous à Transportial et approuvez.

Ajouter à VS Code

.vscode/mcp.json

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

Tout autre client MCP

Serveurs distants en HTTP avec OAuth

Pointez le client vers l'URL du serveur.
Le client trouve lui-même la connexion via la découverte OAuth standard et s'enregistre tout seul.
Connectez-vous à Transportial et approuvez.

Les noms de menus peuvent légèrement varier selon les versions et les formules de chaque assistant. Sur les formules équipe et entreprise, un propriétaire doit parfois d'abord ajouter le connecteur pour l'organisation.

Ce qui se passe quand vous vous connectez

Vous gardez la main à chaque étape. Rien n'est partagé tant que vous ne l'avez pas approuvé dans Transportial même.

Vous ajoutez le serveur
Collez l'URL du serveur dans votre assistant. Il reconnaît Transportial et vous demande de vous connecter.
Vous vous connectez à Transportial
Une fenêtre de navigateur s'ouvre sur Transportial. Connectez-vous comme d'habitude, authentification à deux facteurs ou authentification unique comprise.
Vous choisissez la plateforme et l'accès
Choisissez la plateforme dans laquelle l'assistant peut travailler, et s'il peut seulement consulter les données ou aussi les créer, modifier et supprimer. Cliquez ensuite sur Autoriser.
Vous posez votre question
De retour dans l'assistant, posez votre question. Il appelle Transportial en votre nom et indique les outils qu'il a utilisés.

Ce que votre assistant peut faire

37 outils dédiés couvrent les questions et tâches les plus courantes. Trois outils généraux donnent accès au reste de l'API Transportial, plus de 800 opérations, pour que l'assistant ne reste pas bloqué au bout d'une liste.

Ordres et envois

Trouvez, consultez, créez, modifiez et annulez des ordres de transport, et retrouvez leurs envois et trajets.

search_transport_ordersConsulter
get_transport_orderConsulter
list_transport_order_tripsConsulter
create_transport_orderModifier
update_transport_orderModifier
cancel_transport_orderModifier
search_consignmentsConsulter
get_consignmentConsulter

Trajets

Recherchez des trajets par texte, statut, véhicule, chauffeur ou date, consultez le trajet complet, confirmez-le ou annulez-le.

search_tripsConsulter
get_tripConsulter
confirm_tripModifier
cancel_tripModifier

Véhicules et chauffeurs

Trouvez véhicules et chauffeurs, consultez les trajets d'un véhicule et la dernière position connue de votre flotte.

search_vehiclesConsulter
get_vehicleConsulter
list_vehicle_tripsConsulter
get_vehicle_locationsConsulter
search_chauffeursConsulter
get_chauffeurConsulter

Clients et adresses

Trouvez clients, transporteurs et autres relations, ainsi que les adresses de votre carnet d'adresses. Créez-en de nouveaux si nécessaire.

search_businessesConsulter
get_businessConsulter
create_businessModifier
search_locationsConsulter
get_locationConsulter
create_locationModifier

Devis et factures

Recherchez factures et devis par administration, créez un devis et envoyez-le au client.

search_administrationsConsulter
search_invoicesConsulter
get_invoiceConsulter
search_quotesConsulter
get_quoteConsulter
create_quoteModifier
send_quoteModifier

Appels d'offres

Consultez les appels d'offres et leur détail.

search_tendersConsulter
get_tenderConsulter

Alertes, événements et chat

Consultez les alertes de planification et d'exécution ouvertes et résolvez-les, recherchez des événements et envoyez un message dans un chat.

list_alertsConsulter
solve_alertModifier
search_eventsConsulter
send_chat_messageModifier

Tout le reste

Parcourez toute l'API, découvrez comment fonctionne une opération et appelez-la, en tant qu'utilisateur connecté sur sa plateforme.

search_operations
describe_operation
call_operation

Exemples de questions

Demandez comme vous le feriez à un collègue. L'assistant choisit les bons outils.

“Quels trajets sont en retard aujourd'hui, et qui les conduit ?”
“Où est le camion 12-BXL-4 en ce moment, et quel est son prochain arrêt ?”
“Crée un ordre de transport : 12 palettes de Rotterdam à Lyon, chargement mardi à 8 h 00.”
“Quelles factures de ce client sont encore ouvertes, et quel est le total ?”
“Fais un devis pour un camion complet de Venlo à Milan et envoie-le au client.”
“Résume les alertes ouvertes du jour et résous celles qui sont déjà traitées.”
“Envoie au chauffeur du trajet T-1042 un message indiquant que le quai de déchargement est désormais le 7.”
“Lesquels de nos véhicules n'ont aucun trajet planifié demain ?”

Sûr par conception

L'assistant obtient exactement l'accès que vous lui donnez, et vous pouvez le lui retirer à tout moment.

Il agit en votre nom
Chaque appel s'exécute en tant qu'utilisateur connecté, avec le rôle et les autorisations de cet utilisateur. Un assistant ne peut jamais faire plus que vous.
Lecture seule ou accès complet
N'accordez que Consulter les données et la connexion est en lecture seule à tous les niveaux : les outils qui modifient des données disparaissent et Transportial refuse les modifications.
Une plateforme par connexion
La connexion n'atteint que la plateforme choisie lors de l'approbation, même si vous travaillez dans plusieurs.
Déconnexion à tout moment
Paramètres › Sécurité › Applications connectées liste chaque assistant avec sa plateforme, son accès et sa dernière utilisation. Déconnecter met fin à son accès immédiatement.
OAuth 2.1 standard
Connexion avec PKCE, jetons d'accès valables une heure et jetons de rafraîchissement qui changent à chaque utilisation. Réutiliser un ancien jeton de rafraîchissement met fin à toute la connexion.
Activé par plateforme
Les apps connectées s'activent par plateforme. Si la vôtre n'est pas encore activée, l'écran d'approbation l'indique. Demandez à votre administrateur ou contactez-nous pour l'activer.

Détails techniques

Pour les développeurs qui connectent un client ou construisent leur propre agent. Le serveur suit la spécification MCP et les standards OAuth sur lesquels elle repose.

Developer Hub

Endpoint: POST https://api.app.transportial.com/mcp
Transport: Streamable HTTP avec réponses JSON. Sans état, sans flux server-sent events.
Versions du protocole: 2025-11-25, 2025-06-18 et 2025-03-26.
Découverte: /.well-known/oauth-protected-resource (RFC 9728) et /.well-known/oauth-authorization-server (RFC 8414).
Enregistrement du client: Enregistrement dynamique du client (RFC 7591) sur /oauth/register. URI de redirection HTTPS, loopback et schéma d'app.
Autorisation: Code d'autorisation avec PKCE (S256 uniquement). Les jetons sont liés au serveur MCP comme audience.
Scopes: read et write. Un jeton sans write ne peut appeler que les opérations get, search et exists.
Durées de vie: Jeton d'accès 1 heure, jeton de rafraîchissement 30 jours, renouvelé à chaque utilisation.
Agents sans utilisateur: Créez une intégration d'accès API et utilisez sa clé et son secret avec le grant client_credentials. Le jeton porte les autorisations de l'intégration.
Limites: Un appel d'outil expire après 120 secondes. Les résultats très longs sont tronqués avec une invitation à demander moins de résultats.

Questions fréquentes

Qu'est-ce que MCP ?

Le Model Context Protocol est un standard ouvert qui permet aux assistants IA de se connecter à d'autres logiciels via des outils. Claude, ChatGPT, Cursor, VS Code et de nombreux autres assistants le prennent en charge.

Quels assistants IA puis-je connecter ?

Tout assistant qui prend en charge les serveurs MCP distants en HTTP avec connexion OAuth, comme Claude, ChatGPT en mode développeur, Claude Code, Cursor et VS Code avec GitHub Copilot.

L'assistant voit-il toutes nos données ?

Il voit ce que voit l'utilisateur connecté, sur la seule plateforme choisie lors de l'approbation, et rien de plus. Les autorisations du rôle s'appliquent à chaque appel.

L'assistant peut-il modifier ou supprimer des données ?

Uniquement si vous accordez Créer, modifier et supprimer des données. Avec Consulter les données seul, toute modification est refusée.

Comment déconnecter un assistant ?

Ouvrez Paramètres › Sécurité, trouvez-le sous Applications connectées et cliquez sur Déconnecter. Son accès prend fin immédiatement.

Pouvons-nous connecter notre propre agent IA ?

Oui. Un agent qui agit pour une personne se connecte via OAuth comme tout autre client. Un agent autonome utilise la clé et le secret d'une intégration d'accès API.

Pourquoi l'écran d'approbation indique-t-il que les apps connectées ne sont pas activées ?

Les apps connectées s'activent par plateforme. Demandez à votre administrateur ou contactez Transportial pour les activer sur votre plateforme.

Intégrez Transportial à votre assistant

Ajoutez l'URL du serveur, connectez-vous et posez votre première question.

Lire le guide pas à pas Nous contacter