/06 SOFTWARE aggiornata al 12 novembre 2026 10 minuti

Server MCP
per il
gestionale.

Un server MCP è il connettore che permette a un assistente AI di leggere e scrivere nel vostro gestionale, con le regole che decidete voi. Questa guida è per software house e reparti IT: che cosa esporre, come proteggerlo e che cosa abbiamo imparato costruendone.

/che cos'è

Una presa standard
per gli assistenti.

MCP sta per Model Context Protocol: è uno standard aperto per collegare le applicazioni di AI ai sistemi esterni. Lo ha pubblicato Anthropic a novembre 2024, oggi è un progetto della Linux Foundation e lo parlano assistenti come Claude e ChatGPT e strumenti come Visual Studio Code e Cursor. La documentazione ufficiale lo paragona a una porta USB-C: una presa sola, e dall'altra parte quello che serve.

Un server MCP mette a disposizione dell'assistente tre cose: strumenti, cioè funzioni da chiamare («cerca gli ordini di un cliente»), risorse, cioè dati da leggere, e prompt, cioè richieste già pronte. Per un gestionale contano soprattutto gli strumenti.

Il server non è il gestionale e non lo sostituisce: gli sta accanto e ne usa le API o il database. Scritto una volta, serve tutti gli assistenti che parlano MCP.

/in pratica

Domande vere,
risposte dal gestionale.

Chi usa il gestionale scrive o dice quello che gli serve. L'assistente traduce la richiesta in chiamate agli strumenti del server e risponde con i dati che quella persona può vedere.

Un server MCP non serve sempre. Se all'assistente basta riassumere un documento che l'utente ha già davanti, è sufficiente una chiamata al modello. Il server serve quando l'assistente deve interrogare o modificare dati vivi.

/perimetro

Che cosa esporre,
e che cosa no.

/01

Pochi strumenti, nomi chiari

Non uno strumento per ogni tabella o per ogni endpoint: uno per ogni domanda che le persone fanno davvero. Con pochi strumenti ben distinti l'assistente sceglie quello giusto.

/02

Prima la sola lettura

La prima versione legge e basta. Dall'uso si vede che cosa le persone chiedono, e le scritture si progettano su quello.

/03

Scritture in due tempi

Lo strumento prepara una proposta, una persona la conferma. Lo chiede anche la specifica: dovrebbe esserci sempre qualcuno che può negare la chiamata di uno strumento.

/04

Niente cancellazioni

Annullare, chiudere, disattivare: operazioni che lasciano traccia e si possono rivedere. Uno strumento che cancella non serve quasi mai, e non si affida a un assistente.

/05

Risposte corte, codici veri

Un numero massimo di righe, solo i campi utili, e codici di clienti, articoli e ordini presi sempre da una ricerca: l'assistente non deve inventarli.

/06

Le descrizioni sono metà del lavoro

Ogni strumento dice a parole quando usarlo e in che formato vuole date e codici. Il comportamento dell'assistente si corregge lì, più che nel codice.

/sicurezza

Le regole
che non si saltano.

/accesso

OAuth 2.1, e token solo suoi

La specifica non impone l'autorizzazione, ma per un server raggiungibile via HTTP indica la strada: OAuth 2.1. Il server è un resource server: pubblica i propri metadati, accetta solo i token emessi per lui e non fa transitare token destinati ad altri servizi.

/permessi

L'assistente vede quello che vede la persona

Ogni chiamata arriva a nome di un utente, e il server applica i permessi che quell'utente ha nel gestionale. Niente utenze di servizio che vedono tutto.

/controlli

Quattro obblighi del server

Li elenca la specifica: validare tutti gli input, controllare gli accessi, limitare la frequenza delle chiamate, ripulire gli output. Valgono anche quando dall'altra parte c'è un assistente di cui ci si fida.

/testo ostile

I dati possono dare ordini

Note, descrizioni ed email salvate nel gestionale possono contenere frasi scritte apposta per dirigere l'assistente. Per questo nessuno strumento ha più potere del necessario, e le scritture passano da una conferma.

/registro

Chi ha chiesto che cosa

Ogni chiamata lascia una riga: utente, strumento, parametri, esito. Serve per i controlli, e per capire come l'assistente viene usato davvero.

/dove vanno i dati

Decide il server, non l'assistente

Quello che l'assistente legge viene elaborato dal modello che avete scelto, alle condizioni del contratto con quel fornitore. Il server stabilisce che cosa è leggibile e da chi. I dati che non devono uscire non si espongono, oppure si usa un modello che gira sui vostri server.

La specifica lo dice in chiaro: il protocollo da solo non può far rispettare queste regole. Vanno costruite nel server e nell'applicazione che lo usa.

/sul campo

Otto cose imparate
costruendone.

Chi segue lo sviluppo da noi ha scritto per uso proprio due server MCP, e li usa ogni giorno: un gestore di attività e scadenze in C#, interrogato dal telefono e a voce, e un archivio di eventi di videosorveglianza a cui si fanno domande in italiano. Non sono gestionali, ma i problemi sono gli stessi.

/avvisi creati a parole

Una frase diventa una regola.

Nell'archivio degli eventi gli avvisi non si configurano: si dicono. Due esempi veri:

  • «Se il cane resta vicino al pollaio per più di cinque minuti, mandami una notifica con il fotogramma.»che cosa: cane · dove: pollaio
    da quanto: più di 5 minuti · avviso con fotogramma
  • «Se di notte una persona sosta davanti alla porta d'ingresso per più di un minuto, mandami una notifica urgente.»che cosa: persona · dove: ingresso · quando: di notte
    da quanto: più di 1 minuto · avviso urgente

L'assistente trasforma la frase in una regola precisa, la rilegge con parole sue insieme alle avvertenze, e la regola vale solo dopo un sì esplicito. Dietro c'è un motore di regole che controlla gli eventi; davanti, una frase. Su un gestionale il meccanismo è lo stesso: «se la giacenza di un articolo scende sotto la scorta minima, avvisa chi fa gli acquisti».

/01

L'assistente fa quello che le descrizioni gli dicono

Nel gestore di attività le date arrivano già risolte nel formato anno-mese-giorno, gli identificativi si prendono da una ricerca e non si inventano, e per chiudere un'attività si preferisce «completa» a «cancella», perché lascia traccia. Sta scritto nelle descrizioni degli strumenti, e l'assistente lo rispetta.

/02

Le istruzioni stanno nel server

Un testo unico di istruzioni, servito a ogni client insieme agli strumenti. Così l'assistente si comporta allo stesso modo dal telefono, dal PC e a voce, senza che ognuno debba spiegarglielo.

/03

Le scritture che contano nascono come proposta

Una regola nuova nasce proposta e vale solo dopo la conferma: se l'assistente ha capito male la frase, lo si vede prima che la regola lavori. Nessuno strumento cancella: una regola si disattiva.

/04

Dati al livello giusto

Per le domande generiche l'assistente trova riassunti già scritti; per i numeri c'è uno strumento a parte, che conta. E quando una ricerca è poco pertinente lo strumento lo dice, invece di lasciare che l'assistente riempia i vuoti.

/05

Risposte da ascoltare

Molte richieste arrivano a voce, anche in macchina. Frasi brevi, una cosa alla volta, e mai codici o identificativi letti ad alta voce.

/06

Senza stato si aggiorna senza pensieri

Un server senza sessioni si riavvia e si aggiorna senza scollegare nessuno. Attenzione invece agli schemi: un client può tenere in memoria l'elenco degli strumenti, e cambiare nome o parametri a uno strumento in uso è come cambiare un'API pubblica.

/07

Un solo scrittore

Tutte le scritture passano da un unico punto, una alla volta, e sono atomiche: o vanno a buon fine per intero, o non lasciano niente a metà.

/08

I dati restano dove sono

Nell'archivio le descrizioni delle scene le scrive un modello che gira in locale: al server MCP arrivano frasi già scritte, e le immagini non escono.

/codice

Quanto codice
serve.

Poco, se c'è un SDK. Questo è un server con un solo strumento in sola lettura, scritto in C# con l'SDK ufficiale, che è mantenuto insieme a Microsoft. È un estratto: mancano la configurazione dell'accesso e la classe che legge i dati.

Program.csC# · ModelContextProtocol.AspNetCore 2.4
using System.ComponentModel;
using System.Security.Claims;
using ModelContextProtocol.Server;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddScoped<IOrdini, OrdiniDelGestionale>();   // il vostro accesso ai dati
// qui va l'accesso con OAuth, come in ogni applicazione ASP.NET Core

builder.Services.AddMcpServer()
    .WithHttpTransport()             // senza stato: nella versione 2 dell'SDK è il comportamento predefinito
    .WithTools<StrumentiOrdini>();

var app = builder.Build();
app.MapMcp("/mcp").RequireAuthorization();
app.Run();

[McpServerToolType]
public class StrumentiOrdini(IOrdini ordini)
{
    [McpServerTool(Name = "cerca_ordini", ReadOnly = true)]
    [Description("Elenca gli ordini di un cliente in un periodo. Usalo quando si chiede lo stato, " +
                 "le date o gli importi degli ordini. Restituisce al massimo 20 righe.")]
    public Task<IReadOnlyList<Ordine>> CercaOrdini(
        ClaimsPrincipal utente,
        [Description("Codice cliente restituito da cerca_clienti. Non inventarlo.")] string codiceCliente,
        [Description("Primo giorno del periodo.")] DateOnly dal,
        [Description("Ultimo giorno del periodo.")] DateOnly al)
        => ordini.CercaAsync(utente, codiceCliente, dal, al, massimo: 20);
}

Lo stesso si fa in TypeScript, Python, Java, Go o PHP: ci sono SDK ufficiali per dieci linguaggi. Noi lavoriamo in quello del vostro prodotto.

/il pacchetto

Come lo facciamo
noi.

È il primo dei nostri quattro pacchetti, «Assistente AI per il gestionale»: un lavoro delimitato, con prezzo fisso e data di consegna.

/01

Voi ci dite le domande

Quali richieste deve saper soddisfare l'assistente, e un ambiente di prova con le API o le viste del database.

/02

Noi scriviamo la proposta

Elenco degli strumenti, prezzo fisso e data di consegna. Se il perimetro non ci convince, lo diciamo.

/03

Consegniamo nel vostro repository

Codice, test, documentazione e i testi delle descrizioni, nel linguaggio del vostro prodotto. Il cliente e il marchio restano vostri.

Tutti i pacchetti e il metodo →

/domande

Sette domande,
sette risposte.

Che differenza c'è tra un server MCP e le API che abbiamo già?

Le API sono fatte per i programmi; un server MCP le presenta a un assistente: pochi strumenti, descritti a parole, con lo schema degli argomenti. Di solito il server MCP non sostituisce le API: le chiama.

Con quali assistenti funziona un server MCP?

Con tutti quelli che parlano il protocollo. La documentazione ufficiale cita assistenti come Claude e ChatGPT e strumenti come Visual Studio Code e Cursor. Lo stesso server li serve tutti, senza integrazioni separate.

Bisogna modificare il gestionale?

No. Il server sta accanto al gestionale e usa le API che esistono già, oppure il database attraverso viste dedicate. Vale anche per i gestionali scritti con tecnologie datate.

L'assistente può scrivere dati sbagliati?

Può sbagliare, come una persona. Per questo si parte dalla sola lettura, le scritture nascono come proposta da confermare, ogni input viene controllato e ogni chiamata resta nel registro.

I dati dei clienti finiscono al fornitore dell'AI?

Quello che l'assistente legge per rispondere viene elaborato dal modello che usate, alle condizioni del contratto con quel fornitore. Il server decide che cosa è leggibile e da chi. I dati che non devono uscire non si espongono, oppure si usa un modello che gira sui vostri server.

Che cosa è cambiato con la specifica del 28 luglio 2026?

Il protocollo è diventato senza stato: non ci sono più la stretta di mano iniziale né le sessioni, e ogni richiesta porta con sé quello che serve. Un server è più semplice da ospitare e da aggiornare. Gli SDK ufficiali principali la supportano già; quello per C# dalla versione 2.0.

Quanto tempo serve per un primo server MCP?

Dipende da quanti strumenti servono e da come si arriva ai dati. Per questo lo scriviamo nella proposta: elenco degli strumenti, prezzo fisso e data di consegna.

Aggiornata al 12 novembre 2026 · il protocollo cambia in fretta: prima di partire verifichiamo la revisione in vigore

// next.step

Avete un gestionale? Diamogli un assistente.

Scriveteci che cosa deve saper fare: rispondiamo con una proposta scritta, con elenco degli strumenti, prezzo e data di consegna.