InloggenGratis starten
Home›Developer Hub›MCP-server
MCP-server · OAuth 2.1

Je TMS, binnen de AI-assistent die je al gebruikt

Transportial spreekt het Model Context Protocol. Koppel Claude, ChatGPT, Cursor of VS Code één keer, log in en stel in gewone taal vragen over ritten, orders, voertuigen en facturen. De assistent werkt als jij: hij ziet wat jij ziet en wijzigt alleen wat jij toestaat.

Koppel je assistentStapsgewijze handleiding
ClaudeChatGPTClaude CodeCursorVS CodeOAuth 2.1
AI-assistent · Transportial gekoppeld

Welke ritten lopen vandaag achter, en waar zijn die vrachtwagens nu?

search_trips lopende ritten, gesorteerd op vertraging

get_vehicle_locations laatste positie van de 3 voertuigen

Drie ritten lopen achter op schema:

  • T-1042 Rotterdam → Lyon, 45 min te laat. Vrachtwagen bij Reims, volgende stop is lossen in Lyon.
  • T-1057 Venlo → Duisburg, 20 min te laat. Wacht bij de laadkade in Venlo.
  • T-1063 Antwerpen → Gent, 15 min te laat. Op de E17, aankomst 14:25.
MCP-server-URLhttps://api.app.transportial.com/mcp

MCP is de open standaard waarmee AI-assistenten andere software kunnen gebruiken. Met de Transportial MCP-server kan je assistent ritten, orders, voertuigen, chauffeurs, klanten, offertes en facturen opzoeken en, als je dat toestaat, aanmaken en wijzigen. Geen exports en geen kopiëren en plakken tussen vensters: jij vraagt, de assistent doet het werk in Transportial en vertelt wat hij heeft gedaan.

Gekoppeld in twee minuten

Voeg de server-URL toe aan je assistent. De eerste keer dat hij verbinding maakt, opent een Transportial-venster waar je inlogt en de koppeling goedkeurt.

Claude

claude.ai en de Claude desktop-app

  1. Open Settings › Connectors.
  2. Kies Add custom connector.
  3. Geef hem de naam Transportial en plak de server-URL.
  4. Klik op Connect, log in bij Transportial en keur goed.

ChatGPT

chatgpt.com, met developer mode

  1. Open Settings › Apps & Connectors en zet developer mode aan onder de geavanceerde instellingen.
  2. Maak een connector met de server-URL en OAuth als authenticatie.
  3. Log in bij Transportial en keur goed.
  4. Selecteer de connector in een nieuwe chat.

Claude Code

In je terminal

  1. Voer het onderstaande commando uit.
  2. Start Claude Code en typ /mcp.
  3. Kies transportial, daarna Authenticate, en log in via de browser.
Terminal
claude mcp add --transport http transportial https://api.app.transportial.com/mcp

Cursor

Globaal of per project

  1. Voeg de server toe aan ~/.cursor/mcp.json, of aan .cursor/mcp.json in een project.
  2. Open de MCP-instellingen in Cursor en log in bij transportial wanneer erom wordt gevraagd.
  3. Log in bij Transportial en keur goed.
Toevoegen aan Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "transportial": {
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

VS Code

GitHub Copilot agent mode

  1. Voeg de server toe aan .vscode/mcp.json, of voer MCP: Add Server uit via het Command Palette.
  2. Start de server en sta het inloggen toe wanneer VS Code erom vraagt.
  3. Log in bij Transportial en keur goed.
Toevoegen aan VS Code
.vscode/mcp.json
{
  "servers": {
    "transportial": {
      "type": "http",
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

Elke andere MCP-client

Externe servers via HTTP met OAuth

  1. Richt de client op de server-URL.
  2. De client vindt het inloggen zelf via de standaard OAuth-discovery en registreert zichzelf.
  3. Log in bij Transportial en keur goed.

Menunamen kunnen per versie en abonnement van elke assistent iets verschillen. Bij team- en enterprise-abonnementen moet mogelijk eerst een eigenaar de connector voor de organisatie toevoegen.

Wat er gebeurt als je koppelt

Je houdt bij elke stap de controle. Er wordt niets gedeeld totdat je het in Transportial zelf goedkeurt.

  1. Je voegt de server toe

    Plak de server-URL in je assistent. Die herkent Transportial en vraagt je in te loggen.

  2. Je logt in bij Transportial

    Er opent een browservenster op Transportial. Log in zoals je altijd doet, inclusief tweestapsverificatie of single sign-on.

  3. Je kiest platform en toegang

    Kies het platform waarin de assistent mag werken, en of hij gegevens alleen mag bekijken of ook mag aanmaken, wijzigen en verwijderen. Klik daarna op Toestaan.

  4. Je stelt je vraag

    Stel terug in de assistent je vraag. Hij roept Transportial aan als jij en laat zien welke tools hij heeft gebruikt.

Claude koppelen

Claude wil namens jou (you@yourcompany.com) in Transportial werken. De app kan alleen wat jij kunt, beperkt tot de toegang die je hieronder kiest.

Na je keuze ga je terug naar claude.ai.

De naam van de app komt van de app zelf. Koppel alleen een app die je zelf aan het koppelen bent en vertrouwt.

Platform
Jouw bedrijf
Jouw bedrijf UK (niet ingeschakeld)
Toegang
Gegevens bekijken
Gegevens aanmaken, wijzigen en verwijderen
WeigerenToestaan
Het goedkeuringsscherm in Transportial. Platforms waarvoor gekoppelde apps niet zijn ingeschakeld, kunnen niet worden gekozen.

Wat je assistent kan doen

37 speciale tools dekken de vragen en taken die mensen het vaakst hebben. Drie algemene tools bereiken de rest van de Transportial API, meer dan 800 operaties, zodat de assistent niet vastloopt aan de rand van een lijst.

Orders en zendingen

Zoek, lees, maak, wijzig en annuleer transportorders, en zoek de bijbehorende zendingen en ritten op.

  • search_transport_ordersBekijken
  • get_transport_orderBekijken
  • list_transport_order_tripsBekijken
  • create_transport_orderWijzigen
  • update_transport_orderWijzigen
  • cancel_transport_orderWijzigen
  • search_consignmentsBekijken
  • get_consignmentBekijken

Ritten

Zoek ritten op tekst, status, voertuig, chauffeur of datum, lees de volledige rit, bevestig of annuleer hem.

  • search_tripsBekijken
  • get_tripBekijken
  • confirm_tripWijzigen
  • cancel_tripWijzigen

Voertuigen en chauffeurs

Zoek voertuigen en chauffeurs, bekijk de ritten van een voertuig en de laatst bekende positie van je vloot.

  • search_vehiclesBekijken
  • get_vehicleBekijken
  • list_vehicle_tripsBekijken
  • get_vehicle_locationsBekijken
  • search_chauffeursBekijken
  • get_chauffeurBekijken

Klanten en adressen

Zoek klanten, vervoerders en andere zakelijke relaties, en adressen in je adresboek. Maak nieuwe aan wanneer dat nodig is.

  • search_businessesBekijken
  • get_businessBekijken
  • create_businessWijzigen
  • search_locationsBekijken
  • get_locationBekijken
  • create_locationWijzigen

Offertes en facturen

Zoek facturen en offertes per administratie, maak een offerte en stuur die naar de klant.

  • search_administrationsBekijken
  • search_invoicesBekijken
  • get_invoiceBekijken
  • search_quotesBekijken
  • get_quoteBekijken
  • create_quoteWijzigen
  • send_quoteWijzigen

Tenders

Zoek tenders en hun details op.

  • search_tendersBekijken
  • get_tenderBekijken

Meldingen, events en chat

Lees openstaande planning- en uitvoeringsmeldingen en los ze op, zoek events en stuur een bericht in een chat.

  • list_alertsBekijken
  • solve_alertWijzigen
  • search_eventsBekijken
  • send_chat_messageWijzigen

Al het andere

Doorzoek de volledige API, lees hoe een operatie werkt en roep hem aan, als de ingelogde gebruiker op zijn platform.

  • search_operations
  • describe_operation
  • call_operation

Dit kun je vragen

Vraag het zoals je het aan een collega zou vragen. De assistent kiest de juiste tools.

  • “Welke ritten lopen vandaag achter, en wie rijdt ze?”
  • “Waar is vrachtwagen 12-BXL-4 nu, en wat is de volgende stop?”
  • “Maak een transportorder: 12 pallets van Rotterdam naar Lyon, laden dinsdag om 08:00.”
  • “Welke facturen van deze klant staan nog open, en wat is het totaal?”
  • “Maak een offerte voor een volle vrachtwagen van Venlo naar Milaan en stuur die naar de klant.”
  • “Vat de openstaande meldingen van vandaag samen en los de meldingen op die al zijn afgehandeld.”
  • “Stuur de chauffeur van rit T-1042 een bericht dat de loskade is gewijzigd naar 7.”
  • “Welke van onze voertuigen hebben morgen geen ritten gepland?”

Veilig door ontwerp

De assistent krijgt precies de toegang die jij geeft, en je kunt die op elk moment intrekken.

  • Hij werkt als jij

    Elke aanroep wordt uitgevoerd als de ingelogde gebruiker, met de rol en rechten van die gebruiker. Een assistent kan nooit meer dan jij zelf.

  • Alleen bekijken of volledige toegang

    Geef alleen Gegevens bekijken en de koppeling is op elk niveau alleen-lezen: tools die gegevens wijzigen verdwijnen en Transportial weigert wijzigingen.

  • Eén platform per koppeling

    De koppeling bereikt alleen het platform dat je bij het goedkeuren hebt gekozen, ook als je in meerdere platforms werkt.

  • Ontkoppel op elk moment

    Instellingen › Beveiliging › Gekoppelde apps toont elke assistent met zijn platform, zijn toegang en wanneer hij voor het laatst is gebruikt. Ontkoppelen beëindigt de toegang direct.

  • Standaard OAuth 2.1

    Inloggen met PKCE, toegangstokens die een uur geldig zijn en refresh-tokens die bij elk gebruik wisselen. Het hergebruiken van een oud refresh-token beëindigt de hele koppeling.

  • Per platform ingeschakeld

    Gekoppelde apps worden per platform ingeschakeld. Is dat bij jou nog niet gedaan, dan staat dat op het goedkeuringsscherm. Vraag je beheerder of neem contact met ons op om het in te schakelen.

Technische details

Voor ontwikkelaars die een client koppelen of hun eigen agent bouwen. De server volgt de MCP-specificatie en de OAuth-standaarden waarop die is gebouwd.

Developer Hub
Endpoint
POST https://api.app.transportial.com/mcp
Transport
Streamable HTTP met JSON-antwoorden. Stateless, geen server-sent event stream.
Protocolversies
2025-11-25, 2025-06-18 en 2025-03-26.
Discovery
/.well-known/oauth-protected-resource (RFC 9728) en /.well-known/oauth-authorization-server (RFC 8414).
Clientregistratie
Dynamic client registration (RFC 7591) op /oauth/register. HTTPS-, loopback- en app-scheme-redirect-URI’s.
Autorisatie
Authorization code met PKCE (alleen S256). Tokens zijn gebonden aan de MCP-server als hun audience.
Scopes
read en write. Een token zonder write kan alleen get-, search- en exists-operaties aanroepen.
Geldigheid
Toegangstoken 1 uur, refresh-token 30 dagen, bij elk gebruik vernieuwd.
Agents zonder gebruiker
Maak een API-toegangsintegratie en gebruik de key en secret ervan met de client_credentials-grant. Het token draagt de rechten van de integratie.
Limieten
Een tool-aanroep krijgt na 120 seconden een time-out. Zeer lange resultaten worden afgekapt met een hint om om minder resultaten te vragen.

Veelgestelde vragen

Wat is MCP?

Het Model Context Protocol is een open standaard waarmee AI-assistenten via tools verbinding maken met andere software. Claude, ChatGPT, Cursor, VS Code en veel andere assistenten ondersteunen het.

Welke AI-assistenten kan ik koppelen?

Elke assistent die externe MCP-servers via HTTP met OAuth-aanmelding ondersteunt, zoals Claude, ChatGPT in developer mode, Claude Code, Cursor en VS Code met GitHub Copilot.

Ziet de assistent al onze gegevens?

Hij ziet wat de ingelogde gebruiker ziet op het ene platform dat bij het goedkeuren is gekozen, en niets meer. Rolrechten gelden voor elke aanroep.

Kan de assistent gegevens wijzigen of verwijderen?

Alleen als je Gegevens aanmaken, wijzigen en verwijderen toestaat. Met alleen Gegevens bekijken wordt elke wijziging geweigerd.

Hoe ontkoppel ik een assistent?

Open Instellingen › Beveiliging, zoek hem onder Gekoppelde apps en klik op Ontkoppelen. Zijn toegang eindigt direct.

Kunnen we onze eigen AI-agent koppelen?

Ja. Een agent die namens een persoon handelt, logt in met OAuth zoals elke andere client. Een agent die zelfstandig draait, gebruikt de key en secret van een API-toegangsintegratie.

Waarom staat er op het goedkeuringsscherm dat gekoppelde apps niet zijn ingeschakeld?

Gekoppelde apps worden per platform ingeschakeld. Vraag je beheerder of neem contact op met Transportial om ze voor jouw platform in te schakelen.

Haal Transportial in je assistent

Voeg de server-URL toe, log in en stel je eerste vraag.

Lees de stapsgewijze handleidingNeem contact op