CargoNet MCP-Administration
Mit deinem CargoNet-Benutzer (Admin-Recht) und Anmeldecode per E-Mail.
Mit CargoNet-Benutzer anmelden
Schickt mehrere Anfragen mit unterschiedlichem Authorization-Header und prüft, ob PHP bei jeder den richtigen sieht
(Befund 24.10.2026: Die frühere IIS-Regel PassAuthorizationHeader ließ den Header der ersten Anfrage im PHP-Prozess hängen,
sodass spätere Anfragen unter einer fremden Identität liefen). Es werden nur Kurzprüfsummen verglichen, nie Tokens.
Jede KI-Anbindung (z. B. Claude) braucht einen eigenen Token. Der Token wird an eine echte CargoNet-Person gebunden — davon hängen die Schreibrechte ab, mit denen die KI später handelt. Am besten ein eigener Dienstbenutzer mit nur den nötigen Rechten. Ein neuer Token wird nur einmal im Klartext angezeigt — danach sicher übergeben.
CargoNet-Benutzer melden sich am KI-Portal mit ihrem CargoNet-Benutzernamen und -Passwort an; die Prüfung läuft über diesen Server, das Passwort verlässt ihn nicht. Verwaltungsfunktionen sieht dort nur, wer in CargoNet Administrator ist.
Noch nicht am LOGIS-Update-Host registriert (Einstellungen → Automatisches Update → Speichern).
Verbindungen, die jemand selbst über "Custom Connector hinzufügen" in Claude.ai oder ChatGPT autorisiert hat.
Fachwissen, das nicht aus der Datenbank ersichtlich ist (z. B. Abrechnungslogik, Besonderheiten). Die KI liest dies automatisch vor fachlichen Fragen.
SMTP-Konfiguration für das Tool send_mail (z. B. für wiederkehrende Jobs, die Auswertungen per Mail verschicken). SMTP-Host leer lassen und speichern = Mailversand deaktiviert, das Tool verschwindet aus der Tool-Liste.
Verschickt eine Test-Mail über die aktuell gespeicherte Konfiguration — ungespeicherte Änderungen oben zuerst speichern.
Laufende Änderung der Grundeinstellungen aus der Ersteinrichtung. Der Speicherort der Konfigurationsdatei (.env.mcp) selbst lässt sich nur über setup.html ändern (dort werden die Dateien mit umgezogen).
Aktiviert das Tool web_search — für KI-Umgebungen ohne eigene Websuche (z. B. Azure OpenAI). Aktiviert zugleich fetch_url (öffentliche Seiten abrufen und Text auslesen, z. B. ein Impressum — mit SSRF-Schutz). Einrichtung: API-Key über die Google Cloud Console ("Custom Search API"), Suchmaschinen-ID über programmablesearchengine.google.com ("Das gesamte Web durchsuchen" aktivieren). 100 Anfragen/Tag kostenlos. Suchmaschinen-ID leeren und speichern = Websuche und Seitenabruf deaktiviert.
Der MCP-Server prüft beim Start neuer KI-Unterhaltungen (gedrosselt über das Intervall) den LOGIS-Update-Server und spielt neue Versionen selbstständig ein — signiert und verifiziert, Konfiguration und Tokens werden nie angefasst. Das Signatur-Secret wird bei jedem Speichern automatisch mit dem Update-Server getauscht (Rotation) — keine manuelle Eingabe nötig. URL leeren und speichern = Selbst-Update deaktiviert.
Das Portal läuft in diesem Paket neben dem MCP-Server: login/ (Mitarbeiter, TSplus), portal/ (Kunden und Subunternehmer),
fahrerportal/, scanapp/, status/ (Auftrags-Links). Es liest und schreibt ausschließlich über Werkzeuge dieses MCP-Servers.
Auswahllisten (Zahlungsbedingungen, Eintragsarten, Telematik) kommen aus der CargoNet-Datenbank dieses Servers, die Serial aus dem LOGIS-Lizenzsystem; leere Felder bedeuten die angezeigte Vorgabe.
Ohne eigenes Logo, Hintergrundbild und Favicon zeigt das Portal das CargoNet-Standard-Branding.
Leer lassen = Vorgabe (wird als Platzhalter angezeigt, Ordner entstehen beim ersten Gebrauch). Der Anwendungspool-Benutzer braucht Schreibrecht.
Stapel-Scans landen per Drag&Drop im Browser oder per FTP/Netzlaufwerk im Unterordner inbox der Seitenpool-Ablage. Ein Postfach-Abruf ist nur nötig, wenn der Kopierer Scans als Mail verschickt.
Scan-Seiten mit KI-Workflow laufen über das LOGIS-KI-System und brauchen die CargoNet-Serial der Lizenz; sie wird aus dem LOGIS-Lizenzsystem übernommen. Der Telematik-Zugang gilt für Portalseiten, die Touren nach dem Nachweis in der Telematik abschließen (bisher nur Spedion).
TSplus nur, wenn Mitarbeiter nach der Anmeldung den CargoNet-Client über TSplus starten sollen. Eine Adresse ist nicht nötig: TSplus läuft auf diesem Server und wird über /tsplus/ dieser Adresse erreicht; die Weiterleitungsregel dafür legt das Speichern in der web.config an. Programm, Startverzeichnis und Servercode sind mit den üblichen Werten vorbelegt.
Statt des Mail-Codes können Mitarbeiter den Code aus einer Authenticator-App verwenden (Microsoft Authenticator, Google Authenticator und andere). Sie richten die App nach einer Anmeldung mit Mail-Code selbst ein; für Benutzer ohne hinterlegte E-Mail-Adresse richtest du sie hier ein. Gilt nur, wenn die Anmeldung mit zweitem Faktor eingeschaltet ist. Die Schlüssel liegen verschlüsselt im Config-Ordner dieses Servers, nicht in der CargoNet-Datenbank.
Der Benutzer öffnet seine Authenticator-App, fügt ein Konto hinzu und scannt diesen Code. Danach den sechsstelligen Code, den seine App anzeigt, hier eintragen – erst damit gilt die App.
OTP-Geheimnisse signieren die Mail-Codes der Anmeldungen; einmal erzeugen, danach nicht mehr ändern (laufende Codes würden ungültig). Das Dienstkonto „Portal“ ruft Werkzeuge im Namen von Kunden, Subunternehmern und Fahrern auf. Dafür einen eigenen CargoNet-Benutzer auswählen, der genau die Rechte hat, die diese brauchen; den Zugangs-Token dazu erzeugt der Server beim Speichern selbst (er erscheint im Reiter Zugangs-Tokens als „Portal-Dienstkonto“).
Zeigt die letzten Zugriffe auf den MCP-Server: wer (Token-Name) welches Tool wann genutzt hat.