[Home](/fr)›[Developer Hub](/fr/developers)›Serveur MCP 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](#connect)[Guide pas à pas](/fr/help/connected-apps) 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. URL du serveur MCP`https://api.app.transportial.com/mcp` 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 1. Ouvrez Paramètres › Connecteurs. 2. Choisissez Ajouter un connecteur personnalisé. 3. Nommez-le Transportial et collez l'URL du serveur. 4. Cliquez sur Connecter, connectez-vous à Transportial et approuvez. ### ChatGPT chatgpt.com, avec le mode développeur 1. Ouvrez Paramètres › Applications et connecteurs et activez le mode développeur dans les paramètres avancés. 2. Créez un connecteur avec l'URL du serveur et OAuth comme méthode d'authentification. 3. Connectez-vous à Transportial et approuvez. 4. Sélectionnez le connecteur dans un nouveau chat. ### Claude Code Dans votre terminal 1. Exécutez la commande ci-dessous. 2. Lancez Claude Code et tapez /mcp. 3. 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 1. Ajoutez le serveur à \~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet. 2. Ouvrez les paramètres MCP dans Cursor et connectez-vous à transportial quand il le demande. 3. Connectez-vous à Transportial et approuvez. [Ajouter à Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=transportial&config=eyJ1cmwiOiJodHRwczovL2FwaS5hcHAudHJhbnNwb3J0aWFsLmNvbS9tY3AifQ%3D%3D) \~/.cursor/mcp.json ``` { "mcpServers": { "transportial": { "url": "https://api.app.transportial.com/mcp" } } } ``` ### VS Code Mode agent de GitHub Copilot 1. Ajoutez le serveur à .vscode/mcp.json, ou exécutez MCP: Add Server depuis la palette de commandes. 2. Démarrez le serveur et autorisez la connexion quand VS Code le demande. 3. Connectez-vous à Transportial et approuvez. [Ajouter à VS Code](vscode:mcp/install?%7B%22name%22%3A%22transportial%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.app.transportial.com%2Fmcp%22%7D) .vscode/mcp.json ``` { "servers": { "transportial": { "type": "http", "url": "https://api.app.transportial.com/mcp" } } } ``` ### Tout autre client MCP Serveurs distants en HTTP avec OAuth 1. Pointez le client vers l'URL du serveur. 2. Le client trouve lui-même la connexion via la découverte OAuth standard et s'enregistre tout seul. 3. 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. 1. ### Vous ajoutez le serveur Collez l'URL du serveur dans votre assistant. Il reconnaît Transportial et vous demande de vous connecter. 2. ### 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. 3. ### 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. 4. ### 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. ### Connecter Claude Claude souhaite travailler dans Transportial en votre nom (you@yourcompany.com). Il ne peut faire que ce que vous pouvez faire, dans la limite de l'accès que vous choisissez ci-dessous. Une fois votre choix fait, vous revenez sur claude.ai. Le nom de l'app est fourni par l'app elle-même. Ne connectez qu'une app dont vous avez vous-même lancé la connexion et en laquelle vous avez confiance. Plateforme Votre entreprise Votre entreprise UK (non activée) Accès Consulter les données Créer, modifier et supprimer des données RefuserAutoriser L'écran d'approbation dans Transportial. Les plateformes où les apps connectées ne sont pas activées ne peuvent pas être choisies. ## 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_orders`Consulter * `get_transport_order`Consulter * `list_transport_order_trips`Consulter * `create_transport_order`Modifier * `update_transport_order`Modifier * `cancel_transport_order`Modifier * `search_consignments`Consulter * `get_consignment`Consulter ### Trajets Recherchez des trajets par texte, statut, véhicule, chauffeur ou date, consultez le trajet complet, confirmez-le ou annulez-le. * `search_trips`Consulter * `get_trip`Consulter * `confirm_trip`Modifier * `cancel_trip`Modifier ### 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_vehicles`Consulter * `get_vehicle`Consulter * `list_vehicle_trips`Consulter * `get_vehicle_locations`Consulter * `search_chauffeurs`Consulter * `get_chauffeur`Consulter ### 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_businesses`Consulter * `get_business`Consulter * `create_business`Modifier * `search_locations`Consulter * `get_location`Consulter * `create_location`Modifier ### Devis et factures Recherchez factures et devis par administration, créez un devis et envoyez-le au client. * `search_administrations`Consulter * `search_invoices`Consulter * `get_invoice`Consulter * `search_quotes`Consulter * `get_quote`Consulter * `create_quote`Modifier * `send_quote`Modifier ### Appels d'offres Consultez les appels d'offres et leur détail. * `search_tenders`Consulter * `get_tender`Consulter ### 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_alerts`Consulter * `solve_alert`Modifier * `search_events`Consulter * `send_chat_message`Modifier ### 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](/fr/developers) 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](/fr/help/connected-apps)[Nous contacter](/fr/contact) --- Canonical page: https://transportial.com/fr/mcp