Pour développeurs et agents

Serveur MCP de NoloForWeb : documentation technique

Le serveur MCP relie un assistant IA aux données d'un loueur qui utilise NoloForWeb : parc, contrats, réservations, échéances, déclarations obligatoires et brokers. Il répond sur https://nolomcp.rilogi.it/mcp ; l'entreprise se choisit avec le code entreprise à la connexion et chaque utilisateur ne voit que ce qu'il voit dans le logiciel.

Demander une démo

Streamable HTTP OAuth 2.1 avec PKCE 52 outils, 4 en écriture avec confirmation

Connexion

Point d'accès, protocole et authentification

Élément	Valeur
Point d'accès	`https://nolomcp.rilogi.it/mcp`
Transport	Streamable HTTP avec session (`Mcp-Session-Id`). L'ancien transport SSE n'est pas actif.
Versions du protocole	`2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`
Entreprise	Choisie avec le code entreprise lors de la connexion OAuth, puis inscrite dans le jeton : chaque appel ne lit que la base de cette entreprise.
Autorisation	OAuth 2.1, code d'autorisation avec PKCE `S256` obligatoire. Scope unique : `mcp`.
Métadonnées	`/.well-known/oauth-protected-resource` (RFC 9728) et `/.well-known/oauth-authorization-server` (RFC 8414), aussi avec le suffixe `/mcp`. Un appel sans jeton reçoit 401 avec `WWW-Authenticate` et `resource_metadata`.
Enregistrement du client	Dynamique (RFC 7591) sur `POST /oauth/register` : clients publics, sans secret ; adresses de retour https ou localhost.
Points d'accès OAuth	`/oauth/authorize` (connexion avec code entreprise, utilisateur et mot de passe du logiciel) et `/oauth/token` (`grant_type=authorization_code`).
Durée du jeton	8 heures, sans jeton de rafraîchissement : à l'échéance, on se reconnecte.
Agents automatiques	Jetons de service dans l'en-tête `Authorization: Bearer`, liés à un utilisateur et avec une date d'expiration ; lecture seule.
État du service	`GET /health`

Le jeton est celui de l'API du logiciel : chaque appel passe par les mêmes droits que l'utilisateur connecté.

Outils

Les 52 outils, par domaine

Chaque outil appartient à un agent thématique ; agenti_manifesto renvoie la liste à jour avec les descriptions, rédigées en italien. Le serveur n'expose que des outils : ni prompts ni ressources MCP.

Domaine	Outils	Accès
Agences	`stazioni_list`, `stazioni_gruppi_list`	Lecture
Parc	`parco_stato_flotta`, `parco_veicoli_list`, `parco_veicoli_per_categoria`, `parco_veicolo_dossier`, `modelli_list`	Lecture
Échéances des véhicules	`parco_scadenze_list`, `parco_scadenze_in_scadenza`, `parco_scadenze_aggregato`	Lecture
Contrats	`contratti_list`, `contratti_noleggi_attivi`, `contratti_dettaglio`, `contratti_fatturato_aggregato`	Lecture
Réservations	`prenotazioni_search`, `prenotazioni_dettaglio`, `prenotazioni_cancella`	Lecture ; `prenotazioni_cancella` écrit, avec confirmation
Réservation en ligne	`booking_engine_disponibilita`, `booking_engine_crea_prenotazione`	Lecture ; `booking_engine_crea_prenotazione` écrit, avec confirmation
Calendrier	`calendario_veicoli`, `calendario_crea_bozza`, `calendario_riassegna_veicolo`	Lecture ; `calendario_crea_bozza` et `calendario_riassegna_veicolo` écrivent, avec confirmation
Tarifs concurrents	`concorrenza_tariffe_list`	Lecture
Conducteurs	`conducenti_search`, `conducenti_dossier`	Lecture
Amendes	`multe_list`, `multe_dettaglio`, `multe_aggregato`	Lecture
Sinistres	`rds_list`, `rds_dettaglio`, `rds_aggregato`	Lecture
Mouvements	`movimenti_list`, `movimenti_aggregato`, `movimenti_transiti_tra_stazioni`	Lecture
Tableau de bord	`cruscotto_operatore_kpi`, `cruscotto_operatore_drilldown`, `cruscotto_operatore_filtri`, `lavoro_del_giorno`	Lecture
Obligations	`adempimenti_da_fare`, `adempimenti_contratto`, `cargos_comunicazioni_list`, `hospedajes_comunicazioni_list`, `noleggi_lunghi_list`	Lecture
Brokers	`broker_list`, `broker_dettaglio`, `broker_estratto_conto`, `broker_aging`, `broker_netto_canale`, `broker_riconciliazioni_list`, `broker_riconciliazione_dettaglio`	Lecture
Avis NPS	`nps_report`	Lecture
Liste des agents	`agenti_manifesto`	Lecture

Les outils respectent les droits de l'utilisateur : un non-administrateur ne voit que ses agences ; relevés, ancienneté des créances, net par canal et rapprochements des brokers exigent le droit Finance broker.

Écritures

Quatre outils écrivent, toujours en deux temps

Aperçu

Appelé sans confirmation, valeur par défaut, l'outil montre ce qui changerait et n'écrit rien.

Confirmation

L'assistant vous montre l'aperçu, attend votre accord et rappelle l'outil avec la confirmation active (confermato ou applica = true).

Exécution

La modification passe par l'API officielle du logiciel, avec les droits de votre utilisateur. Les jetons de service des agents automatiques ne peuvent pas écrire.

Clients

Connecter un assistant

Claude (claude.ai et application de bureau)

Paramètres › Connecteurs › Ajouter un connecteur personnalisé, adresse https://nolomcp.rilogi.it/mcp. À la connexion, saisissez le code entreprise, l'utilisateur et le mot de passe du logiciel.

Claude Code

claude mcp add --transport http noloforweb https://nolomcp.rilogi.it/mcp, puis la connexion depuis la commande /mcp. Pour un agent automatique, un jeton de service dans l'en-tête Authorization.

Autres clients MCP

Tout client qui prend en charge les serveurs MCP distants en Streamable HTTP avec OAuth 2.1 et enregistrement dynamique. Nous l'avons testé jusqu'ici avec Claude et Claude Code.

Questions fréquentes

Où répond le serveur MCP de NoloForWeb ?

Sur https://nolomcp.rilogi.it/mcp, la même adresse pour tous les clients. L'entreprise se choisit avec le code entreprise à la connexion et est inscrite dans le jeton : ensuite, chaque appel ne lit que la base de cette entreprise.

Faut-il enregistrer le client à l'avance ?

Non : le serveur prend en charge l'enregistrement dynamique des clients (RFC 7591). Les clients sont publics, sans secret, avec PKCE S256 obligatoire.

L'assistant peut-il modifier les données ?

Seulement avec quatre outils (annuler une réservation, en créer une via le moteur de réservation, créer un brouillon ou réaffecter un véhicule dans le calendrier), et toujours en deux temps : aperçu, puis confirmation. Contrats et factures ne sont jamais touchés.

Existe-t-il un environnement de test ?

Pas encore public. Écrivez-nous depuis la page Contact : en démo, nous connectons votre assistant à une entreprise avec des données d'exemple.

Envie de l'essayer sur vos données ?

En démo, nous connectons votre assistant et lui posons les questions que vous vous posez chaque jour au comptoir.

Demander une démo