[Home](/de)›[Developer Hub](/de/developers)›MCP-Server

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](#connect)[Schritt-für-Schritt-Anleitung](/de/help/connected-apps)

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-Server-URL`https://api.app.transportial.com/mcp`

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

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

### ChatGPT

chatgpt.com, mit Entwicklermodus

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

### Claude Code

In Ihrem Terminal

1. Führen Sie den folgenden Befehl aus.
2. Starten Sie Claude Code und geben Sie /mcp ein.
3. 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

1. Fügen Sie den Server in \~/.cursor/mcp.json hinzu, oder in .cursor/mcp.json in einem Projekt.
2. Öffnen Sie die MCP-Einstellungen in Cursor und melden Sie sich bei transportial an, wenn danach gefragt wird.
3. Melden Sie sich bei Transportial an und bestätigen Sie.
[Zu Cursor hinzufügen](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

GitHub Copilot im Agent-Modus

1. Fügen Sie den Server in .vscode/mcp.json hinzu, oder führen Sie MCP: Add Server über die Command Palette aus.
2. Starten Sie den Server und erlauben Sie die Anmeldung, wenn VS Code danach fragt.
3. Melden Sie sich bei Transportial an und bestätigen Sie.
[Zu VS Code hinzufügen](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"
    }
  }
}
```

### Jeder andere MCP-Client

Remote-Server über HTTP mit OAuth

1. Richten Sie den Client auf die Server-URL.
2. Der Client findet die Anmeldung über die standardmäßige OAuth-Discovery selbst und registriert sich eigenständig.
3. 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.

1. ### Sie fügen den Server hinzu  
Fügen Sie die Server-URL in Ihren Assistenten ein. Er erkennt Transportial und bittet Sie, sich anzumelden.
2. ### 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.
3. ### 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.
4. ### Sie fragen  
Stellen Sie zurück im Assistenten Ihre Frage. Er ruft Transportial als Sie auf und zeigt, welche Tools er verwendet hat.

### Claude verbinden

Claude möchte in Ihrem Namen (you@yourcompany.com) in Transportial arbeiten. Die App kann nur, was Sie können, beschränkt auf den unten gewählten Zugriff.

Nach Ihrer Entscheidung kehren Sie zu claude.ai zurück.

Der Name der App stammt von der App selbst. Verbinden Sie nur eine App, deren Verbindung Sie selbst gestartet haben und der Sie vertrauen.

Plattform

Ihr Unternehmen

Ihr Unternehmen UK (nicht aktiviert)

Zugriff

Daten ansehen

Daten anlegen, ändern und löschen

AblehnenZulassen

Der Bestätigungsbildschirm in Transportial. Plattformen, auf denen verbundene Apps nicht aktiviert sind, können nicht ausgewählt werden.

## 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_orders`Ansehen
* `get_transport_order`Ansehen
* `list_transport_order_trips`Ansehen
* `create_transport_order`Ändern
* `update_transport_order`Ändern
* `cancel_transport_order`Ändern
* `search_consignments`Ansehen
* `get_consignment`Ansehen

### Fahrten

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

* `search_trips`Ansehen
* `get_trip`Ansehen
* `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_vehicles`Ansehen
* `get_vehicle`Ansehen
* `list_vehicle_trips`Ansehen
* `get_vehicle_locations`Ansehen
* `search_chauffeurs`Ansehen
* `get_chauffeur`Ansehen

### Kunden und Adressen

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

* `search_businesses`Ansehen
* `get_business`Ansehen
* `create_business`Ändern
* `search_locations`Ansehen
* `get_location`Ansehen
* `create_location`Ändern

### Angebote und Rechnungen

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

* `search_administrations`Ansehen
* `search_invoices`Ansehen
* `get_invoice`Ansehen
* `search_quotes`Ansehen
* `get_quote`Ansehen
* `create_quote`Ändern
* `send_quote`Ändern

### Ausschreibungen

Ausschreibungen und ihre Details nachschlagen.

* `search_tenders`Ansehen
* `get_tender`Ansehen

### Warnungen, Ereignisse und Chat

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

* `list_alerts`Ansehen
* `solve_alert`Ändern
* `search_events`Ansehen
* `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](/de/developers)

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](/de/help/connected-apps)[Sprechen Sie uns an](/de/contact)

---
Canonical page: https://transportial.com/de/mcp