01
Vorschau
Ohne Bestätigung aufgerufen, der Standardwert, zeigt das Tool, was sich ändern würde, und schreibt nichts.
Für Entwickler und Agenten
MCP-Server von NoloForWeb: technische Dokumentation
Der MCP-Server verbindet einen KI-Assistenten mit den Daten eines Vermieters, der NoloForWeb nutzt: Fuhrpark, Verträge, Buchungen, Fristen, Meldepflichten und Broker. Er antwortet unter https://nolomcp.noloforweb.eu/mcp; das Unternehmen wird beim Login über den Firmencode gewählt, und jeder Nutzer sieht nur, was er auch in der Software sieht.
Streamable HTTP OAuth 2.1 mit PKCE 52 Tools, 4 schreibend mit Bestätigung
Verbindung
Endpunkt, Protokoll und Authentifizierung
| Punkt | Wert |
|---|---|
| Endpunkt | https://nolomcp.noloforweb.eu/mcp |
| Transport | Streamable HTTP mit Sitzung (Mcp-Session-Id). Der alte SSE-Transport ist nicht aktiv. |
| Protokollversionen | 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 |
| Unternehmen | Wird beim OAuth-Login über den Firmencode gewählt und ins Token geschrieben: Jeder Aufruf liest nur die Datenbank dieses Unternehmens. |
| Autorisierung | OAuth 2.1, Authorization Code mit verpflichtendem PKCE S256. Einziger Scope: mcp. |
| Metadaten | /.well-known/oauth-protected-resource (RFC 9728) und /.well-known/oauth-authorization-server (RFC 8414), auch mit dem Suffix /mcp. Ein Aufruf ohne Token erhält 401 mit WWW-Authenticate und resource_metadata. |
| Client-Registrierung | Dynamisch (RFC 7591) über POST /oauth/register: öffentliche Clients ohne Secret; Redirect-URIs nur https oder localhost. |
| OAuth-Endpunkte | /oauth/authorize (Login mit Firmencode, Benutzername und Passwort der Software) und /oauth/token (grant_type=authorization_code). |
| Gültigkeit des Tokens | 8 Stunden, kein Refresh-Token: Nach Ablauf meldet man sich neu an. |
| Automatische Agenten | Service-Tokens im Header Authorization: Bearer, an einen Nutzer gebunden und mit Ablaufdatum; nur lesend. |
| Statusprüfung | GET /health |
Das Token ist das API-Token der Software: Jeder Aufruf läuft über dieselben Rechte wie der angemeldete Nutzer.
Tools
Die 52 Tools nach Bereich
Jedes Tool gehört zu einem thematischen Agenten; agenti_manifesto liefert die aktuelle Liste mit Beschreibungen, die auf Italienisch sind. Der Server stellt nur Tools bereit: keine MCP-Prompts oder -Ressourcen.
| Bereich | Tools | Zugriff |
|---|---|---|
| Stationen | stazioni_list, stazioni_gruppi_list | Lesen |
| Fuhrpark | parco_stato_flotta, parco_veicoli_list, parco_veicoli_per_categoria, parco_veicolo_dossier, modelli_list | Lesen |
| Fahrzeugfristen | parco_scadenze_list, parco_scadenze_in_scadenza, parco_scadenze_aggregato | Lesen |
| Verträge | contratti_list, contratti_noleggi_attivi, contratti_dettaglio, contratti_fatturato_aggregato | Lesen |
| Buchungen | prenotazioni_search, prenotazioni_dettaglio, prenotazioni_cancella | Lesen; prenotazioni_cancella schreibt, mit Bestätigung |
| Online-Buchung | booking_engine_disponibilita, booking_engine_crea_prenotazione | Lesen; booking_engine_crea_prenotazione schreibt, mit Bestätigung |
| Kalender | calendario_veicoli, calendario_crea_bozza, calendario_riassegna_veicolo | Lesen; calendario_crea_bozza und calendario_riassegna_veicolo schreiben, mit Bestätigung |
| Wettbewerbspreise | concorrenza_tariffe_list | Lesen |
| Fahrer | conducenti_search, conducenti_dossier | Lesen |
| Bußgelder | multe_list, multe_dettaglio, multe_aggregato | Lesen |
| Schäden | rds_list, rds_dettaglio, rds_aggregato | Lesen |
| Fahrzeugbewegungen | movimenti_list, movimenti_aggregato, movimenti_transiti_tra_stazioni | Lesen |
| Dashboard | cruscotto_operatore_kpi, cruscotto_operatore_drilldown, cruscotto_operatore_filtri, lavoro_del_giorno | Lesen |
| Meldepflichten | adempimenti_da_fare, adempimenti_contratto, cargos_comunicazioni_list, hospedajes_comunicazioni_list, noleggi_lunghi_list | Lesen |
| Broker | broker_list, broker_dettaglio, broker_estratto_conto, broker_aging, broker_netto_canale, broker_riconciliazioni_list, broker_riconciliazione_dettaglio | Lesen |
| NPS-Feedback | nps_report | Lesen |
| Agentenliste | agenti_manifesto | Lesen |
Die Tools folgen den Rechten des Nutzers: Wer kein Administrator ist, sieht nur die eigenen Stationen; Kontoauszug, Forderungsalter, Netto je Kanal und Abgleiche der Broker brauchen das Recht Broker-Finanzen.
Schreibzugriffe
Vier Tools schreiben, immer in zwei Schritten
02
Bestätigung
Der Assistent zeigt Ihnen die Vorschau, wartet auf Ihr Ja und ruft das Tool mit aktiver Bestätigung erneut auf (confermato oder applica = true).
03
Ausführung
Die Änderung läuft über die offizielle API der Software, mit den Rechten Ihres Nutzers. Service-Tokens automatischer Agenten können nicht schreiben.
Clients
Einen Assistenten verbinden
01
Claude (claude.ai und Desktop-App)
Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen, Adresse https://nolomcp.noloforweb.eu/mcp. Beim Login Firmencode, Benutzername und Passwort der Software eingeben.
02
Claude Code
claude mcp add --transport http noloforweb https://nolomcp.noloforweb.eu/mcp, dann Login über den Befehl /mcp. Für einen automatischen Agenten ein Service-Token im Header Authorization.
03
Andere MCP-Clients
Jeder Client, der entfernte MCP-Server über Streamable HTTP mit OAuth 2.1 und dynamischer Registrierung unterstützt. Getestet haben wir bisher Claude und Claude Code.
Häufige Fragen
Wo antwortet der MCP-Server von NoloForWeb?
Unter https://nolomcp.noloforweb.eu/mcp, derselben Adresse für alle Kunden. Das Unternehmen wird beim Login über den Firmencode gewählt und ins Token geschrieben: Danach liest jeder Aufruf nur die Datenbank dieses Unternehmens.
Muss der Client vorab registriert werden?
Nein: Der Server unterstützt die dynamische Client-Registrierung (RFC 7591). Clients sind öffentlich, ohne Secret, mit verpflichtendem PKCE S256.
Kann der Assistent Daten ändern?
Nur mit vier Tools (eine Buchung stornieren, eine über die Buchungsmaschine anlegen, einen Entwurf anlegen oder ein Fahrzeug im Kalender umbuchen), und immer in zwei Schritten: Vorschau, dann Bestätigung. Verträge und Rechnungen bleiben unberührt.
Gibt es eine Testumgebung?
Noch nicht öffentlich. Schreiben Sie uns über die Kontaktseite: In der Demo verbinden wir Ihren Assistenten mit einem Unternehmen mit Beispieldaten.
Mit Ihren Daten ausprobieren?
In der Demo verbinden wir Ihren Assistenten und stellen ihm die Fragen, die Sie täglich am Schalter haben.