MCP-Server · OAuth 2.1

Ihr TMS, direkt im KI-Assistenten, den Sie bereits nutzen

Transportial spricht das Model Context Protocol. Verbinden Sie Claude, ChatGPT, Cursor oder VS Code einmalig, melden Sie sich an und fragen Sie in einfacher Sprache nach Fahrten, Aufträgen, Fahrzeugen und Rechnungen. Der Assistent arbeitet als Sie: Er sieht, was Sie sehen können, und ändert nur, was Sie erlauben.

Assistenten verbinden Schritt-für-Schritt-Anleitung

ClaudeChatGPTClaude CodeCursorVS CodeOAuth 2.1

KI-Assistent · Transportial verbunden

Welche Fahrten sind heute verspätet, und wo sind diese Lkw gerade?

search_trips laufende Fahrten, nach Verspätung sortiert

get_vehicle_locations letzte Position der 3 Fahrzeuge

Drei Fahrten liegen hinter dem Zeitplan:

T-1042 Rotterdam → Lyon, 45 Min. verspätet. Lkw bei Reims, nächster Stopp ist die Entladung in Lyon.
T-1057 Venlo → Duisburg, 20 Min. verspätet. Wartet an der Laderampe in Venlo.
T-1063 Antwerpen → Gent, 15 Min. verspätet. Auf der E17, Ankunft 14:25.

MCP ist der offene Standard, mit dem KI-Assistenten andere Software nutzen können. Mit dem Transportial MCP-Server kann Ihr Assistent Fahrten, Aufträge, Fahrzeuge, Fahrer, Kunden, Angebote und Rechnungen nachschlagen und, wenn Sie es erlauben, anlegen und ändern. Keine Exporte und kein Kopieren zwischen Fenstern: Sie fragen, der Assistent erledigt die Arbeit in Transportial und sagt Ihnen, was er getan hat.

In zwei Minuten verbunden

Fügen Sie die Server-URL zu Ihrem Assistenten hinzu. Beim ersten Verbinden öffnet sich ein Transportial-Fenster, in dem Sie sich anmelden und die Verbindung bestätigen.

Claude

claude.ai und die Claude-Desktop-App

Öffnen Sie Settings › Connectors.
Wählen Sie Add custom connector.
Nennen Sie ihn Transportial und fügen Sie die Server-URL ein.
Klicken Sie auf Connect, melden Sie sich bei Transportial an und bestätigen Sie.

ChatGPT

chatgpt.com, mit Entwicklermodus

Öffnen Sie Settings › Apps & Connectors und aktivieren Sie unter den erweiterten Einstellungen den Entwicklermodus.
Erstellen Sie einen Connector mit der Server-URL und OAuth als Authentifizierung.
Melden Sie sich bei Transportial an und bestätigen Sie.
Wählen Sie den Connector in einem neuen Chat aus.

Claude Code

In Ihrem Terminal

Führen Sie den folgenden Befehl aus.
Starten Sie Claude Code und geben Sie /mcp ein.
Wählen Sie transportial, dann Authenticate, und melden Sie sich im Browser an.

Terminal

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

Cursor

Global oder pro Projekt

Fügen Sie den Server in ~/.cursor/mcp.json hinzu, oder in .cursor/mcp.json in einem Projekt.
Öffnen Sie die MCP-Einstellungen in Cursor und melden Sie sich bei transportial an, wenn danach gefragt wird.
Melden Sie sich bei Transportial an und bestätigen Sie.

Zu Cursor hinzufügen

~/.cursor/mcp.json

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

VS Code

GitHub Copilot im Agent-Modus

Fügen Sie den Server in .vscode/mcp.json hinzu, oder führen Sie MCP: Add Server über die Command Palette aus.
Starten Sie den Server und erlauben Sie die Anmeldung, wenn VS Code danach fragt.
Melden Sie sich bei Transportial an und bestätigen Sie.

Zu VS Code hinzufügen

.vscode/mcp.json

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

Jeder andere MCP-Client

Remote-Server über HTTP mit OAuth

Richten Sie den Client auf die Server-URL.
Der Client findet die Anmeldung über die standardmäßige OAuth-Discovery selbst und registriert sich eigenständig.
Melden Sie sich bei Transportial an und bestätigen Sie.

Die Menünamen können je nach Version und Tarif des jeweiligen Assistenten leicht abweichen. Bei Team- und Enterprise-Tarifen muss unter Umständen zuerst ein Inhaber den Connector für die Organisation hinzufügen.

Was beim Verbinden passiert

Sie behalten bei jedem Schritt die Kontrolle. Nichts wird freigegeben, bevor Sie es in Transportial selbst bestätigen.

Sie fügen den Server hinzu
Fügen Sie die Server-URL in Ihren Assistenten ein. Er erkennt Transportial und bittet Sie, sich anzumelden.
Sie melden sich bei Transportial an
Im Browser öffnet sich ein Fenster von Transportial. Melden Sie sich wie gewohnt an, auch mit Zwei-Faktor-Authentifizierung oder Single Sign-on.
Sie wählen Plattform und Zugriff
Wählen Sie die Plattform, in der der Assistent arbeiten darf, und ob er Daten nur ansehen oder auch anlegen, ändern und löschen darf. Klicken Sie dann auf Zulassen.
Sie fragen
Stellen Sie zurück im Assistenten Ihre Frage. Er ruft Transportial als Sie auf und zeigt, welche Tools er verwendet hat.

Was Ihr Assistent kann

37 spezielle Tools decken die Fragen und Aufgaben ab, die am häufigsten vorkommen. Drei allgemeine Tools erreichen den Rest der Transportial-API mit mehr als 800 Operationen, sodass der Assistent nicht am Rand einer Liste hängen bleibt.

Aufträge und Sendungen

Transportaufträge finden, lesen, anlegen, aktualisieren und stornieren sowie ihre Sendungen und Fahrten nachschlagen.

search_transport_ordersAnsehen
get_transport_orderAnsehen
list_transport_order_tripsAnsehen
create_transport_orderÄndern
update_transport_orderÄndern
cancel_transport_orderÄndern
search_consignmentsAnsehen
get_consignmentAnsehen

Fahrten

Fahrten nach Text, Status, Fahrzeug, Fahrer oder Datum suchen, die vollständige Fahrt lesen, bestätigen oder stornieren.

search_tripsAnsehen
get_tripAnsehen
confirm_tripÄndern
cancel_tripÄndern

Fahrzeuge und Fahrer

Fahrzeuge und Fahrer finden, die Fahrten eines Fahrzeugs und die zuletzt bekannte Position Ihres Fuhrparks sehen.

search_vehiclesAnsehen
get_vehicleAnsehen
list_vehicle_tripsAnsehen
get_vehicle_locationsAnsehen
search_chauffeursAnsehen
get_chauffeurAnsehen

Kunden und Adressen

Kunden, Frachtführer und andere Geschäftsbeziehungen sowie Adressen in Ihrem Adressbuch finden. Bei Bedarf neue anlegen.

search_businessesAnsehen
get_businessAnsehen
create_businessÄndern
search_locationsAnsehen
get_locationAnsehen
create_locationÄndern

Angebote und Rechnungen

Rechnungen und Angebote je Verwaltung suchen, ein Angebot erstellen und an den Kunden senden.

search_administrationsAnsehen
search_invoicesAnsehen
get_invoiceAnsehen
search_quotesAnsehen
get_quoteAnsehen
create_quoteÄndern
send_quoteÄndern

Ausschreibungen

Ausschreibungen und ihre Details nachschlagen.

search_tendersAnsehen
get_tenderAnsehen

Warnungen, Ereignisse und Chat

Offene Planungs- und Ausführungswarnungen lesen und lösen, Ereignisse suchen und eine Nachricht in einem Chat senden.

list_alertsAnsehen
solve_alertÄndern
search_eventsAnsehen
send_chat_messageÄndern

Alles andere

Die gesamte API durchsuchen, nachlesen, wie eine Operation funktioniert, und sie aufrufen, als angemeldeter Nutzer auf seiner Plattform.

search_operations
describe_operation
call_operation

Was Sie fragen können

Fragen Sie so, wie Sie einen Kollegen fragen würden. Der Assistent wählt die passenden Tools.

“Welche Fahrten sind heute verspätet, und wer fährt sie?”
“Wo ist Lkw 12-BXL-4 gerade, und was ist sein nächster Stopp?”
“Legen Sie einen Transportauftrag an: 12 Paletten von Rotterdam nach Lyon, Beladung Dienstag um 08:00.”
“Welche Rechnungen dieses Kunden sind noch offen, und wie hoch ist die Summe?”
“Erstellen Sie ein Angebot für eine Komplettladung von Venlo nach Mailand und senden Sie es an den Kunden.”
“Fassen Sie die heutigen offenen Warnungen zusammen und lösen Sie die, die bereits erledigt sind.”
“Schicken Sie dem Fahrer von Fahrt T-1042 eine Nachricht, dass die Entladerampe auf 7 gewechselt hat.”
“Welche unserer Fahrzeuge haben morgen keine Fahrten geplant?”

Sicher von Grund auf

Der Assistent erhält genau den Zugriff, den Sie ihm geben, und Sie können ihn jederzeit wieder entziehen.

Er arbeitet als Sie
Jeder Aufruf läuft als angemeldeter Nutzer, mit dessen Rolle und Berechtigungen. Ein Assistent kann nie mehr, als Sie selbst können.
Nur ansehen oder voller Zugriff
Erteilen Sie nur Daten ansehen, ist die Verbindung auf jeder Ebene schreibgeschützt: Tools, die Daten ändern, verschwinden, und Transportial lehnt Änderungen ab.
Eine Plattform pro Verbindung
Die Verbindung erreicht nur die Plattform, die Sie bei der Bestätigung gewählt haben, auch wenn Sie in mehreren arbeiten.
Jederzeit trennen
Unter Einstellungen › Sicherheit › Verbundene Apps ist jeder Assistent mit Plattform, Zugriff und letzter Nutzung aufgeführt. Mit Trennen endet sein Zugriff sofort.
Standard-OAuth 2.1
Anmeldung mit PKCE, Zugriffstoken, die eine Stunde gelten, und Refresh-Token, die sich bei jeder Nutzung ändern. Wird ein altes Refresh-Token erneut verwendet, endet die gesamte Verbindung.
Pro Plattform aktiviert
Verbundene Apps werden pro Plattform aktiviert. Ist das bei Ihrer noch nicht der Fall, weist der Bestätigungsbildschirm darauf hin. Wenden Sie sich an Ihren Administrator oder kontaktieren Sie uns, um sie zu aktivieren.

Technische Details

Für Entwickler, die einen Client anbinden oder einen eigenen Agenten bauen. Der Server folgt der MCP-Spezifikation und den OAuth-Standards, auf denen sie aufbaut.

Developer Hub

Endpunkt: POST https://api.app.transportial.com/mcp
Transport: Streamable HTTP mit JSON-Antworten. Zustandslos, kein Server-Sent-Event-Stream.
Protokollversionen: 2025-11-25, 2025-06-18 und 2025-03-26.
Discovery: /.well-known/oauth-protected-resource (RFC 9728) und /.well-known/oauth-authorization-server (RFC 8414).
Client-Registrierung: Dynamische Client-Registrierung (RFC 7591) unter /oauth/register. HTTPS-, Loopback- und App-Scheme-Redirect-URIs.
Autorisierung: Authorization Code mit PKCE (nur S256). Tokens sind an den MCP-Server als Audience gebunden.
Scopes: read und write. Ein Token ohne write kann nur get-, search- und exists-Operationen aufrufen.
Gültigkeitsdauer: Zugriffstoken 1 Stunde, Refresh-Token 30 Tage, bei jeder Nutzung rotiert.
Agenten ohne Nutzer: Erstellen Sie eine API-Zugriffs-Integration und verwenden Sie deren Key und Secret mit dem client_credentials-Grant. Das Token trägt die Berechtigungen der Integration.
Limits: Ein Tool-Aufruf läuft nach 120 Sekunden in ein Timeout. Sehr lange Ergebnisse werden abgeschnitten, mit dem Hinweis, nach weniger Ergebnissen zu fragen.

Häufig gestellte Fragen

Was ist MCP?

Das Model Context Protocol ist ein offener Standard, mit dem KI-Assistenten über Tools mit anderer Software verbunden werden. Claude, ChatGPT, Cursor, VS Code und viele weitere Assistenten unterstützen ihn.

Welche KI-Assistenten kann ich verbinden?

Jeden Assistenten, der Remote-MCP-Server über HTTP mit OAuth-Anmeldung unterstützt, etwa Claude, ChatGPT im Entwicklermodus, Claude Code, Cursor und VS Code mit GitHub Copilot.

Sieht der Assistent alle unsere Daten?

Er sieht, was der angemeldete Nutzer auf der bei der Bestätigung gewählten Plattform sieht, und nicht mehr. Die Rollenberechtigungen gelten für jeden Aufruf.

Kann der Assistent Daten ändern oder löschen?

Nur wenn Sie Daten anlegen, ändern und löschen erteilen. Mit Daten ansehen allein wird jede Änderung abgelehnt.

Wie trenne ich einen Assistenten?

Öffnen Sie Einstellungen › Sicherheit, suchen Sie ihn unter Verbundene Apps und klicken Sie auf Trennen. Sein Zugriff endet sofort.

Können wir unseren eigenen KI-Agenten verbinden?

Ja. Ein Agent, der für eine Person handelt, meldet sich wie jeder andere Client mit OAuth an. Ein Agent, der eigenständig läuft, verwendet Key und Secret einer API-Zugriffs-Integration.

Warum steht auf dem Bestätigungsbildschirm, dass verbundene Apps nicht aktiviert sind?

Verbundene Apps werden pro Plattform aktiviert. Bitten Sie Ihren Administrator oder Transportial, sie für Ihre Plattform zu aktivieren.

Holen Sie Transportial in Ihren Assistenten

Server-URL hinzufügen, anmelden und die erste Frage stellen.

Schritt-für-Schritt-Anleitung lesen Sprechen Sie uns an