Se produci un gestionale, un CRM o un software verticale, prima o poi un cliente ti chiederà se funziona con l’assistente AI che usa. Questa pagina è per te: cosa vuol dire tecnicamente, come l’hanno fatto alcuni produttori, cosa chiedono le piattaforme per comparire nei loro cataloghi, e come possiamo lavorare insieme.
Cosa vuol dire «compatibile con l’AI» per un prodotto software?
MCP (Model Context Protocol) è uno standard aperto per collegare le applicazioni AI a sistemi esterni [Model Context Protocol]. Il server MCP del tuo prodotto espone strumenti (cerca un cliente, leggi un ordine, prepara una bozza) descritti in modo che l’assistente capisca quando usarli. Un solo server serve più assistenti, ma ognuno ha regole sue su chi lo aggiunge, come si autentica l’utente e cosa va confermato: lì si concentra il lavoro.
Il server MCP non sostituisce la tua API: ci sta sopra. Gli strumenti non corrispondono uno a uno agli endpoint. Si progettano partendo dalle domande che i tuoi clienti fanno davvero, e sono pochi.
Come l’hanno fatto altri produttori?
Alcuni produttori hanno già pubblicato il proprio server. Le loro scelte sono un buon punto di partenza, perché mostrano decisioni diverse sugli stessi problemi:
| Prodotto | Indirizzo del server | Accesso | Cosa si può fare di serie |
|---|---|---|---|
| Fattura24 | uno solo, www.app.fattura24.com/mcp |
OAuth | sola lettura; una funzione di segnalazione chiede conferma all’utente [Fattura24] |
| Odoo 20 | uno per ogni database: l’indirizzo del database seguito da /mcp |
OAuth oppure chiave API con ambito MCP | pochi strumenti di lettura; ogni altra azione va esposta esplicitamente [Odoo] |
| Business Central | uno solo, ospitato da Microsoft | OAuth 2.0 con PKCE e Microsoft Entra ID, con identità e permessi dell’utente | configurazione predefinita in sola lettura; la scrittura la abilita l’amministratore [Microsoft] |
HubSpot, infine, usa un unico server MCP remoto per i propri connettori verso Claude, Microsoft Copilot, Gemini e ChatGPT [HubSpot]: un server, quattro assistenti.
Due schemi per un prodotto con molti clienti: un indirizzo per ogni cliente, come Odoo, oppure un indirizzo unico in cui è l’accesso dell’utente a stabilire quali dati vede. Il secondo è più semplice da pubblicare in un catalogo, perché la scheda è una sola.
Cosa deve avere un server MCP per un prodotto con molti clienti?
- Separazione tra clienti. Ogni chiamata deve sapere di quale cliente e di quale utente è. Niente chiavi condivise che vedono tutto: Claude, tra l’altro, non supporta il flusso OAuth da macchina a macchina (
client_credentials) [Anthropic]. - Accesso OAuth per singolo utente. Su Claude Team ed Enterprise un Owner aggiunge il connettore per l’organizzazione, poi ogni membro si collega con il proprio account [Anthropic]. La specifica MCP tratta il server come resource server OAuth 2.1 e rende obbligatori i metadati della risorsa protetta (RFC 9728) [Model Context Protocol].
- Registrazione del client. La versione 2026-07-28 della specifica depreca la registrazione dinamica dei client (DCR) a favore dei Client ID Metadata Documents [Model Context Protocol]. OpenAI raccomanda questi ultimi e supporta ancora la DCR [OpenAI]; Claude può registrarsi tramite DCR e documenta alternative [Anthropic]. Oggi conviene supportare entrambe.
- I permessi del prodotto, non permessi nuovi. Il server chiama la tua API con il token dell’utente, così valgono le regole che il prodotto ha già. Un secondo sistema di permessi da tenere allineato è una fonte sicura di errori.
- Lettura e scrittura separate. ChatGPT chiede conferma manuale prima delle azioni di scrittura e avverte che marcare uno strumento come di sola lettura non è una garanzia [OpenAI]. Gemini Enterprise chiede conferma per ogni azione, salvo quelle marcate
readOnlyHint[Google Cloud]. Le annotazioni vanno messe con cura, ma il controllo vero sta nel server. - Registro delle chiamate. Chi ha chiamato quale strumento, con quali parametri, quando. Ai tuoi clienti serve per sapere chi ha letto cosa; a te per il supporto.
- Risposte di dimensione ragionevole. Su claude.ai e Claude Desktop un risultato può arrivare a circa 150.000 caratteri e una chiamata a 240 secondi [Anthropic]. Microsoft avverte che negli agenti di Microsoft 365 Copilot la qualità può peggiorare oltre i 10 strumenti [Microsoft]. Filtri, paginazione e riepiloghi fanno parte del progetto.
Quale versione della specifica MCP bisogna supportare?
La versione corrente è la 2026-07-28 [Model Context Protocol]. Rende il protocollo senza stato: toglie la stretta di mano iniziale e le sessioni a livello di protocollo [Model Context Protocol]. Claude però documenta le specifiche di autorizzazione fino alla 2025-11-25 [Anthropic], e al 13 novembre 2026 non abbiamo trovato documentazione in cui uno dei quattro assistenti dichiari di supportare la 2026-07-28.
In pratica: si serve oggi chi parla 2025-11-25, e si progetta senza appoggiarsi alle sessioni, così il passaggio è breve. Le funzioni deprecate restano per almeno dodici mesi [Model Context Protocol].
Come arriva il tuo server nei cataloghi degli assistenti?
| Assistente | Come lo aggiunge un tuo cliente | Catalogo pubblico |
|---|---|---|
| Claude | inserendo l’indirizzo come connettore personalizzato, senza revisione di Anthropic; su Team ed Enterprise lo fa un Owner [Anthropic] | Directory di Anthropic: può inviare chiunque abbia un piano a pagamento, senza un programma da sottoscrivere; i connettori sono controllati in automatico e pubblicati come «Community», con possibile revisione «Verified» [Anthropic] |
| ChatGPT | su Business solo amministratori e owner creano e pubblicano nell’area di lavoro il plugin per un server MCP personalizzato [OpenAI · da verificare] | Directory dei plugin: verifica dell’identità con cui pubblichi, account dimostrativo senza autenticazione a due fattori per i revisori, server su un dominio pubblico, controllo continuo degli strumenti modificati [OpenAI] |
| Microsoft Copilot | come strumento di un agente in Copilot Studio, con OAuth 2.0 per utente o chiave API [Microsoft]; in Microsoft 365 Copilot solo dentro agenti dichiarativi [Microsoft] | connettori federati della galleria, pubblicati da Microsoft o inviati dai produttori per approvazione; usano l’identità dell’utente e richiedono una licenza Microsoft 365 Copilot [Microsoft] |
| Gemini Enterprise | edizioni Standard e Plus: disponibile dal 7 agosto 2026, dopo che un amministratore ha tolto un vincolo delle policy dell’organizzazione [Google Cloud]; solo Streamable HTTP, OAuth per utente [Google Cloud] | non verificato |
La conseguenza pratica: per Copilot e Gemini buona parte dell’attivazione sta dal lato dell’IT del tuo cliente. Una guida di attivazione chiara, per ogni assistente, fa parte del prodotto quanto il server.
Lo costruiamo con te o per te: chi possiede il codice?
Due modi di lavorare:
- Con il tuo team. Scrivete voi il server; noi portiamo il disegno degli strumenti, l’autenticazione, i permessi, le prove sui quattro assistenti e la preparazione per i cataloghi.
- Per te. Lo scriviamo noi sopra la tua API, con documentazione e passaggio di consegne al tuo team.
Il nostro consiglio è uno: il server MCP del tuo prodotto è parte del prodotto, quindi deve stare nel tuo repository e sotto il tuo controllo, chiunque lo scriva. Le condizioni si mettono per iscritto prima di iniziare. [da completare: condizioni standard su proprietà del codice e licenze nei progetti per software house]
Da te servono: la documentazione dell’API o l’accesso al codice, un ambiente di prova con dati dimostrativi, il tuo sistema di autenticazione (o la decisione di aggiungerne uno compatibile con OAuth) e una persona di riferimento nel team. Le stesse regole di accesso personale, sola lettura di serie e registro che applichiamo ai gestionali sono descritte nella pagina sicurezza.
Il programma pilota è pensato per le aziende che collegano il proprio gestionale. Per un prodotto si parte da una chiamata tecnica: scrivici. Per le basi del protocollo c’è la guida cos’è un server MCP; per il lato assistente, le pagine su connettori personalizzati in Claude e server MCP in ChatGPT.