Per sviluppatori e agenti

Server MCP di NoloForWeb: documentazione tecnica

Il server MCP collega un assistente AI ai dati di un'azienda di noleggio che usa NoloForWeb: parco mezzi, contratti, prenotazioni, scadenze, adempimenti e broker. Risponde su https://nolomcp.rilogi.it/mcp; l'azienda si sceglie con il codice azienda al login e ogni utente vede solo quello che vede nel gestionale.

Richiedi una demo

Streamable HTTP OAuth 2.1 con PKCE 52 tool, 4 in scrittura con conferma

Connessione

Endpoint, protocollo e autenticazione

Voce	Valore
Endpoint	`https://nolomcp.rilogi.it/mcp`
Trasporto	Streamable HTTP con sessione (`Mcp-Session-Id`). Il vecchio trasporto SSE non è attivo.
Versioni del protocollo	`2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`
Azienda	Scelta con il codice azienda nel login OAuth, poi scritta nel token: ogni chiamata legge solo il database di quell'azienda.
Autorizzazione	OAuth 2.1, authorization code con PKCE `S256` obbligatorio. Unico scope: `mcp`.
Metadati	`/.well-known/oauth-protected-resource` (RFC 9728) e `/.well-known/oauth-authorization-server` (RFC 8414), anche con il suffisso `/mcp`. Una chiamata senza token risponde 401 con `WWW-Authenticate` e `resource_metadata`.
Registrazione del client	Dinamica (RFC 7591) su `POST /oauth/register`: client pubblici, senza secret; indirizzi di ritorno https o localhost.
Endpoint OAuth	`/oauth/authorize` (login con codice azienda, utente e password del gestionale) e `/oauth/token` (`grant_type=authorization_code`).
Durata del token	8 ore, senza refresh token: alla scadenza si rifà il login.
Agenti automatici	Token di servizio nell'header `Authorization: Bearer`, legati a un utente e con scadenza; possono solo leggere.
Stato del servizio	`GET /health`

Il token è quello dell'API del gestionale: ogni chiamata passa dagli stessi permessi dell'utente che ha fatto il login.

Tool

I 52 tool, per area

Ogni tool appartiene a un agente tematico; agenti_manifesto restituisce l'elenco aggiornato con le descrizioni, che sono in italiano. Il server espone solo tool: niente prompt né risorse MCP.

Area	Tool	Accesso
Stazioni	`stazioni_list`, `stazioni_gruppi_list`	Lettura
Parco mezzi	`parco_stato_flotta`, `parco_veicoli_list`, `parco_veicoli_per_categoria`, `parco_veicolo_dossier`, `modelli_list`	Lettura
Scadenze dei mezzi	`parco_scadenze_list`, `parco_scadenze_in_scadenza`, `parco_scadenze_aggregato`	Lettura
Contratti	`contratti_list`, `contratti_noleggi_attivi`, `contratti_dettaglio`, `contratti_fatturato_aggregato`	Lettura
Prenotazioni	`prenotazioni_search`, `prenotazioni_dettaglio`, `prenotazioni_cancella`	Lettura; `prenotazioni_cancella` scrive, con conferma
Prenotazione online	`booking_engine_disponibilita`, `booking_engine_crea_prenotazione`	Lettura; `booking_engine_crea_prenotazione` scrive, con conferma
Calendario	`calendario_veicoli`, `calendario_crea_bozza`, `calendario_riassegna_veicolo`	Lettura; `calendario_crea_bozza` e `calendario_riassegna_veicolo` scrivono, con conferma
Tariffe della concorrenza	`concorrenza_tariffe_list`	Lettura
Conducenti	`conducenti_search`, `conducenti_dossier`	Lettura
Multe	`multe_list`, `multe_dettaglio`, `multe_aggregato`	Lettura
Sinistri e RDS	`rds_list`, `rds_dettaglio`, `rds_aggregato`	Lettura
Movimenti	`movimenti_list`, `movimenti_aggregato`, `movimenti_transiti_tra_stazioni`	Lettura
Cruscotto	`cruscotto_operatore_kpi`, `cruscotto_operatore_drilldown`, `cruscotto_operatore_filtri`, `lavoro_del_giorno`	Lettura
Adempimenti	`adempimenti_da_fare`, `adempimenti_contratto`, `cargos_comunicazioni_list`, `hospedajes_comunicazioni_list`, `noleggi_lunghi_list`	Lettura
Broker	`broker_list`, `broker_dettaglio`, `broker_estratto_conto`, `broker_aging`, `broker_netto_canale`, `broker_riconciliazioni_list`, `broker_riconciliazione_dettaglio`	Lettura
Feedback NPS	`nps_report`	Lettura
Elenco degli agenti	`agenti_manifesto`	Lettura

I tool rispettano i permessi dell'utente: chi non è amministratore vede solo le proprie stazioni; estratto conto, aging, netto per canale e riconciliazioni dei broker richiedono il permesso Finanza broker.

Scritture

Quattro tool scrivono, sempre in due tempi

Anteprima

Chiamato senza conferma, che è il valore predefinito, il tool mostra cosa cambierebbe e non scrive niente.

Conferma

L'assistente ti mostra l'anteprima, aspetta il tuo sì e richiama il tool con la conferma attiva (confermato o applica = true).

Esecuzione

La modifica passa dall'API ufficiale del gestionale, con i permessi del tuo utente. I token di servizio degli agenti automatici non possono scrivere.

Client

Collegare un assistente

Claude (claude.ai e app desktop)

Impostazioni › Connettori › Aggiungi connettore personalizzato, indirizzo https://nolomcp.rilogi.it/mcp. Al login inserisci codice azienda, nome utente e password del gestionale.

Claude Code

claude mcp add --transport http noloforweb https://nolomcp.rilogi.it/mcp, poi il login dal comando /mcp. Per un agente automatico, un token di servizio nell'header Authorization.

Altri client MCP

Qualsiasi client che supporti server MCP remoti in Streamable HTTP con OAuth 2.1 e registrazione dinamica. Finora lo abbiamo provato con Claude e Claude Code.

Domande frequenti

Dove risponde il server MCP di NoloForWeb?

Su https://nolomcp.rilogi.it/mcp, lo stesso indirizzo per tutti i clienti. L'azienda si sceglie con il codice azienda al login e finisce nel token: da lì ogni chiamata legge solo il database di quell'azienda.

Serve registrare il client in anticipo?

No: il server supporta la registrazione dinamica dei client (RFC 7591). I client sono pubblici, senza secret, con PKCE S256 obbligatorio.

L'assistente può modificare i dati?

Solo con quattro tool (cancellare una prenotazione, crearne una dal booking engine, creare una bozza o riassegnare un mezzo nel calendario) e sempre in due tempi: anteprima, poi conferma. Contratti e fatture non si toccano.

C'è un ambiente di prova?

Non ancora pubblico. Scrivici dalla pagina Contatti: in demo colleghiamo il tuo assistente a un'azienda con dati di esempio.

Vuoi provarlo sui tuoi dati?

In demo colleghiamo il tuo assistente e gli facciamo le domande che fai ogni giorno al banco.

Richiedi una demo