MCP Server. AI Chats and LLM Odoo Integration v.20

Connessione in minuti

Collegate il database a Claude, ChatGPT (modalità sviluppatore) o un altro client MCP con un'autorizzazione guidata o una config pronta: niente progetto middleware e niente chiavi API da passare di mano.

Un server MCP completo

Strumenti, risorse, prompt, sessioni, streaming (SSE) e notifiche di modifica su tre versioni del protocollo: la superficie completa che un client IA serio si aspetta, non solo un elenco di azioni.

Leggere e scrivere con 31 strumenti

Cercate e leggete i record, createli e aggiornateli, eseguite azioni e lavorate con allegati, chatter, attività, report PDF, ricerca globale, KPI della dashboard e contesto aziendale.

Scrivere con una rete

Gli strumenti di scrittura restituiscono prima un'anteprima; la modifica parte solo dopo una conferma esplicita, si può annullare e scade da sola. I livelli di rischio dicono all'assistente quando avvisare.

Le vostre regole, non quelle del modello

I diritti nativi di Odoo restano in vigore. Sopra: regole di divieto per utente o gruppo, elenchi di modelli e campi consentiti, protezioni di dominio, limiti di frequenza e un giornale di audit a livello di contenuto con conservazione.

Strumenti propri senza un modulo

Puntate uno strumento a un metodo di modello esistente (per esempio sale.order / action_confirm) e l'assistente può chiamarlo. Un decoratore di una riga copre gli strumenti con i propri argomenti.

BI in linguaggio naturale

Niente altro pivot quando ti serve una risposta chiara adesso:

• Trova anomalie di margine e chiedi perché sono successe
• Confronta categorie o regioni tra periodi
• Elenca i migliori clienti inattivi e bozza i follow-up

Magazzino e supply chain

Oltre min/max statici, con IA che legge movimenti e lead time:

• Segnala i prodotti a rischio stockout prima della prossima finestra di rifornimento
• Individua lo stock morto e suggerisci bundle sensati
• Analizza i pattern di prelievo per idee sul layout di magazzino

Finanza che capisce il contesto

Abbina documenti e proietta la cassa — non solo cifre OCR:

• Confronta una fattura PDF con un ordine di acquisto e evidenzia le differenze
• Proietta i saldi a breve da fatture aperte, fatture fornitore e abitudini di pagamento
• Controlla i partner per partite IVA mancanti o non valide

CRM e personalizzazione

Unisci vendite, supporto e progetti in una sola storia cliente:

• Riassumi la salute dell'account da volume, ticket e velocità di pagamento
• Bozza offerte localizzate dalla cronologia d'acquisto reale
• Dai priorità ai nuovi lead secondo i pattern dei conti più redditizi

Routine e automazione

Se il client IA supporta le pianificazioni (ad esempio Claude), tieni Odoo nel circuito senza aprire l'app ogni mattina:

• Brief giornaliero — riassumere i nuovi ticket per priorità prima di iniziare
• Allarme stock anticipato — scansione settimanale del rischio da movimenti e vendite aperte
• Aiuti alla riconciliazione più intelligenti — ragionare sul testo bancario disordinato e lasciare alle persone solo i casi difficili

L'IA non aggira mai la sicurezza di Odoo. Ogni chiamata gira come l'utente Odoo che ha autorizzato il client — con i suoi gruppi, le regole sui record e l'accesso alle aziende. Il server aggiunge poi controlli propri, così decidete cosa possono fare gli assistenti, per chi e con quale conferma.

Prima l'anteprima, poi la conferma

• Gli strumenti di creazione, aggiornamento, eliminazione e azione rispondono con un'anteprima della modifica esatta — non è ancora scritto nulla
• L'assistente vi chiede, poi chiama confirm o cancel; un'operazione in attesa scade dopo il suo TTL
• Per strumento: Direct, Preview + Confirm o Disabled — strumenti inclusi e personalizzati

Livelli di rischio

• Ogni strumento ha un livello: low, medium, high o critical
• Gli strumenti ad alto impatto chiedono all'assistente di avvisare l'utente prima di eseguire
• Il livello è visibile nel registro degli strumenti e viene annotato in ogni voce di audit

Ruoli MCP obbligatori

• MCP Server: User — richiesto prima che un agente IA possa agire per conto di quell'utente
• MCP Server: Administrator — client, chiavi di firma, registri, regole di divieto e controllo dell'audit

Regole di diniego di sicurezza

• Bloccate strumenti scelti per utenti o gruppi (per esempio pubblicare nel chatter o eliminare record)
• Una chiamata rifiutata fallisce con un errore chiaro — la richiesta non riesce mai in silenzio

Protezioni per strumento

• I modelli consentiti e un elenco di campi tengono i dati sensibili fuori dalla portata dell'assistente
• Le protezioni di dominio limitano quali record uno strumento può toccare
• Limite di frequenza al minuto e timeout per strumento

Giornale di audit nel vostro database

• Contenuti di richiesta e risposta, stato, latenza, utente, client, sessione e contesto aziendale per ogni chiamata
• Indirizzo remoto e user agent, più un diff delle modifiche per le scritture
• Periodo di conservazione a vostra scelta; un cron pulisce le voci vecchie

Superficie completa del protocollo

• Strumenti — 31 azioni incluse con validazione dello schema JSON
• Risorse — 14 viste di sola lettura, come odoo://record/{model}/{id}, chatter, allegati, schema, dashboard
• Prompt — 6 modelli riutilizzabili con argomenti: riepilogo record, briefing del giorno, registro modifiche, guida al flusso, analisi dati
• Sessioni con streaming SSE e ripresa, notifiche di elenco modificato e tre versioni di protocollo negoziate
• Una chiamata strumento fallita riceve risposta nello stesso canale, la sessione resta attiva e il client non si riautentica

Il vostro server OAuth 2.0

• Codice di autorizzazione con token di aggiornamento e rotazione, più credenziali client per l'uso server-to-server
• Client pubblici o riservati, registrati a mano, da un documento di metadati o con registrazione dinamica
• Schermata di consenso in Odoo; durate di accesso, aggiornamento e codice in Impostazioni
• Token di accesso JWT firmati con chiavi RSA che gestite in Odoo e pubblicate tramite un endpoint JWKS

File in entrambe le direzioni

• I file piccoli viaggiano in linea; quelli grandi usano caricamenti a fasi con limiti propri di dimensione e di posti
• L'assistente può dare all'utente una pagina di caricamento che funziona con la fotocamera del telefono
• Link di download firmati con un TTL, un elenco MIME consentito, modelli consentiti per i binari e un gancio di scansione facoltativo

Sessioni multi-azienda

• L'assistente può elencare le aziende e impostare quelle attive per la sessione, come il selettore azienda
• Le scritture indicano sempre un'azienda corrente; il contesto aziendale è memorizzato in ogni voce di audit

Strumenti personalizzati senza un modulo

• Create un record strumento che punta a un metodo pubblico di modello esistente — l'assistente lo chiama sui record che nomina
• Segnate un metodo con il decoratore @mcp_tool quando ha bisogno di argomenti propri o deve essere di sola lettura
• Gli strumenti personalizzati seguono gli stessi ambiti, modi di conferma e audit di quelli inclusi

Il governo in un menu

• Utensili, Risorse, Prompt, Clienti, Sessioni, Operazioni in sospeso, Registri di audit, Regole di negazione sicurezza, Chiavi di firma
• Una ventina di impostazioni: durate dei token, TTL di sessione, heartbeat SSE, coda di notifiche, limiti di caricamento, conservazione dell'audit
• Cron di pulizia per token, sessioni, operazioni in attesa e registri