01
Vista previa
Llamada sin confirmación, que es el valor por defecto, la herramienta muestra qué cambiaría y no escribe nada.
Para desarrolladores y agentes
Servidor MCP de NoloForWeb: documentación técnica
El servidor MCP conecta un asistente de IA con los datos de una empresa de alquiler que usa NoloForWeb: flota, contratos, reservas, vencimientos, comunicaciones obligatorias y brókers. Responde en https://nolomcp.rilogi.it/mcp; la empresa se elige con el código de empresa al iniciar sesión y cada usuario ve solo lo que ve en el programa.
Streamable HTTP OAuth 2.1 con PKCE 52 herramientas, 4 de escritura con confirmación
Conexión
Endpoint, protocolo y autenticación
| Concepto | Valor |
|---|---|
| Endpoint | https://nolomcp.rilogi.it/mcp |
| Transporte | Streamable HTTP con sesión (Mcp-Session-Id). El antiguo transporte SSE no está activo. |
| Versiones del protocolo | 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 |
| Empresa | Se elige con el código de empresa en el inicio de sesión OAuth y queda escrita en el token: cada llamada lee solo la base de datos de esa empresa. |
| Autorización | OAuth 2.1, authorization code con PKCE S256 obligatorio. Único scope: mcp. |
| Metadatos | /.well-known/oauth-protected-resource (RFC 9728) y /.well-known/oauth-authorization-server (RFC 8414), también con el sufijo /mcp. Una llamada sin token recibe 401 con WWW-Authenticate y resource_metadata. |
| Registro del cliente | Dinámico (RFC 7591) en POST /oauth/register: clientes públicos, sin secret; direcciones de retorno https o localhost. |
| Endpoints OAuth | /oauth/authorize (inicio de sesión con código de empresa, usuario y contraseña del programa) y /oauth/token (grant_type=authorization_code). |
| Duración del token | 8 horas, sin refresh token: al caducar se vuelve a iniciar sesión. |
| Agentes automáticos | Tokens de servicio en la cabecera Authorization: Bearer, ligados a un usuario y con caducidad; solo lectura. |
| Estado del servicio | GET /health |
El token es el de la API del programa: cada llamada pasa por los mismos permisos que el usuario que ha iniciado sesión.
Herramientas
Las 52 herramientas, por área
Cada herramienta pertenece a un agente temático; agenti_manifesto devuelve la lista actualizada con las descripciones, que están en italiano. El servidor solo expone herramientas: ni prompts ni recursos MCP.
| Área | Herramientas | Acceso |
|---|---|---|
| Oficinas | stazioni_list, stazioni_gruppi_list | Lectura |
| Flota | parco_stato_flotta, parco_veicoli_list, parco_veicoli_per_categoria, parco_veicolo_dossier, modelli_list | Lectura |
| Vencimientos de vehículos | parco_scadenze_list, parco_scadenze_in_scadenza, parco_scadenze_aggregato | Lectura |
| Contratos | contratti_list, contratti_noleggi_attivi, contratti_dettaglio, contratti_fatturato_aggregato | Lectura |
| Reservas | prenotazioni_search, prenotazioni_dettaglio, prenotazioni_cancella | Lectura; prenotazioni_cancella escribe, con confirmación |
| Reserva online | booking_engine_disponibilita, booking_engine_crea_prenotazione | Lectura; booking_engine_crea_prenotazione escribe, con confirmación |
| Calendario | calendario_veicoli, calendario_crea_bozza, calendario_riassegna_veicolo | Lectura; calendario_crea_bozza y calendario_riassegna_veicolo escriben, con confirmación |
| Tarifas de la competencia | concorrenza_tariffe_list | Lectura |
| Conductores | conducenti_search, conducenti_dossier | Lectura |
| Multas | multe_list, multe_dettaglio, multe_aggregato | Lectura |
| Siniestros | rds_list, rds_dettaglio, rds_aggregato | Lectura |
| Movimientos | movimenti_list, movimenti_aggregato, movimenti_transiti_tra_stazioni | Lectura |
| Panel de control | cruscotto_operatore_kpi, cruscotto_operatore_drilldown, cruscotto_operatore_filtri, lavoro_del_giorno | Lectura |
| Obligaciones | adempimenti_da_fare, adempimenti_contratto, cargos_comunicazioni_list, hospedajes_comunicazioni_list, noleggi_lunghi_list | Lectura |
| Brókers | broker_list, broker_dettaglio, broker_estratto_conto, broker_aging, broker_netto_canale, broker_riconciliazioni_list, broker_riconciliazione_dettaglio | Lectura |
| Opiniones NPS | nps_report | Lectura |
| Lista de agentes | agenti_manifesto | Lectura |
Las herramientas respetan los permisos del usuario: quien no es administrador ve solo sus oficinas; extracto, antigüedad de saldos, neto por canal y conciliaciones de los brókers requieren el permiso Finanzas de bróker.
Escrituras
Cuatro herramientas escriben, siempre en dos pasos
02
Confirmación
El asistente te muestra la vista previa, espera tu sí y vuelve a llamar a la herramienta con la confirmación activa (confermato o applica = true).
03
Ejecución
El cambio pasa por la API oficial del programa, con los permisos de tu usuario. Los tokens de servicio de los agentes automáticos no pueden escribir.
Clientes
Conectar un asistente
01
Claude (claude.ai y app de escritorio)
Ajustes › Conectores › Añadir conector personalizado, dirección https://nolomcp.rilogi.it/mcp. Al iniciar sesión introduce el código de empresa, el usuario y la contraseña del programa.
02
Claude Code
claude mcp add --transport http noloforweb https://nolomcp.rilogi.it/mcp, después el inicio de sesión desde el comando /mcp. Para un agente automático, un token de servicio en la cabecera Authorization.
03
Otros clientes MCP
Cualquier cliente que admita servidores MCP remotos en Streamable HTTP con OAuth 2.1 y registro dinámico. Hasta ahora lo hemos probado con Claude y Claude Code.
Preguntas frecuentes
¿Dónde responde el servidor MCP de NoloForWeb?
En https://nolomcp.rilogi.it/mcp, la misma dirección para todos los clientes. La empresa se elige con el código de empresa al iniciar sesión y queda escrita en el token: a partir de ahí cada llamada lee solo la base de datos de esa empresa.
¿Hay que registrar el cliente antes?
No: el servidor admite el registro dinámico de clientes (RFC 7591). Los clientes son públicos, sin secret, con PKCE S256 obligatorio.
¿El asistente puede modificar datos?
Solo con cuatro herramientas (cancelar una reserva, crear una desde el motor de reservas, crear un borrador o reasignar un vehículo en el calendario) y siempre en dos pasos: vista previa y luego confirmación. Contratos y facturas no se tocan.
¿Hay un entorno de pruebas?
Todavía no es público. Escríbenos desde la página de Contacto: en la demo conectamos tu asistente a una empresa con datos de ejemplo.
¿Quieres probarlo con tus datos?
En la demo conectamos tu asistente y le hacemos las preguntas que te haces cada día en el mostrador.