Da Odoo 20 il server MCP è dentro il prodotto: non va installato nulla. Se sei su Odoo 20, la cosa più onesta che possiamo dirti è: prova prima quello. Questa pagina spiega come funziona, cosa resta fuori e quale strada prendere se sei su una versione precedente o su un piano senza API.
Su Odoo 20 il server MCP c’è già
Con Odoo 20, pubblicato a settembre 2026, puoi collegarti al database via MCP [Odoo], il protocollo con cui gli assistenti AI usano strumenti esterni. In pratica, secondo la documentazione [Odoo]:
- Indirizzo. È quello del tuo database seguito da
/mcp, per esempiohttps://example.odoo.com/mcp. - Accesso. OAuth è il metodo consigliato ed è riservato agli utenti interni; gli utenti portale usano una chiave API. I client approvati si indicano con il loro documento di metadati (CIMD); in alternativa si può attivare la registrazione dinamica (DCR), che però permette a qualsiasi applicazione di registrarsi.
- Chiave API. Si crea dalle preferenze dell’utente, scheda Sicurezza, con ambito «MCP» e una scadenza. Viene mostrata una sola volta.
- Strumenti di serie. Cinque: lettura dei modelli, lettura dei campi, contesto iniziale, ricerca e raggruppamento. Le altre azioni server restano nascoste finché l’amministratore non spunta «Available in MCP».
- Revoca. Ogni collegamento compare come chiave API nelle preferenze dell’utente: per revocarlo si cancella la chiave.
La documentazione riporta i passi per Claude (Claude Code e Claude Desktop) e per ChatGPT, dove il server si aggiunge da Impostazioni › Plugins › Add custom MCP server con autenticazione OAuth [Odoo].
Un dettaglio da non trascurare: il segno «Readonly Tool» su un’azione server non la nasconde all’assistente, segnala solo che si può eseguire senza chiedere conferma [Odoo]. Quello che non vuoi far fare, semplicemente non va esposto.
Quale strada per la tua versione e il tuo piano?
| La tua situazione | Strada | Da sapere |
|---|---|---|
| Odoo 20 | Server MCP integrato [Odoo] | La documentazione non dice quale piano o tipo di hosting richiede: si verifica sul tuo database |
| Odoo 19 | Connettore MCP costruito sull’API JSON-2, introdotta con la 19.0 [Odoo] | Su Odoo Online serve il piano Custom |
| Odoo 17 o 18 | Connettore sulle API XML-RPC o JSON-RPC | Deprecate: il connettore va riscritto quando aggiorni, entro Odoo 22 |
| Odoo Online con piano One App Free o Standard | Nessuna API esterna [Odoo] | Passare al piano Custom, oppure lavorare su esportazioni |
| Domande su Odoo e altri sistemi insieme | Connettore che unisce le fonti | Il server di Odoo vede solo Odoo |
Le API: JSON-2 e la scadenza delle vecchie RPC
Se non sei su Odoo 20, o se ti serve più controllo di quello che danno gli strumenti generici, il connettore si costruisce sull’API JSON-2. Cosa dice la documentazione [Odoo]:
- Si chiama con una richiesta POST a
/json/2/seguito da modello e metodo, con una chiave API nell’intestazione Authorization. - L’accesso ai dati tramite API esterna è disponibile solo sui piani Custom; non su One App Free né su Standard.
- Una chiave non può durare più di tre mesi, quindi va ruotata almeno ogni tre mesi. Di serie, un utente può crearne fino a 10 da programma.
- Ogni operazione è controllata con i diritti di accesso, le regole sui record e i permessi sui campi dell’utente. Per le integrazioni automatiche di lunga durata Odoo consiglia utenti «bot» dedicati, con i permessi minimi.
- Ogni chiamata gira nella propria transazione: più operazioni collegate vanno raccolte in un unico metodo.
Sugli utenti bot proponiamo una scelta diversa, e te la spieghiamo. Per le domande delle persone usiamo l’identità di ciascuno, così valgono le regole sui record che hai già (l’agente vede i suoi clienti, non quelli dei colleghi). Un utente bot, con permessi minimi, serve solo per i report pianificati, se ci sono.
Le vecchie API hanno una data di scadenza [Odoo]:
| Quando | Cosa cambia |
|---|---|
| Odoo 19.0 | Arriva l’API JSON-2 |
| Odoo Online 19.1 (inverno 2025) | Rimosso il servizio db di XML-RPC e JSON-RPC |
| Odoo 20 (autunno 2026) | Rimosso il servizio db anche nelle installazioni non online |
| Odoo Online 21.1 (inverno 2027) | Previsti in rimozione i servizi common e object |
| Odoo 22 (autunno 2028) | Previsti in rimozione i servizi common e object |
Se oggi hai integrazioni su /xmlrpc o /jsonrpc (un e-commerce, un’app di magazzino, un vecchio connettore), mettile nell’elenco delle cose da migrare.
Cosa fa già l’AI di Odoo?
Odoo ha un’app AI con agenti configurati da un prompt di sistema, «skill» (istruzioni e strumenti) e fonti di informazione; campi AI che si compilano dal contenuto del record; azioni server in cui l’AI valuta la situazione e sceglie lo strumento da usare; agenti avviati da azioni automatiche o pianificate [Odoo]. Con Odoo 20 gli agenti possono creare e aggiornare record, anche da un PDF di istruzioni, e l’assistente risponde a domande sulla situazione contabile basandosi solo sui dati di contabilità del database; le conversazioni restano salvate fino a 30 giorni dall’ultimo messaggio [Odoo].
Sui costi: l’AI di Odoo usa crediti acquistati tramite IAP, e installare l’app sul piano Standard porta automaticamente alla proposta di passaggio al piano Custom [Odoo]. Con Odoo 20 tutte le funzioni AI richiedono crediti [Odoo]. Nelle pagine che abbiamo letto Odoo non dice quali fornitori di modelli usa.
La differenza con un assistente collegato è la stessa di altri gestionali: l’app AI lavora dentro Odoo, sui suoi record e nei suoi flussi; il server MCP porta Odoo dentro l’assistente che il personale usa già per mail, documenti e fogli di calcolo. Sono due strumenti dello stesso produttore, e possono convivere.
Cosa puoi chiedere
Quali opportunità del CRM in fase di proposta sono di clienti con fatture scadute da più di 30 giorni?
Due opportunità su 14. Prima di mandare la proposta ad Alfa Srl, conviene chiudere lo scaduto: vuoi una bozza di mail per il commerciale?
| Alfa Srl · rinnovo contratto | 3.200 € scaduti da 45 giorni |
|---|---|
| Beta Spa · nuova linea | 780 € scaduti da 38 giorni |
Fonte: Odoo CRM e Contabilità · sola lettura
Su Odoo CRM, vendite, magazzino e contabilità stanno nello stesso database: domande come questa funzionano già con il server MCP di Odoo 20, se gli strumenti esposti bastano. Il connettore aggiuntivo serve quando una parte della risposta sta fuori da Odoo.
Come colleghiamo Odoo 20 in un’azienda, in sicurezza
-
Versione, hosting e piano
Odoo Online, Odoo.sh o installazione propria; piano attivo; moduli personalizzati installati. Da qui dipende se il server MCP è disponibile e se le API si possono usare.
-
OAuth e client approvati
Usiamo OAuth per gli utenti interni e approviamo solo i client che servono (ChatGPT, Claude) con il loro documento di metadati, invece di aprire la registrazione dinamica a chiunque.
-
Strumenti esposti
Partiamo dai cinque strumenti di lettura. Ogni azione server in più la rendiamo disponibile solo se serve a una delle domande concordate, con un nome che l’assistente capisce.
-
Lato assistente
Su Claude Team ed Enterprise il connettore lo aggiunge una volta un Owner (su Team anche il Primary Owner) e ogni persona si collega con il proprio account Odoo. Su ChatGPT i connettori MCP personalizzati con scrittura richiedono Business o Enterprise.
-
Raggiungibilità
Se Odoo gira nella tua rete, l’indirizzo /mcp deve essere raggiungibile in HTTPS dal cloud dell’assistente. Per Claude, dagli indirizzi di Anthropic indicati nella sua documentazione.
-
Revoca e controllo
Ogni collegamento è una chiave nelle preferenze dell’utente: chi lascia l’azienda o cambia ruolo si revoca da lì.
Le regole lato assistente vengono dalla documentazione di Anthropic [Anthropic] [Anthropic] e di OpenAI [OpenAI · da verificare]; quelle lato Odoo dalla documentazione del server MCP [Odoo].
Limiti e cose da sapere
- Piano richiesto per il server MCP. La documentazione del server MCP non lo indica. Sappiamo che le API esterne richiedono il piano Custom e che l’app AI sul piano Standard porta alla proposta di passaggio al Custom; per il server MCP lo verifichiamo caso per caso.
- Odoo nella tua rete. Gli assistenti usati nel browser si collegano al server via internet, non dalla tua rete: un Odoo installato in azienda va esposto in modo controllato, oppure si usa un connettore che fa da tramite.
- Database molto personalizzati. Con i soli strumenti generici, l’assistente deve capire da solo quale modello e quale campo usare. Su moduli fatti su misura conviene esporre azioni server specifiche, con nomi chiari, per le domande che contano.
- Più sistemi. Il server di Odoo vede Odoo. Se la risposta richiede anche l’AS/400 della produzione o il gestionale di una consociata, serve un connettore che unisca le fonti.
- Dove passano i dati. Il nostro connettore e i suoi registri restano in UE (Francoforte); l’assistente elabora i dati che legge secondo il piano e le condizioni del suo fornitore, che possono prevedere conservazione fuori UE. I dettagli sono nella pagina sulla sicurezza.
Come lavoriamo
Se sei su Odoo 20 e ti bastano gli strumenti di serie, ti aiutiamo a configurarlo bene e ci fermiamo lì. Se sei su una versione precedente, hai molte personalizzazioni o vuoi unire Odoo ad altri sistemi, il programma pilota di 21 giorni parte da 10 domande reali concordate al primo incontro e collega i dati in sola lettura all’assistente che usi, ChatGPT o Claude. Se entro 21 giorni dall’accesso ai dati le risposte non sono corrette, ti rimborsiamo l’attivazione. Per capire meglio cos’è un server MCP c’è la guida sui server MCP; gli altri sistemi che colleghiamo sono nella pagina sui connettori AI per gestionali.