Zum Inhalt springen

KI-Agent an Odoo anbinden: External API, MCP und Berechtigungen

Odoo bündelt Vertrieb, Einkauf, Lager, Buchhaltung und Service in einer Datenbank. Für einen KI-Agenten ist das ein Vorteil: Angebot, Kunde, Lagerbestand und offene Rechnung liegen im selben Datenmodell und sind über eine einzige Schnittstelle erreichbar. Dieser Leitfaden zeigt, welche Schnittstelle Sie je nach Odoo-Version nutzen, wie das Datenmodell aufgebaut ist und wie Sie den Agenten über Berechtigungen sicher begrenzen. Alle Angaben beziehen sich auf die Odoo-19-Dokumentation, Stand November 2026.

Was bedeutet es, einen KI-Agenten an Odoo anzubinden?

Einen KI-Agenten an Odoo anzubinden heißt, dem Sprachmodell Werkzeuge zu geben, mit denen es Odoo-Datensätze suchen, lesen und in klar begrenzten Fällen anlegen oder ändern kann. Technisch sind das Aufrufe von Methoden auf Odoo-Modellen über die External API, ausgeführt im Namen eines eigenen Benutzers mit eigenen Rechten.

Typische Aufgaben sind:

  • Angebotsentwurf: Der Agent liest Kunde, Preisliste und Artikel und legt einen Angebotsentwurf (sale.order im Status Entwurf) an, den ein Mensch freigibt.
  • Auskunft im Service: Eine Kundenanfrage „Wo ist meine Lieferung?“ beantwortet der Agent aus Auftrag und Lieferschein, ohne dass jemand im Lager nachsieht.
  • Vorqualifizierung: Eingehende E-Mails werden einem Kontakt zugeordnet, ein CRM-Lead wird angelegt und mit den wichtigsten Angaben vorbefüllt.
  • Zusammenfassungen: Offene Posten eines Kunden, letzte Tickets und laufende Aufträge als Briefing vor einem Gespräch.

Die allgemeinen Muster für solche Anbindungen, also Lesen vor Schreiben, Freigabeschritte und Protokollierung, beschreibt der Grundlagen-Leitfaden zur Anbindung von KI-Agenten an Unternehmenssysteme. Dieser Artikel konzentriert sich darauf, was bei Odoo konkret anders ist.

Welche Schnittstellen bietet Odoo für KI-Agenten?

Odoo bietet seit Version 19 die External JSON-2 API unter /json/2/<model>/<method> mit API-Key als Bearer-Token. Die älteren Schnittstellen XML-RPC und JSON-RPC funktionieren noch, sind aber laut Odoo-Dokumentation zur RPC-API seit 19.0 veraltet und für Odoo 22 (Herbst 2028) zur Entfernung vorgesehen.

JSON-2 API (Odoo 19 und neuer)

Laut Referenz der JSON-2 API schicken Sie ein JSON-Objekt per POST an /json/2/<model>/<method>. Der Header Authorization enthält bearer und den API-Key, der optionale Header X-Odoo-Database wählt die Datenbank, wenn ein Server mehrere betreibt. Im Body stehen die Datensatz-IDs, ein optionaler context und die Parameter der Methode. Fehler kommen als HTTP-Status 4xx oder 5xx mit einem JSON-Objekt, das Name und Meldung der Python-Ausnahme enthält.

Für einen Agenten ist dieses Format angenehm: Eine Methode, ein Aufruf, eine JSON-Antwort. Das Ergebnis lässt sich direkt als Werkzeugantwort an das Modell zurückgeben.

XML-RPC und JSON-RPC (bis Odoo 18, in 19 veraltet)

Die ältere RPC-API stellt die Dienste common, db und object bereit. Sie melden sich mit authenticate an, erhalten eine Benutzer-ID und rufen dann über execute_kw Methoden auf Modellen auf, wobei bei jedem Aufruf Datenbank, Benutzer-ID und Passwort oder API-Key mitgeschickt werden. Laut Dokumentation ersetzt man bei der RPC-API das Passwort einfach durch den API-Key; der Login bleibt.

Betreiben Sie Odoo 17 oder 18, ist RPC Ihr Weg. Planen Sie aber so, dass der Zugriff hinter einer eigenen Funktion liegt, damit der spätere Wechsel auf JSON-2 nur diese Schicht betrifft. Odoo nennt neben Odoo 22 auch Odoo Online 21.1 (Winter 2027) als Termin für die Entfernung — wer Odoo Online nutzt, hat also weniger Zeit.

Die eigene Dokumentation jeder Datenbank

Welche Modelle, Felder und Methoden es gibt, hängt von den installierten Apps und Erweiterungen ab. Die JSON-2-Referenz verweist dafür auf die Seite /doc der jeweiligen Datenbank, die das konkret verfügbare Schema zeigt. Diese Seite ist beim Entwurf der Werkzeuge hilfreicher als jedes allgemeine Tutorial, weil sie Ihre eigenen Zusatzfelder enthält.

Wie ist das Odoo-Datenmodell aufgebaut?

Odoo organisiert alle Daten in Modellen mit technischen Namen wie res.partner (Kontakte), sale.order (Aufträge und Angebote) oder product.product (Artikelvarianten). Jedes Modell hat Felder und Methoden. Ein Agent arbeitet fast immer mit den Standardmethoden des ORM: search, read, search_read, create und write.

Für die Werkzeuge des Agenten heißt das:

  • Suchen mit Domains: Filter werden als Liste von Bedingungen übergeben, etwa [["is_company", "=", true], ["name", "ilike", "%meier%"]]. Das Modell muss diese Syntax nicht selbst bauen — besser ist ein Werkzeug „Kunde suchen“ mit dem Parameter name, das die Domain im Code erzeugt.
  • Felder ausdrücklich nennen: Ohne fields liefert read sehr viele Felder. Das kostet Kontext und kann Daten preisgeben, die der Agent nicht braucht. Geben Sie pro Werkzeug eine feste Feldliste vor.
  • Relationen auflösen: Viele Felder verweisen auf andere Modelle (partner_id, order_line). Ein gutes Werkzeug liefert die Angaben, die das Modell braucht, in einer flachen Struktur zurück, statt dem Modell rohe ID-Listen zu überlassen.
  • Geschäftsmethoden statt Feldänderungen: Viele Modelle haben Methoden mit dem Präfix action_, etwa action_confirm auf sale.order. Sie prüfen Geschäftsregeln, bevor sie den Status ändern. Ein Agent sollte diese Methoden nutzen, statt den Status per write direkt zu setzen.

Ein minimales Lesewerkzeug in Python, nach dem Schema der Odoo-19-Dokumentation:

import os
import requests

BASE_URL = os.environ["ODOO_URL"] + "/json/2"
HEADERS = {
    "Authorization": f"bearer {os.environ['ODOO_API_KEY']}",
    "X-Odoo-Database": os.environ["ODOO_DB"],
    "User-Agent": "ki-agent-odoo",
}

def kunden_suchen(name: str, limit: int = 5) -> list[dict]:
    """Werkzeug für den Agenten: Firmenkontakte nach Namen suchen."""
    res = requests.post(
        f"{BASE_URL}/res.partner/search_read",
        headers=HEADERS,
        json={
            "domain": [["is_company", "=", True], ["name", "ilike", name]],
            "fields": ["name", "city", "email"],
            "limit": limit,
        },
        timeout=30,
    )
    res.raise_for_status()
    return res.json()

Der Code nutzt search_read statt getrennter search- und read-Aufrufe. Das hat einen Grund, der im Abschnitt zu Transaktionen erklärt wird.

Wie begrenzen Access Rights und Record Rules den Agenten?

Odoo prüft jeden Aufruf der External API gegen die Rechte des Benutzers, dem der API-Key gehört: Access Rights entscheiden, ob er ein Modell überhaupt lesen, anlegen, ändern oder löschen darf, Record Rules schränken das auf bestimmte Datensätze ein, Feldgruppen auf bestimmte Felder. Der Agent bekommt deshalb einen eigenen Bot-Benutzer mit genau den Rechten, die er braucht.

Access Rights: welche Modelle, welche Operationen

Access Rights (ir.model.access) vergeben pro Modell und Gruppe die vier Rechte Lesen, Anlegen, Ändern und Löschen. Laut Odoo-Sicherheitsreferenz sind sie additiv: Ein Benutzer erhält die Vereinigung der Rechte aller seiner Gruppen. Gibt es für eine Operation kein passendes Recht, ist sie verboten.

Für einen Agenten folgt daraus: Legen Sie eine eigene Gruppe an, etwa „KI-Agent Vertrieb“, und geben Sie dem Bot-Benutzer nur diese Gruppe. Jede zusätzliche Standardgruppe erweitert seine Rechte, weil Rechte sich addieren. Gruppen und technische Rechte bearbeiten Sie laut Odoo-Doku zu Access Rights im Entwicklermodus.

Record Rules: welche Datensätze

Record Rules (ir.rule) sind Bedingungen in Domain-Syntax, die pro Datensatz geprüft werden, nachdem die Access Rights den Zugriff erlaubt haben. Die Sicherheitsreferenz beschreibt zwei Arten, die sich unterschiedlich verhalten:

  • Globale Regeln (ohne Gruppe) schneiden sich: Gelten zwei, müssen beide erfüllt sein. Jede weitere globale Regel schränkt also weiter ein.
  • Gruppenregeln vereinigen sich: Gelten zwei, genügt eine. Sie können Zugriff erweitern, aber nie über die Grenzen der globalen Regeln hinaus.

Ein Beispiel: Eine Gruppenregel mit der Domain [("team_id", "=", 3)] auf sale.order beschränkt den Agenten auf die Aufträge eines Vertriebsteams. Wichtig ist der Hinweis der Dokumentation, dass Record Rules standardmäßig erlauben: Greift keine Regel, entscheidet allein das Access Right.

Feldzugriff und öffentliche Methoden

Felder können über das Attribut groups auf bestimmte Gruppen beschränkt sein. Fehlt dem Benutzer die Gruppe, verschwindet das Feld aus fields_get(), und ein ausdrücklicher Lese- oder Schreibversuch führt zu einem Zugriffsfehler.

Für Agenten besonders wichtig ist eine Warnung aus derselben Referenz: Jede öffentliche Methode, also jede, deren Name nicht mit _ beginnt, kann per RPC mit beliebigen Parametern aufgerufen werden. Ein generisches Werkzeug „beliebige Methode ausführen“ gibt dem Modell damit Zugriff auf alles, was der Bot-Benutzer darf. Erlauben Sie stattdessen eine feste Liste von Modell-Methoden-Paaren.

Ein eigener Bot-Benutzer

Die JSON-2-Referenz empfiehlt für dauerhafte Integrationen ausdrücklich eigene Bot-Benutzer: Sie bekommen nur die nötigen Rechte, ihr Passwort kann leer bleiben, damit die Anmeldung mit Benutzername und Passwort nicht möglich ist, und die Änderungsprotokolle in Odoo zeigen den Bot statt einer Person. Das ist auch für die Nachvollziehbarkeit wichtig: Sie sehen in jedem Datensatz, ob ein Mensch oder der Agent ihn geändert hat.

Was ist bei Transaktionen und API-Keys zu beachten?

Jeder Aufruf der JSON-2 API läuft laut Dokumentation in einer eigenen SQL-Transaktion; mehrere Aufrufe lassen sich nicht zu einer Transaktion verketten. API-Keys haben eine Laufzeit von höchstens drei Monaten und müssen rotiert werden. Beides beeinflusst, wie Sie die Werkzeuge des Agenten schneiden.

Ein Werkzeug, eine Transaktion

Ein Agent neigt dazu, Schritte einzeln auszuführen: Auftrag anlegen, dann Positionen ergänzen, dann bestätigen. Bricht der dritte Schritt ab, bleibt ein halber Auftrag zurück. Die Odoo-Dokumentation rät, immer eine einzige Methode aufzurufen, die alle zusammengehörigen Operationen in einer Transaktion ausführt. search_read ist dafür das einfachste Beispiel, action_confirm ein fachliches. Gibt es keine passende Methode, empfiehlt Odoo, sie in einem eigenen Modul anzulegen.

Für Agenten ist das eine gute Regel: Fachliche Werkzeuge wie „Angebotsentwurf mit Positionen anlegen“ gehören als eine serverseitige Methode in ein kleines Odoo-Modul, nicht als Folge von fünf API-Aufrufen in den Prompt.

API-Keys verwalten

API-Keys legen Sie unter Einstellungen des Benutzers, Bereich Account-Sicherheit, an. Beschreibung und Laufzeit sind Pflicht; Schlüssel mit mehr als drei Monaten Laufzeit sind nicht möglich, der Wert wird nur einmal angezeigt. Ab Odoo 19 lassen sich Schlüssel zudem per API erzeugen (res.users.apikeys.generate) und widerrufen (res.users.apikeys.revoke), was eine automatische Rotation erlaubt. Die Dokumentation empfiehlt einen eigenen Schlüssel pro Dienst, damit Sie einzelne Integrationen gezielt sperren können.

Wie passt MCP zu Odoo?

Das Model Context Protocol (MCP) ist ein offener Standard, über den ein KI-Client Werkzeuge eines Servers aufruft. Ein Odoo-MCP-Server übersetzt Werkzeuge wie „Datensätze suchen“ in Aufrufe der External API. Er ersetzt die API also nicht, sondern sitzt davor — die Rechte des Bot-Benutzers gelten weiterhin.

Stand November 2026 haben wir keinen MCP-Server gefunden, den Odoo selbst veröffentlicht. Es gibt mehrere Community-Projekte, zum Beispiel twtrubiks/odoo19-mcp-server, das unter Apache-2.0 steht und auf die JSON-2 API setzt. Es bietet Lesewerkzeuge wie search_records und read_records, Schreibwerkzeuge wie create_record, einen Modus ohne Schreibwerkzeuge und optional einen eigenen API-Key pro Client, sodass Odoo-Rechte und Protokolle je Benutzer greifen.

Zwei Varianten sind sinnvoll:

  • Generischer MCP-Server: schnell eingerichtet, gut für Erkundung und Auswertungen im Nur-Lese-Modus. Nachteil: Werkzeuge wie „beliebige Methode ausführen“ sind sehr breit, siehe den Abschnitt zu öffentlichen Methoden.
  • Eigener, fachlicher MCP-Server: wenige Werkzeuge mit klaren Namen und festen Feldlisten, etwa angebotsentwurf_anlegen oder lieferstatus_abfragen. Mehr Aufwand, aber das Modell kann nur tun, was Sie vorgesehen haben.

Wie MCP-Server grundsätzlich aufgebaut sind und wann sie sich gegenüber direkten API-Werkzeugen lohnen, erklärt der Leitfaden MCP-Server für KI-Agenten.

Was ist bei Community, Enterprise und Odoo Online anders?

Die External API gehört zum Odoo-Kern und ist damit in Community und Enterprise vorhanden. Unterschiede entstehen bei Betrieb und Abo: Bei den Abo-Plänen von Odoo ist der API-Zugriff laut Dokumentation nur im Custom-Plan enthalten. Zudem hängen die verfügbaren Modelle davon ab, welche Apps installiert sind.

  • Community: steht laut Lizenzdatei im Odoo-Repository unter LGPLv3 und wird typischerweise selbst betrieben. Sie haben vollen Zugriff auf Server, Module und Protokolle — also auch die Möglichkeit, eigene serverseitige Methoden für den Agenten zu installieren.
  • Enterprise: baut auf Community auf und ergänzt lizenzierte Apps. Für den Agenten heißt das vor allem: mehr Modelle, etwa aus Apps, die es nur in Enterprise gibt. Die Anbindung selbst funktioniert gleich.
  • Abo-Pläne: Die Odoo-Preisseite nennt „External API“ als Bestandteil des Custom-Plans, ebenso Odoo.sh und On-Premise-Betrieb. Laut JSON-2-Referenz ist der API-Zugriff in One App Free und Standard nicht verfügbar. Prüfen Sie Ihren Plan, bevor Sie mit der Umsetzung beginnen.
  • Odoo Online: Klären Sie vorab, ob Sie in Ihrer Umgebung eigene Python-Module installieren können. Geht das nicht, ist der Rat, zusammengehörige Schritte in einer serverseitigen Methode zu bündeln, schwerer umzusetzen, und Sie sind stärker auf vorhandene action_-Methoden angewiesen. Außerdem gilt für Odoo Online der frühere Termin zur Entfernung von XML-RPC und JSON-RPC.

Im Vergleich zu großen ERP-Systemen ist der Einstieg bei Odoo kleiner: eine Schnittstelle, ein Rechtemodell, ein Datenmodell. Bei SAP S/4HANA dagegen wählen Sie zwischen OData-Services, BAPIs und Integrationsplattformen, wie der Leitfaden KI-Agent an SAP S/4HANA anbinden zeigt.

Wie gehen Sie bei der Anbindung Schritt für Schritt vor?

Beginnen Sie mit einem Lesefall, einem Bot-Benutzer mit eng geschnittener Gruppe und wenigen Werkzeugen mit festen Feldlisten. Schreibzugriffe kommen erst dazu, wenn das Lesen zuverlässig funktioniert, und dann zunächst nur als Entwurf, den ein Mensch bestätigt.

  1. Version und Plan klären: Odoo 19 oder älter? Abo-Plan mit External API? Davon hängen JSON-2 oder RPC und die Möglichkeit eigener Module ab.
  2. Prozess wählen: ein konkreter Ablauf, etwa Lieferauskunft oder Angebotsentwurf, mit klarem Ergebnis.
  3. Modelle und Felder bestimmen: über die /doc-Seite der Datenbank, inklusive eigener Zusatzfelder.
  4. Bot-Benutzer und Gruppe anlegen: nur die nötigen Access Rights, Record Rules für die erlaubten Datensätze, leeres Passwort, eigener API-Key mit kurzer Laufzeit.
  5. Werkzeuge bauen: wenige, fachlich benannte Funktionen; mehrteilige Schreibvorgänge als eine serverseitige Methode.
  6. Testen in einer Kopie: Odoo bietet das Duplizieren von Datenbanken an; testen Sie dort mit echten Datenstrukturen, nicht in der Produktivdatenbank.
  7. Freigabe einbauen: Der Agent legt Entwürfe an, ein Mensch bestätigt. Erst wenn das über Wochen sauber läuft, kommen direkte Bestätigungen in Frage.
  8. Rotation und Überwachung: API-Key-Rotation automatisieren, Aufrufe protokollieren, Fehlerquoten beobachten.

Wo liegen Grenzen und Risiken?

Die größten Risiken bei einer Odoo-Anbindung sind zu breite Rechte, verkettete Aufrufe ohne gemeinsame Transaktion und Werkzeuge, die dem Modell beliebige Methoden öffnen. Hinzu kommen Fehlannahmen des Modells über Felder und Status, die eine Prüfung im Code abfangen muss.

  • Administratorrechte: Ein Agent mit dem API-Key eines Administrators kann alles, was der Administrator kann. Das ist der häufigste und gefährlichste Fehler.
  • Halbfertige Vorgänge: Mehrere einzelne Aufrufe können zwischen den Schritten von anderen Transaktionen überholt werden. Die Doku nennt Reservierungen und Zahlungen ausdrücklich als heikle Fälle.
  • Mehrere globale Record Rules: Laut Sicherheitsreferenz können sich nicht überlappende globale Regeln gegenseitig aufheben und jeden Zugriff sperren. Testen Sie Regeln mit dem Bot-Benutzer, nicht als Administrator.
  • Erfundene Felder: Das Modell kennt Odoo aus dem Training, aber nicht Ihre Datenbank. Feste Feldlisten und eine Prüfung der Parameter im Werkzeug verhindern Aufrufe mit Feldern, die es nicht gibt.
  • Auslaufende Schnittstellen: Eine neue RPC-Anbindung an Odoo 19 läuft auf eine angekündigte Entfernung zu.
  • Personenbezogene Daten: Kontakte, Mitarbeiterdaten und Rechnungen sind personenbezogen. Welche Daten an welches Modell gehen, ist eine Entscheidung für Datenschutz und Betriebsrat; eine Anbindung ist datenschutzkonform betreibbar, wenn Rechte, Feldlisten und Modellwahl darauf ausgelegt sind. Das ist keine Rechtsberatung.

Wenn die Daten das Unternehmen gar nicht verlassen sollen, lässt sich das Modell auch lokal betreiben; die Werkzeuge und das Rechtemodell bleiben gleich, nur der Modellanbieter wechselt. Mehr dazu auf der Seite Souveräne KI.

Wie fangen Sie an?

Der schnellste sinnvolle Einstieg ist ein Lesewerkzeug für einen echten Prozess, etwa die Lieferauskunft aus Aufträgen und Lieferscheinen, betrieben mit einem eigenen Bot-Benutzer in einer Testkopie Ihrer Datenbank. Daran sehen Sie früh, ob Datenqualität, Rechte und Antwortqualität tragen.

Prüfen Sie vorab drei Fragen: Ist die External API in Ihrem Odoo-Plan freigeschaltet? Läuft Odoo 19, sodass Sie direkt mit JSON-2 beginnen können? Und gibt es jemanden, der Gruppen und Record Rules im Entwicklermodus pflegen darf? Sind alle drei geklärt, ist der technische Teil überschaubar.

Liegen Ihre Daten nicht nur in Odoo, sondern zusätzlich in einer eigenen Datenbank oder einem Data Warehouse, ergänzt der Leitfaden KI-Agent an eine Datenbank anbinden den direkten Lesezugriff per SQL. Welche fertigen Agenten für Angebot, Service und Vertrieb auf einer solchen Anbindung aufsetzen, zeigt die Übersicht der KI-Agenten für Fachprozesse.

Häufige Fragen

Brauche ich Odoo Enterprise, um einen KI-Agenten anzubinden?

Nein, die External API gehört zum Kern, den auch die Community-Edition unter LGPLv3 enthält. Bei den Abo-Plänen von Odoo ist der API-Zugriff laut Dokumentation aber nur im Custom-Plan freigeschaltet, nicht in One App Free oder Standard.

Soll ich für eine neue Anbindung noch XML-RPC verwenden?

Für Odoo 19 und neuer besser nicht. Odoo hat /xmlrpc, /xmlrpc/2 und /jsonrpc als veraltet markiert und die Entfernung für Odoo 22 (Herbst 2028) beziehungsweise Odoo Online 21.1 (Winter 2027) angekündigt.

Gibt es einen offiziellen MCP-Server von Odoo?

Stand November 2026 haben wir keinen MCP-Server gefunden, den Odoo selbst veröffentlicht. Es gibt mehrere Community-Projekte auf Basis der JSON-2 API, die Sie vor dem Einsatz wie jede Fremdsoftware prüfen sollten.

Wie lange ist ein Odoo-API-Key gültig?

Beim Anlegen legen Sie eine Laufzeit fest; Schlüssel mit mehr als drei Monaten Laufzeit lassen sich nicht erzeugen. Dauerhafte Integrationen müssen ihren Schlüssel daher mindestens vierteljährlich rotieren.

Quellen

  1. Odoo 19 Developer Reference: External JSON-2 API odoo.com
  2. Odoo 19 Developer Reference: External RPC API (veraltet) odoo.com
  3. Odoo 19 Developer Reference: Security in Odoo odoo.com
  4. Odoo 19 Dokumentation: Access rights odoo.com
  5. Odoo Pricing odoo.com
  6. Odoo 19.0 LICENSE (LGPLv3) github.com
  7. Odoo Editions: Community vs. Enterprise odoo.com
  8. twtrubiks/odoo19-mcp-server (Community-Projekt) github.com