MCP in Logistiek: Hoe AI-agents te koppelen aan vracht-API's

Wat het is	Een open standaard waarmee AI-agenten uw vrachtsystemen kunnen aanroepen
Protocol	JSON-RPC 2.0 via stdio of HTTP
Kernbouwstenen	Tools (acties), Bronnen (alleen-lezen gegevens), Prompts (sjablonen)
Vrachttoepassingen	Offerte, boeken, volgen, ophalen vrachtbrief/afleverbewijs, facturen controleren
Live in 2026	Warp, CargoAi CargoMART, FreightUtils, C.H. Robinson
Eén integratie	Werkt op Claude, ChatGPT, Copilot, Gemini, Cursor

Jarenlang betekende het verbinden van vrachtsoftware met elke nieuwe partner een nieuw, op maat gemaakt API-project, en ik heb teams de dezelfde infrastructuur voor elke tool opnieuw zien bouwen. In 2026 is er een tweede integratie-oppervlak verschenen: het Model Context Protocol (MCP), een open standaard waarmee een AI-agent binnen Claude, ChatGPT, Microsoft Copilot of Gemini uw vrachtsystemen rechtstreeks kan aanroepen. In plaats van een persoon die via een portaal klikt, vraagt de agent in duidelijke taal om een offerte, boekt een zending of haalt een afleverbewijs op. Deze gids legt uit wat MCP is, hoe het in kaart wordt gebracht op een vracht-API, en toont een minimale werkende server. Ik zal ook ingaan op wie het al in productie draait, en waar u volgens mij voorzichtig moet zijn.

Wat is MCP?

Het Model Context Protocol is een open specificatie, oorspronkelijk vrijgegeven door Anthropic en nu ontwikkeld met de bredere gemeenschap, voor het verbinden van AI-modellen met externe tools en gegevens. Het standaardiseert het "wire format" tussen een AI-client en uw software, zodat u de verbinding één keer bouwt in plaats van deze voor elke assistent opnieuw te implementeren.

Technisch gesproken communiceert MCP via JSON-RPC 2.0 over een lokale stdio transport of een externe HTTP transport. Een server declareert drie soorten functionaliteit wanneer een agent verbinding maakt:

• Tools — uitvoerbare acties die het model kan aanroepen, zoals het bevragen van een API of het uitvoeren van een berekening. Tools worden door het model bestuurd: de agent ontdekt ze en beslist wanneer hij ze moet aanroepen.
• Bronnen — alleen-lezen gegevens die de applicatie voor context blootstelt, zoals een tarieftabel, een lijst met vervoerders of een zendingdocument. Uw applicatie, niet het model, beslist wanneer deze worden bijgevoegd.
• Prompts — herbruikbare, door de gebruiker gecontroleerde sjablonen (bijvoorbeeld "plan een meerstops LTL-rit") die een client kan opsommen en invullen.

Elke functionaliteit heeft standaard list en call/get methoden, wat precies de reden is waarom één MCP-server werkt in elke MCP-compatibele client zonder aangepaste lijm per assistent.

Waarom MCP specifiek voor vracht belangrijk is

Logistiek is een coördinatieprobleem tussen vele systemen: een transportmanagementsysteem (TMS), vervoerder-API's, tariefcalculators, track-and-trace, douanegegevens, ERP. Historisch gezien betekende elke AI-functie een aparte integratie, en elke nieuwe assistent betekende het opnieuw doen. MCP heft dat op. U stelt uw vrachtfuncties één keer bloot als MCP-server, en elke agent kan daar via offreren en boeken, en vervolgens de voortgang van alles wat onderweg is volgen.

De praktische winst is dezelfde die afzenders al halen uit vrachtboeking software en moderne API's, namelijk minder handmatige portalstappen, maar dan uitgebreid naar natuurlijke taal workflows. In de praktijk koppelt een agent verschillende aanroepen aan elkaar. Het leest een tariefbron, roept een get_quote Tool aan, controleert vervolgens een tracking Tool en presenteert het resultaat, allemaal binnen één gesprek.

Een vracht-API koppelen aan MCP

De meest zuivere manier om een vracht-MCP-server te ontwerpen, is door elke functionaliteit onder te verdelen in de drie primitieven:

• Tools (acties): get_quote, book_load, track_shipment, get_documents (BOL/POD), audit_invoice.
• Resources (alleen-lezen context): de lijst met vervoerders, tariefkaarten per route, tabellen met toeslagen, statusgeschiedenis van een zending.
• Prompts (sjablonen): "vergelijk LTL vs FTL voor deze lading", "vind de goedkoopste conforme vervoerder voor gevaarlijke goederen".

Een nuttige vuistregel: alles wat de status verandert of geld kost is een Tool die bevestiging vereist; alles wat referentiedata is, is een Resource die de agent vrij kan lezen.

Een minimale vracht-MCP-server (uitgewerkt voorbeeld)

Hieronder staat een gestripte TypeScript-schets van een MCP-server die twee vracht-tools blootlegt. Het maakt gebruik van de officiële SDK en een JSON Schema voor de invoer van elke tool, en roept vervolgens uw bestaande vracht-API aan:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

const server = new McpServer({ name: "freight", version: "1.0.0" });

// Tool 1 — quote a shipment (read-only, safe to auto-run)
server.tool(
  "get_quote",
  { origin: z.string(), destination: z.string(), weightKg: z.number(), mode: z.enum(["ltl", "ftl", "van"]) },
  async ({ origin, destination, weightKg, mode }) => {
    const r = await fetch(`https://api.example-freight.com/v1/quotes`, {
      method: "POST",
      headers: { authorization: `Bearer ${process.env.FREIGHT_TOKEN}` },
      body: JSON.stringify({ origin, destination, weightKg, mode }),
    });
    const data = await r.json();
    return { content: [{ type: "text", text: JSON.stringify(data) }] };
  },
);

// Tool 2 — track a shipment (read-only)
server.tool(
  "track_shipment",
  { shipmentId: z.string() },
  async ({ shipmentId }) => {
    const r = await fetch(`https://api.example-freight.com/v1/shipments/${shipmentId}`, {
      headers: { authorization: `Bearer ${process.env.FREIGHT_TOKEN}` },
    });
    return { content: [{ type: "text", text: JSON.stringify(await r.json()) }] };
  },
);

server.start(); // stdio by default; HTTP transport for remote agents

Een agent die is verbonden met deze server kan nu reageren op "Hoeveel kost het om 800 kg LTL te vervoeren van Lissabon naar Madrid, en waar is zending ABC123?" door beide tools aan te roepen en het antwoord samen te stellen. Een book_load tool zou dezelfde structuur volgen - maar, zoals hieronder besproken, achter expliciete menselijke bevestiging geplaatst worden omdat het geld kost.

Wie draait er al vracht-MCP in 2026?

Dit is niet langer theoretisch. Concrete productie-implementaties verschenen in de eerste helft van 2026:

• Warp publiceerde warp-agent-mcp op npm op 16 april 2026, beschreven als de eerste productie-MCP-server voor vracht. De 23 tools bieden offertes en boeken LTL/FTL-zendingen, halen BOL/POD-documenten op, auditen facturen en rapporteren tracking, allemaal op hun live netwerk in plaats van een sandbox.
• CargoAi verbond zijn CargoMART luchtvrachtboekingsplatform op 5 juni 2026 met Copilot, ChatGPT, Claude en Gemini via MCP, waardoor expediteurs luchtvracht kunnen offreren en boeken in eenvoudige taal.
• FreightUtils biedt een open MCP-server met 19 gratis tools, die ADR-opzoekingen gevaarlijke goederen, HS-code zoekopdrachten, calculators voor vrachtgewicht en CBM/LDM, palletpasvorm en containercapaciteit omvatten, allemaal zonder API-sleutel vereist.
• C.H. Robinson rapporteerde dat zijn generatieve AI-agenten meer dan 3 miljoen verzendingstaken hadden uitgevoerd, en Nuvocargo lanceerde een dozijn agenten die meer dan 70% van de laadcontactpunten afhandelen. Dat is het soort grootschalige automatisering waarvoor MCP is ontworpen om te standaardiseren.

Hoe veilig te beginnen

Het blootstellen van boekings- en betalingsacties aan een autonoom agent verhoogt de inzet, dus bouw vanaf dag één beveiligingen in:

1. Authenticeer en scope. Geef de MCP-server zijn eigen inloggegevens (OAuth of gescoopte tokens), en verleen aan elke tool alleen de benodigde machtigingen, zodat een tracking-tool nooit boekingsrechten heeft.
2. Houd een mens in de lus voor statuswijzigingen. Offreren en volgen kunnen automatisch lopen, maar alles wat een boeking verandert of geld verplaatst, moet expliciete bevestiging vereisen voordat de Tool wordt uitgevoerd.
3. Maak acties idempotente. Gebruik door de client aangeleverde sleutels, zodat een opnieuw geprobeerde book_load geen dubbele zendingen kan maken.
4. Respecteer snelheidslimieten en log alles. Agents kunnen snel veel aanroepen doen; beperk ze en houd een auditspoor bij van elke tool-aanroep voor geschillenbeslechting en naleving.

Risico's en beperkingen

MCP is krachtig, maar geen magie. Agents kunnen nog steeds argumenten hallucineren, dus valideer elke tool-invoer tegen een strikt schema en verwerp het onwaarschijnlijke. Te brede tool-permissies zijn het grootste beveiligingsrisico, omdat een gecompromitteerde of door een prompt-geïnjecteerde agent nooit geld zou mogen overmaken of de prijslijst van een klant zou mogen lekken. Behandel een MCP-server als elk ander openbaar API-oppervlak: minimale privileges, invoervalidatie, monitoring en bevestigingspoorten voor alles wat onomkeerbaar is. Voor vracht in het bijzonder, houd gereguleerde stromen (gevaarlijke goederen, douane) achter menselijke beoordeling totdat u het gedrag van de agent vertrouwt.

Wat betekent dit voor een vrachtmarktplaats

Bij GetTransport beheren we een marktplaats waar verzenders vervoerders vergelijken en ritten boeken, en de MCP-lens maakt onze roadmap concreet. Dezelfde bewerkingen die een persoon in onze interface uitvoert, komen rechtstreeks overeen met MCP-tools: offertes aanvragen bij meerdere vervoerders, prijzen vergelijken met timing, boeken en vervolgens volgen. Referentiegegevens zoals de dekking van vervoerders en de prijzen per route passen in plaats daarvan in het Resource-model. Wat ik hier het nuttigst vind aan een marktplaats, is de breedte. Eén enkele get_quote tool kan naar vele vervoerders tegelijk uitwaaieren, wat precies de vergelijking is die een agent goed kan orkestreren en een persoon als vervelend ervaart. De conclusie voor verzenders is dat de boekingsworkflow die ze al kennen, iets wordt dat een assistent van begin tot eind kan aansturen, zolang het platform dit via een schone, goed beheerde API aanbiedt. Die laatste voorwaarde is waar het meeste echte werk zit, en dat is het deel waar ik niet mee zou haasten.

Veelgestelde Vragen

Wat is MCP in de logistiek?

MCP, het Model Context Protocol, is een open standaard waarmee AI-agents logistieke systemen kunnen aanroepen voor het offreren en boeken van vracht, en voor het volgen ervan, via één integratie die werkt met assistenten zoals Claude, ChatGPT, Copilot en Gemini.

Hoe boekt een AI-agent vracht met MCP?

De agent maakt verbinding met een MCP-server die vrachtacties als tools blootstelt; het roept een quote-tool aan, vervolgens een boekings-tool, waarbij gestructureerde invoer wordt doorgegeven die de server doorstuurt naar de onderliggende vracht-API.

Is MCP veilig voor vrachtboekingen?

Dat kan het zijn, als u de permissies van elke tool beperkt, de server autenticeert, een menselijke bevestigingsstap behoudt voor geldtransacties, elke invoer valideert en alle aanroepen logt voor audit.

Heb ik een aparte integratie nodig voor elke AI-assistent?

Nee, dat is het punt van MCP. U bouwt één server en deze werkt met elke MCP-compatibele client, waaronder Claude, ChatGPT, Microsoft Copilot, Gemini en Cursor.

Welke MCP-servers voor vracht bestaan er al in 2026?

Productievoorbeelden zijn Warp's warp-agent-mcp met 23 tools, CargoAi's CargoMART voor luchtvracht, en de open FreightUtils server met 19 gratis logistieke tools.