Kurz gesagt
Der much. MCP Server (technischer Name mcp_server) und der integrierte MCP-Server von Odoo in Odoo 20 (ai_mcp) ermöglichen es KI-Assistenten, Odoo-Daten über das Model Context Protocol zu lesen und zu schreiben. Das much.-Modul ergänzt eine Whitelist pro Modell mit getrennten Rechten für Erstellen, Lesen, Ändern, Löschen und Methoden, bringt Audit-Protokolle und Ratenbegrenzung mit und läuft auf Odoo 16 bis 20.
Den nativen Server von Odoo gibt es nur in Odoo 20. Jedes freigegebene Tool funktioniert für jedes Modell, auf das der Nutzer zugreifen kann, und Odoo dokumentiert die Einrichtung für lokale Agenten wie Claude Code, Codex und Antigravity. Für Unternehmen, die Claude.ai, ChatGPT oder Microsoft Copilot mit Odoo verbinden und genau steuern möchten, worauf die KI zugreifen darf, ist der much. MCP Server heute die bessere Wahl.
Vergleich auf einen Blick
| Kategorie | much. MCP Server | Nativer MCP von Odoo 20 (ai_mcp) |
|---|---|---|
| Odoo-Versionen | 16, 17, 18, 19, 20 | Nur 20 |
| Edition | Community und Enterprise | Erfordert die KI-App von Odoo (Enterprise) |
| Hosting | Odoo Online, Odoo.sh, On-Premises | Odoo Online, Odoo.sh, On-Premises |
| Preis | Kostenlos | In Odoo Enterprise enthalten |
| Konfiguration | Eine Einstellungsseite in Odoo (Einstellungen > MCP Server) | Verteilt auf Einstellungen > Integrationen, Serveraktionen und OAuth-Clients (Entwicklermodus) |
| Dokumentierte KI-Clients | Claude.ai, Claude Desktop, ChatGPT, M365 Copilot, Copilot Studio, Perplexity, Mistral Le Chat, Gemini Enterprise, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI | Claude Code, Claude Desktop, Codex, Antigravity, Grok |
| Lokale Software erforderlich | Keine für Cloud-Chats | Node.js und mcp-remote für Setups mit API-Schlüssel |
| Modell-Whitelist | Standardmäßig gesperrt, jedes Modell wird von einem Admin freigegeben | Keine, jedes Modell, auf das der Nutzer zugreifen kann |
| Rechte pro Modell | Lesen, Erstellen, Ändern und Löschen getrennt einstellbar | Rechte pro Tool, gültig für alle Modelle |
| Schaltflächen und Methoden | Opt-in pro Modell, nur öffentliche Methoden | Nur über eigene Serveraktionen |
| Reine Lesesitzungen | Serverseitig erzwungen | Readonly-Flag ist nur ein Hinweis an den Client |
| Audit-Protokoll | Aufrufe, Ablehnungen, Anmeldeversuche (standardmäßig 30 Tage) | Nicht dokumentiert |
| Ratenbegrenzung | Pro Nutzer, konfigurierbar | Nicht dokumentiert |
| Token-Steuerung | Intelligente Standardfelder, Datensatzlimits, Paginierung, Dateien bei Bedarf | Felder wählt das Modell pro Aufruf, keine dokumentierten Limits |
| Anhänge | Liest PDF-, Office- und Bilddateien, lädt Dateien hoch | Keine Tools für Anhänge |
| Datensätze löschen | Opt-in pro Modell | Kein Tool zum Löschen |
| UI-Navigation und Website-Bearbeitung | Nein | Ja |
| Verbreitung | Rund 10.000 Odoo-Datenbanken | Neu mit Odoo 20 |
Einrichtung und unterstützte KI-Clients
Der much. MCP Server wird in vier Schritten in Odoo eingerichtet und funktioniert danach in Browser-Chats ganz ohne lokale Software:
- Installieren Sie das Modul aus dem Odoo App Store.
- Aktivieren Sie es unter Einstellungen > MCP Server und geben Sie die Modelle frei, die die KI nutzen darf.
- Fügen Sie Nutzer zur Gruppe „MCP User“ hinzu.
- Fügen Sie die /mcp-URL im KI-Client ein und melden Sie sich per OAuth an.
much. dokumentiert funktionierende Setups für Claude.ai, Claude Desktop, ChatGPT, Microsoft 365 Copilot, Copilot Studio, Perplexity, Mistral Le Chat und Gemini Enterprise sowie für Coding-Agenten wie Claude Code, Cursor und Windsurf. Clients, die nur stdio unterstützen, verbinden sich über die Open-Source-Bridge mcp-server-odoo, mit denselben Berechtigungen und demselben Audit-Protokoll.
Die Odoo-Dokumentation zum nativen Server nennt einen MCP-kompatiblen Agenten wie Claude Code, Antigravity oder Codex als Voraussetzung. Die Verbindung per API-Schlüssel erfordert Node.js und das Paket mcp-remote auf dem Rechner des Nutzers, konfiguriert über eine JSON-Datei oder einen Terminal-Befehl. OAuth funktioniert ohne diese Bridge, allerdings müssen Admins zuerst jeden KI-Client anhand seiner Metadaten-URL freigeben oder die Dynamic Client Registration für alle Clients öffnen.
Nach dem Verbinden muss ein Admin zusätzlich den Entwicklermodus aktivieren und bei jeder Serveraktion, die über die fünf standardmäßigen Lese-Tools hinausgeht, „Available in MCP“ anhaken. Zum Schreiben von Daten müssen mindestens die Tools Create Records und Update Records von Hand freigegeben werden.
Berechtigungen und Zugriffskontrolle
Beide Server führen jeden Aufruf als angemeldeter Odoo-Nutzer aus, sodass die üblichen Zugriffsrechte und Datensatzregeln gelten. Der Unterschied liegt darin, was ein Admin darüber hinaus einschränken kann.
Der much. MCP Server arbeitet mit zwei Ebenen. Ebene eins sind die eigenen Odoo-Rechte des Nutzers. Ebene zwei ist eine MCP-Whitelist, die standardmäßig geschlossen ist: Ein Admin gibt jedes Modell einzeln frei und legt Lesen, Erstellen, Ändern und Löschen pro Modell fest. Der Aufruf von Geschäftsmethoden, also dem Code hinter Schaltflächen wie „Bestätigen“ in einem Verkaufsauftrag, ist standardmäßig deaktiviert und wird pro Modell freigeschaltet. Private Methoden und Methoden für den direkten Datenzugriff werden immer abgelehnt.
In der Praxis kann ein Vertriebsteam der KI erlauben, CRM-Leads zu lesen und deren Phase zu ändern, Produkte zu lesen und Angebote zu bestätigen, während Rechnungen, Gehaltsabrechnungen und HR-Datensätze für die KI unsichtbar bleiben, selbst bei Nutzern, die sie in Odoo sehen.
Der native Server von Odoo hat eine Ebene. Tools werden pro Serveraktion freigegeben, und jedes Tool funktioniert für jedes Modell, das der Nutzer erreichen kann. Sobald „Update Records“ verfügbar ist, kann die KI jeden Datensatz ändern, den der Nutzer bearbeiten darf, und das Tool akzeptiert eine Domain, sodass ein einziger Aufruf jeden Datensatz ändern kann, der einem Filter entspricht. Es gibt keine Möglichkeit, die KI von der Buchhaltung fernzuhalten, während derselbe Nutzer im Browser in der Buchhaltung arbeitet.
Sicherheitsfunktionen
Der much. MCP Server dokumentiert zwölf Sicherheitskontrollen, die über die Nutzerrechte hinausgehen. Die Odoo-Dokumentation zum nativen Server behandelt die Freigabe von OAuth-Clients, Geltungsbereich und Ablauf von API-Schlüsseln sowie das Widerrufen von Schlüsseln.
- Reine Lesesitzungen: Der Nutzer kann ein Zustimmungsfeld anhaken, das die Sitzung auf Lesen beschränkt. Schreib-Tools werden ausgeblendet und serverseitig abgelehnt. Im Server von Odoo teilt „Readonly Tool“ dem Client lediglich mit, dass er die Nachfrage nach einer Freigabe überspringen darf.
- Audit-Protokoll: Jeder Aufruf, jeder abgelehnte Aufruf und jeder Anmeldeversuch wird protokolliert und standardmäßig 30 Tage aufbewahrt.
- Ratenbegrenzung: Anfragelimits pro Nutzer, beantwortet mit HTTP 429.
- Saubere Fehlermeldungen: Tracebacks und SQL erreichen den KI-Client nie.
- Origin-Allowlist: optionale Sperre für Browser-Anfragen von unbekannten Websites.
- Token-Handling: OAuth 2.1 mit PKCE, eine Stunde gültige Access-Tokens, rotierende Refresh-Tokens und Widerruf der gesamten Token-Familie, wenn ein Refresh-Token wiederverwendet wird.
- Token-Bindung: Tokens funktionieren nur für den /mcp-Endpunkt (RFC 8707).
- Gehashte Speicherung: Tokens werden als Hashes in der Datenbank gespeichert.
- Widerruf: Einzelne Tokens oder alle Tokens eines Clients lassen sich widerrufen.
- Registrierungslimits: Die dynamische Client-Registrierung ist pro IP ratenbegrenzt.
- Reine MCP-API-Schlüssel: Auf MCP beschränkte Schlüssel können die allgemeine Odoo-API nicht aufrufen.
- Zugriffsgruppen: „MCP User“ ist für jeden Zugriff erforderlich, „MCP Administrator“ für die Konfiguration.
Für Unternehmen mit Audits nach ISO 27001, SOC 2 oder DSGVO sind das Audit-Protokoll und die Whitelist pro Modell meist die entscheidenden Punkte. Sie zeigen, wer der KI was erlaubt hat und für welche Daten.
Token-Effizienz und Umgang mit Daten
Jeder Datensatz, den ein MCP-Server zurückgibt, wird vom Sprachmodell gelesen und als Tokens abgerechnet. Der much. MCP Server ist darauf ausgelegt, diese Antworten klein zu halten:
- Intelligente Feldauswahl: Fragt die KI Datensätze an, ohne Felder zu nennen, liefert der Server einen kompakten Satz relevanter Felder.
- Datensatzlimits: Admins legen eine Standard- und eine Höchstzahl von Datensätzen pro Aufruf fest, mit Paginierung für größere Mengen.
- Dateien bei Bedarf: Bilder und Anhänge werden nicht als base64 eingebettet. Die KI ruft sie nur bei Bedarf über MCP-Ressourcen ab.
- Kontext im Handshake: Nutzer, Zeitzone und Unternehmenskontext werden einmalig beim Sitzungsstart übermittelt.
- Batch-Schreibvorgänge: Das Erstellen oder Ändern vieler Datensätze ist ein einziger atomarer Aufruf.
Das native Search-Tool von Odoo gibt die Felder zurück, die das Modell für eine bestimmte Domain anfordert, ähnlich wie die externe Odoo-API. Die Odoo-Dokumentation nennt weder einen Standard-Feldsatz noch eine Datensatzobergrenze oder Paginierung. Bei großen Modellen wie sale.order oder account.move kann eine einzige breite Suche einen großen Teil des Kontextfensters füllen, was Antworten verlangsamt und die Kosten pro Frage erhöht.
Tools und Funktionsumfang
Der much. MCP Server stellt 17 Tools für die Arbeit mit Geschäftsdaten bereit. Der native Server von Odoo listet 27 Tools auf, von denen 16 die Benutzeroberfläche und den Website-Builder von Odoo steuern.
| Funktion | much. MCP Server | Nativer MCP von Odoo 20 |
|---|---|---|
| Suchen, lesen, gruppieren und aggregieren | Ja | Ja |
| Erstellen und ändern | Einzeln und als atomarer Batch | Create Records, Update Records per Domain |
| Löschen | Ja, Opt-in pro Modell | Nein |
| Geschäftsmethoden ausführen (Schaltflächen) | Ja, Opt-in pro Modell | Nur über eigene Serveraktionen |
| Anhänge lesen | Textextraktion aus PDF, Word und Excel, Bilder, Download-Links | Nein |
| Anhänge hochladen | Ja | Nein |
| Im Chatter posten | Ja | Nein |
| Eigene Tools aus Serveraktionen | Ja, mit JSON-Eingabeschema, Zugriffsgruppen, Rollback bei Fehlern und Audit | Ja, Serveraktionen mit der Markierung „Available in MCP“ |
| Listen-, Kanban-, Pivot- und Diagrammansichten öffnen | Nein | Ja |
| Website-Seiten und CSS bearbeiten | Nein | Ja |
| Bilder generieren, im Web suchen | Nein | Ja |
Das Lesen von Anhängen ist wichtiger, als es scheint. Die KI zu bitten, die PDF-Rechnung eines Lieferanten mit der Bestellung abzugleichen oder den Vertrag zusammenzufassen, der bei einem Kunden angehängt ist, funktioniert nur, wenn der Server die Datei öffnen kann.
Versionen, Lizenz und Lock-in
Der much. MCP Server ist kostenlos und Open Source, läuft auf Odoo Community und Enterprise und ist kompatibel mit Odoo 16, 17, 18, 19 und 20. Unternehmen mit älteren Versionen erhalten MCP-Zugriff sofort, ohne Upgrade-Projekt.
Der native Server von Odoo wird mit Odoo 20 als Teil der KI-App ausgeliefert. Wer ihn nutzt, braucht Odoo 20 Enterprise. Odoo hat in der Vergangenheit immer wieder Funktionen in kostenpflichtige Dienste verlagert: Die integrierten KI-, OCR- und SMS-Funktionen laufen über vorausbezahlte IAP-Guthaben, die Odoo verkauft. Mehrere native MCP-Tools, etwa Bildgenerierung und Websuche, hängen von den KI-Diensten von Odoo ab.
Ein Open-Source-Modul hält die MCP-Ebene unabhängig von den Preisentscheidungen von Odoo SA. Jeder Odoo Partner oder interne Entwickler kann den Code lesen, prüfen und erweitern.
Ein weiterer Punkt für Odoo-20-Nutzer: Odoo entfernt im selben Release die XML-RPC- und JSON-RPC-Endpunkte. Integrationen, die auf diesen APIs aufbauen, müssen ohnehin überarbeitet werden. Das ist ein guter Zeitpunkt, sich für die MCP-Ebene zu entscheiden.
Wo der native MCP von Odoo stärker ist
Der Server von Odoo ist im Vorteil, wenn die KI die Odoo-Oberfläche für den Nutzer bedienen soll. Seine Navigations-Tools öffnen Listen-, Kanban-, Pivot- und Diagrammansichten mit Filtern und Gruppierungen, passen die aktuelle Suche an und zeigen Vorschaukarten für Datensätze im Odoo-Chat an. Für Prompts wie „Filtere diese Ansicht auf mein Team und gruppiere nach Monat“ gibt es im much.-Modul keine Entsprechung.
Er deckt auch die Arbeit an der Website ab: eigenes CSS lesen und schreiben, Snippets einfügen, das HTML von Seiten bearbeiten, Unsplash-Fotos finden und Bilder generieren.
Schließlich wird er von Odoo SA gepflegt und benötigt kein zusätzliches Modul. Für einen Odoo-20-Enterprise-Kunden, der vor allem KI-Unterstützung in der Odoo-Oberfläche und im Website-Builder möchte, ist das ein nachvollziehbarer Grund, dort zu starten.
Welchen Server sollten Sie wählen?
- Sie nutzen Odoo 16 bis 19: Der much. MCP Server ist der einzige der beiden, der Ihnen zur Verfügung steht.
- Sie nutzen Odoo Community: der much. MCP Server, da der native Server Enterprise voraussetzt.
- Ihr Team arbeitet im Browser mit Claude.ai, ChatGPT oder Microsoft Copilot: der much. MCP Server, mit dokumentierten Setups für diese Clients.
- Die KI soll einige Apps sehen, andere aber nicht: der much. MCP Server, denn nur er beschränkt den Zugriff pro Modell und pro Operation.
- Sie brauchen einen Audit-Trail der KI-Aktionen: der much. MCP Server.
- Sie nutzen Odoo 20 Enterprise und möchten, dass die KI Odoo-Ansichten und den Website-Builder steuert: der native Server von Odoo.
Beide können auf derselben Odoo-20-Datenbank laufen. Ein praktikables Setup ist das much.-Modul für die Arbeit mit Daten aus externen KI-Clients, kombiniert mit den nativen Tools von Odoo für die Navigation in der App.
Häufige Fragen (FAQ)
Hat Odoo 20 einen integrierten MCP-Server?
Ja. Odoo 20 liefert das Modul ai_mcp als Teil seiner KI-App aus. Es stellt Odoo-Serveraktionen als MCP-Tools unter https://<ihre-datenbank>/mcp bereit, mit Anmeldung per OAuth oder API-Schlüssel.
Kann ich MCP mit Odoo 17, 18 oder 19 nutzen?
Ja, mit dem much. MCP Server aus dem Odoo App Store. Er funktioniert mit Odoo 16 bis 20. Der native Server ist nur in Odoo 20 enthalten.
Kann ich Claude.ai oder ChatGPT im Browser mit Odoo verbinden?
Ja. Der much. MCP Server dokumentiert OAuth-Setups für Claude.ai, ChatGPT, Microsoft 365 Copilot, Perplexity, Mistral Le Chat und Gemini Enterprise. Sie fügen die /mcp-URL ein und melden sich an.
Kann ich verhindern, dass die KI Buchhaltungs- oder HR-Daten sieht?
Mit dem much. MCP Server ja: Nehmen Sie diese Modelle einfach nicht in die Whitelist auf. Beim nativen Server von Odoo sieht die KI alles, was der Nutzer sehen kann. Sie bräuchten also einen separaten Nutzer mit weniger Rechten.
Ist der much. MCP Server kostenlos?
Ja. Er ist kostenlos und Open Source, für Odoo Community und Enterprise.
Wer entwickelt den much. MCP Server?
much. Consulting, ein Odoo Gold Partner mit Büros in Deutschland, Portugal und Großbritannien. Das Modul wird in rund 10.000 Odoo-Datenbanken eingesetzt.
