Molti gestionali diffusi in Italia non hanno ancora un server MCP ufficiale. Si costruisce sulle API del gestionale, se le espone, o su un accesso al database in sola lettura. Non è un lavoro lungo. Con API documentate un primo server in sola lettura richiede pochi giorni, e il tempo vero va nel decidere quali funzioni esporre, a chi e con quali limiti. Che cos'è un server MCP è spiegato nella guida su che cos'è un server MCP.
Da dove si parte: API o database?
Si parte dalle API del gestionale, se ci sono e sono documentate. Le API rispettano le regole del gestionale: permessi, validazioni, calcoli. Il database in sola lettura è l'alternativa quando le API mancano o sono limitate, ma richiede di conoscere bene la struttura delle tabelle e non va mai usato per scrivere, perché salterebbe le validazioni del gestionale.
| Strada | Quando | Attenzione a |
|---|---|---|
| API ufficiali | il gestionale le espone e sono documentate | limiti di chiamate, versioni delle API |
| Database in sola lettura | API assenti o incomplete | struttura delle tabelle, mai in scrittura |
| Esportazioni periodiche | nessun accesso diretto possibile | dati non aggiornati, va bene solo per analisi |
Quali funzioni esporre?
Si espongono solo le funzioni che servono al caso d'uso, una per volta. Per un agente che prepara gli ordini bastano poche funzioni: cerca cliente, cerca articolo, leggi listino, crea bozza d'ordine. Ogni funzione ha un nome chiaro, una descrizione che il modello legge per capire quando usarla e parametri semplici. Più funzioni si espongono, più il modello rischia di sceglierne una sbagliata. Le regole su permessi e conferme sono nella guida sulla sicurezza dei server MCP.
In che ordine si costruisce?
- Sola lettura: si espongono le funzioni di ricerca e lettura e si prova con domande reali di chi usa il gestionale.
- Bozze: si aggiunge la creazione di bozze, che una persona conferma nel gestionale.
- Scrittura controllata: solo dopo settimane di bozze corrette si valuta se togliere la conferma su alcune azioni.
Domande frequenti su server MCP
Quanto ci vuole a costruire un server MCP per un gestionale?
Con API documentate, pochi giorni per un primo server in sola lettura. Il tempo cresce con il numero di funzioni esposte, con le azioni in scrittura e con i controlli di sicurezza: permessi per ruolo, conferme umane, registri. La parte più lunga, di solito, è decidere che cosa esporre.
Si può collegare l'AI a un gestionale installato in azienda?
Sì. Il server MCP può stare sulla stessa rete del gestionale, senza esporre nulla su internet. Abbinato a un modello installato sui server dell'azienda permette di lavorare sui dati senza che escano dalla rete interna.
Serve modificare il gestionale?
No. Il server MCP si appoggia alle API o al database in sola lettura e non tocca il gestionale. Serve però un'utenza di servizio dedicata, creata da chi amministra il gestionale, con i soli permessi del caso d'uso.
Fonti
Scritto da
Co-founder, CTO e COO di Deepelse
Giovanni Vanini è co-founder di Deepelse, dove guida la parte tecnica e operativa: architetture degli agenti, scelta dei modelli, integrazioni con gestionali e CRM, agenti vocali.
