Come collegare Odoo (MCP server) a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Odoo (MCP server), inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Odoo (MCP server) + ChatGPT

Collega Claude, ChatGPT o Copilot a Odoo tramite il server MCP di Odoo stesso (Odoo AI, Odoo Online saas-19.4 e Odoo 20): cerca in qualsiasi modello, raggruppa e totalizza i record, elenca modelli e campi e, se il tuo amministratore lo consente, crea e aggiorna record. Regolato dall'utente Odoo e dagli AI Tools che il tuo amministratore espone.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ODOO_URL, ODOO_MCP_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve un database Odoo con il server MCP di Odoo stesso: Odoo Online dalla versione saas-19.4, oppure Odoo 20, con l'app AI installata. La versione è indicata in fondo a Settings, e un database con server MCP propone lo scope MCP quando crei una chiave API.

1. In Odoo clicca sul tuo avatar e apri My Preferences (o My Profile) → Security → Add API Key. Conferma la password e dai un nome alla chiave.
2. Imposta Scope su MCP e scegli in Expires per quanto tempo resta valida. Odoo mostra la chiave una sola volta, quindi copiala subito. Creala con un utente Odoo dedicato, con diritti di accesso pari a ciò che l'assistente può vedere: la chiave agisce come quell'utente.
3. Incolla la chiave in ODOO_MCP_API_KEY. Sono 40 caratteri esadecimali minuscoli; non aggiungere la parola Bearer.
4. In ODOO_URL metti l'indirizzo con cui apri Odoo, fino all'host, per esempio https://mycompany.odoo.com. Togli /odoo, /web, /mcp e la barra finale: /mcp lo aggiunge il connettore.
5. Installa il connettore ed esegui odoo_mcp_ai_tool_mcp_retrieve_initial_context: mostra l'utente collegato, il suo fuso orario, l'azienda attiva e tutte le aziende a cui può passare.

Quale connettore Odoo? Questo è per i database con il server MCP di Odoo, dove è il tuo amministratore Odoo a decidere quali tool esistono e quali modifiche sono consentite. Per Odoo 19.0 (che non ha un server MCP), per Odoo.sh o il tuo server senza server MCP, oppure se vuoi tool fissi per partner, ordini di vendita, fatture e prodotti, usa il connettore Odoo (API JSON-2, Odoo 19 e successivi). Per Odoo dalla 14 alla 18 usa Odoo 14-18 (JSON-RPC).

I tool arrivano dal tuo database: all'installazione AnythingMCP chiede al server MCP di Odoo quali tool espone. Di default sono Get Models, Get Fields, Search, Read group e MCP Retrieve initial context, tutti in sola lettura, e Odoo li esegue con i diritti dell'utente a cui appartiene la chiave. Un amministratore può esporne altri (Create Records, Update Records, menu, tool per il sito web e per le immagini) in modalità sviluppatore sotto Settings → Technical → Server Actions, spuntando Available in MCP nella scheda Usage del tool. Poi apri qui il connettore e clicca su Discover tools. La generazione di immagini consuma crediti Odoo AI.

Cosa legge: qualsiasi modello che l'utente Odoo può aprire, come contatti, ordini di vendita, fatture o prodotti. odoo_mcp_ai_tool_get_models trova il modello giusto, odoo_mcp_ai_tool_get_fields ne elenca i campi, odoo_mcp_ai_tool_search trova i record con un dominio Odoo e odoo_mcp_ai_tool_read_group li raggruppa e totalizza per giorno, settimana, mese, trimestre o anno: fatturato per mese, fatture per cliente, lead per fase.

Chiede prima di ogni modifica: all'installazione nessun tool di scrittura è attivo. Quando un amministratore attiva la creazione o la modifica dei record, l'AI ti mostra i record e i valori esatti e aspetta il tuo sì prima di scrivere.

Disattivati all'installazione: odoo_mcp_ai_tool_create_records e odoo_mcp_ai_tool_update_records. Odoo li nasconde finché un amministratore non li espone a MCP, e qui si installano anche spenti, perché creano record o cambiano valori su tutti i record che corrispondono a un dominio. Attivali tool per tool solo quando l'assistente deve davvero modificare Odoo.

Limiti: Search restituisce 50 record di default e al massimo 200 per chiamata, quindi l'AI scorre le pagine dei risultati più grandi oppure usa Read group per i totali, invece di scaricare migliaia di righe. La chiave API scade alla data impostata in Expires: a quel punto creane una nuova e incollala.

Errori comuni: 401 significa che la chiave è sbagliata, scaduta o creata senza lo scope MCP. 404 su /mcp significa che il database non ha un server MCP (è precedente a saas-19.4, o l'app AI non è installata): usa il connettore Odoo oppure Odoo 14-18 (JSON-RPC). Odoo pubblica Get Fields senza parametri, ma il tool fallisce se non riceve model_name e include_description, quindi l'AI li passa sempre entrambi.

Il connettore non aggiunge tool che il tuo Odoo non espone, non va oltre i diritti di accesso dell'utente Odoo dietro la chiave e non funziona con database senza il server MCP di Odoo.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Odoo (MCP server).
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Quanto abbiamo venduto in ordini confermati mese per mese quest'anno? Dammi il totale di ogni mese."
• "Quali clienti hanno fatture scadute non pagate, e quanto ci deve ciascuno?"
• "Trova il contatto Rossi Costruzioni e mostrami email, telefono e commerciale di riferimento."
• "Quali sono i dieci prodotti più venduti per quantità nell'ultimo trimestre?"
• "Cambia l'email del contatto Anna Weber in [email protected]. Mostrami il record prima di aggiornarlo."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse