Odoo 17 – MCP-Server (Proof of Concept)

Ein schlanker MCP-Server, der ausgewählte Odoo-17-Geschäftsprozesse als Tools kapselt. Ein LLM-Agent (z.B. OpenClaw) kann diese Tools auswählen und ausführen, ohne Odoo selbst zu verändern. Die Anbindung erfolgt entkoppelt über die externe Odoo-API (XML-RPC)

Tools

Related MCP server: Odoo MCP Unified Server

1. Odoo lokal starten

docker compose up -d

Dann http://localhost:8069 öffnen und beim ersten Start eine Datenbank namens odoo mit Demodaten anlegen (liefert Beispielprodukte/-kunden). Das Master-Passwort wird in config/odoo.conf gesetzt; dazu die Vorlage kopieren und ein eigenes Passwort eintragen:

cp config/odoo.conf.example config/odoo.conf   # admin_passwd anpassen

config/odoo.conf ist bewusst per .gitignore ausgeschlossen und darf nicht mit echtem Passwort/Hash veröffentlicht werden.

2. MCP-Server einrichten

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env        # ggf. Zugangsdaten anpassen

3. Server testen

.venv/bin/python main.py    # startet den MCP-Server über stdio

Der Server kommuniziert über stdio (JSON-RPC) und wird normalerweise vom MCP-Client/Agenten gestartet, nicht direkt im Terminal bedient.

4. In einem MCP-Client registrieren

Beispielkonfiguration (z.B. für OpenClaw / kompatible Clients):

{
  "mcpServers": {
    "odoo": {
      "command": "/ABSOLUTER/PFAD/zu/odoo-mcp/.venv/bin/python",
      "args": ["/ABSOLUTER/PFAD/zu/odoo-mcp/main.py"]
    }
  }
}

Pfade an den eigenen Projektordner anpassen (absolute Pfade zum venv-Python und zu main.py).

Beispiel-Ablauf (typische Tool-Kette eines Agenten)

1. search_products("Desk") → Produkt-ID ermitteln

2. check_stock_level(product_id) → Bestand prüfen

3. find_or_create_customer("Muster GmbH", "info@muster.de") → Kunden-ID

4. create_sale_order(customer_id, [{"product_id": 42, "quantity": 2}]) → Angebot

5. confirm_sale_order(order_id) → bestätigter Verkaufsauftrag

Konfiguration

Über Umgebungsvariablen bzw. .env:

Governance-Schicht

policy.yaml; governance.py:

Ein leerer/fehlender allowed_*-Eintrag bedeutet „keine Einschränkung". Den Policy-Pfad kann man über die Umgebungsvariable ODOO_MCP_POLICY überschreiben.

Beispielzeile aus dem Audit-Log:

{"ts": "2026-06-22T12:55:52Z", "agent_id": "openclaw-poc", "tool": "create_sale_order",
 "params": {"customer_id": 7, "order_lines": [{"product_id": 42, "quantity": 2}]},
 "status": "ok", "result_ref": 15, "duration_ms": 38.4}