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.
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.
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.
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.
La prima versione legge e basta. Dall'uso si vede che cosa le persone chiedono, e le scritture si progettano su quello.
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.
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.
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.
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.
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.
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.
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.
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.
Ogni chiamata lascia una riga: utente, strumento, parametri, esito. Serve per i controlli, e per capire come l'assistente viene usato davvero.
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.
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.
Nell'archivio degli eventi gli avvisi non si configurano: si dicono. Due esempi veri:
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».
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.
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.
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.
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.
Molte richieste arrivano a voce, anche in macchina. Frasi brevi, una cosa alla volta, e mai codici o identificativi letti ad alta voce.
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.
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à.
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.
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.
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 primo dei nostri quattro pacchetti, «Assistente AI per il gestionale»: un lavoro delimitato, con prezzo fisso e data di consegna.
Quali richieste deve saper soddisfare l'assistente, e un ambiente di prova con le API o le viste del database.
Elenco degli strumenti, prezzo fisso e data di consegna. Se il perimetro non ci convince, lo diciamo.
Codice, test, documentazione e i testi delle descrizioni, nel linguaggio del vostro prodotto. Il cliente e il marchio restano vostri.
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 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.
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.
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.
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.
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.
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
Scriveteci che cosa deve saper fare: rispondiamo con una proposta scritta, con elenco degli strumenti, prezzo e data di consegna.