# Il trucco: una query API di Business Central diventa uno strumento AI con il server MCP

> La funzione AI più sottovalutata di Business Central non è un pulsante Copilot. È il server MCP. Ogni pagina o query API scritta in AL può diventare uno strumento in sola lettura per un assistente AI. Come lo uso, cosa serve, dove si ferma.

La funzione AI più sottovalutata di Business Central non è un pulsante Copilot.

È il server MCP.

Quando un reparto IT mi chiede da dove partire con l’AI in Business Central, di solito si aspetta una risposta sulle funzioni Copilot o sugli agenti di Microsoft. Sono utili. Ma fanno ciò che Microsoft ha previsto, e non rispondono alle domande che l’amministrazione fa davvero: perché i numeri non tornano, quale cliente paga peggio, cosa sembra strano. Per questo serve una logica propria. Il server MCP è il modo in cui quella logica arriva a un assistente AI.

## Cosa fa il server MCP

MCP, il Model Context Protocol, è uno standard aperto che permette a un assistente AI di richiamare strumenti. Business Central ora ha un proprio server MCP. Ogni pagina API o query API scritta in AL può diventare uno strumento che un assistente (Claude, ChatGPT, Copilot Studio o un altro client MCP) può richiamare.

Decidi tu quali strumenti e con quali diritti, in una sola pagina di configurazione in Business Central. Niente middleware, niente server di integrazione separato, niente export.

## Come costruisco

Cambia l’ordine in cui costruisco:

1. **La logica di business in AL.** Deterministica, testabile, spiegabile. Stesso input, stesso numero, sempre.
2. **Il risultato esposto come API in sola lettura.** Una pagina API o una query API, niente di più.
3. **L’API aggiunta a una configurazione MCP.** Si scelgono gli strumenti, si disattiva la scrittura.
4. **L’AI fa ciò che sa fare.** Scegliere lo strumento giusto, leggere il risultato, ordinare, spiegare nella lingua di chi chiede.

Lo chiamo **AL fa i conti, l’AI spiega.** Un modello linguistico è bravo a riassumere e dare priorità. Sommare centomila registrazioni, non è affidabile. Quindi non fa mai i conti. Riceve numeri già calcolati e li mette in parole.

## Cosa ho configurato per la demo

Per la serie «Hack Business Central» ho costruito un’estensione AL con tre pagine API e due query API:

- comportamento di pagamento per cliente (importi aperti e scaduti, giorni di pagamento ora e prima, trend)
- quadratura mensile tra partitario vendite e contabilità generale
- registrazioni sui conti ricavi che non vengono da documenti di vendita
- i risultati di sei regole per le anomalie

Tutti i valori sono calcolati su richiesta. L’estensione non scrive dati.

La configurazione MCP contiene esattamente questi strumenti. Nessun diritto di scrittura. Nessuna ricerca dinamica di oggetti, quindi l’assistente non può esplorare altre tabelle da solo. E vede solo ciò che l’utente collegato può già vedere in Business Central.

## Il risultato nella demo

La demo gira sulla società demo CRONUS di Microsoft con una storia inventata. Nessun dato di clienti.

Ho chiesto: «Quali clienti pagano peggio ultimamente, e quanta cassa c’è in ballo?» Non ho indicato nessuno strumento. L’assistente ha scelto da solo l’API sul comportamento di pagamento e ha risposto:

> Due clienti pagano molto più lentamente. Alpine Ski House nell’ultimo semestre ha impiegato in media 68 giorni per pagare, prima 42; ha 25.124 € scaduti. Adatum Corporation è passata da 32 a 49 giorni, con 14.409 € scaduti. School of Fine Art invece paga più in fretta di prima (da 49 a 26 giorni). Io partirei da Alpine Ski House: importo più alto, peggioramento più forte.

I numeri vengono da AL. La priorità e le parole vengono dal modello. Fai la stessa domanda in tedesco o in inglese: stessi numeri, altra lingua.

## Cosa serve

- **Business Central online.** Il server MCP esiste solo nella versione cloud.
- **Una sandbox.** Le nuove estensioni si sviluppano e si testano lì, mai direttamente in produzione.
- **Una registrazione app in Entra.** Business Central non supporta la registrazione dinamica dei client, quindi l’assistente accede tramite un’app che registri tu, con l’autorizzazione delegata `Financials.ReadWrite.All` e il consenso dell’amministratore. I diritti effettivi restano quelli dei set di autorizzazioni in Business Central e della configurazione MCP in sola lettura.
- **Una decisione su quale assistente può vedere quali dati.** Le funzioni di Microsoft girano su Azure OpenAI all’interno dell’EU Data Boundary. Gli assistenti esterni elaborano i risultati richiesti nel proprio ambiente. È una questione di privacy, non tecnica. Va presa prima del primo test, non dopo.

## Cosa non fa

- **Non registra, non approva, non decide.** E non deve farlo. La configurazione è in sola lettura apposta.
- **Non corregge una logica sbagliata.** Se il calcolo in AL è sbagliato, l’assistente spiega con eleganza un numero sbagliato. I test vanno fatti in AL.
- **Non sostituisce le autorizzazioni.** L’assistente vede ciò che vede l’utente. Se un utente non deve vedere gli stipendi, deve dirlo il set di autorizzazioni.
- **Il modello linguistico può comunque sbagliare nelle parole.** Per questo ogni risposta deve risalire a un risultato dello strumento.
- **Non esiste on-premises.** Business Central nel proprio data center non ha il server MCP. Lì serve un’altra strada.

## Provalo

Strumenti e commento AI sono nella demo interattiva: [Apri il Management Cockpit per Business Central](https://karrenberg.it/demo/bc-cockpit/?lang=it). Solo dati demo.

Architettura, componenti e l’elenco completo dei limiti sono nel white paper: [Chiedilo a Business Central: tre applicazioni di AI che funzionano già oggi](https://karrenberg.it/blog/business-central-ai-casi-uso-02471f).

## Il tuo team affronta un problema simile?

Se hai una domanda a cui il gestionale dovrebbe rispondere e un reparto IT che la vuole in sola lettura e tracciabile, è un buon punto di partenza. [Parliamo del tuo problema](https://karrenberg.it/#contatto). Di solito rispondo entro due giorni lavorativi.

---
Simon Milos Karrenberg · https://karrenberg.it/blog/business-central-mcp-api-strumento-ai
