MCP-Brücke Odoo ↔ Claude – Bereitstellungsanleitung

Dieses kleine Projekt verbindet Ihre Odoo-Instanz (via-italia.odoo.com) mit Claude, sodass ich direkt in Odoo lesen/schreiben kann (Lager, Rechnungen, Kunden, Mahnungen), ohne dass Sie in der Oberfläche klicken müssen.

Es läuft dauerhaft auf einem Cloud-Hoster (Render, anfangs kostenlos). Claude verbindet sich über eine ordentliche Authentifizierung (OAuth): Beim ersten Mal öffnet sich eine Anmeldeseite, auf der Sie Ihr geheimes Token eingeben; danach bleibt Claude automatisch verbunden, ohne dass das Token jemals in einer URL auftaucht.

Keine Git-Befehlszeile nötig: Alles geschieht im Browser.

Schritt 0 – Was Sie vor dem Start benötigen

• Den Odoo-API-Schlüssel, der in via-italia.odoo.com erstellt wird (Meine Einstellungen → Sicherheit des Kontos → Neuer API-Schlüssel). Bewahren Sie ihn auf, Sie fügen ihn in Schritt 3 ein.

• Ein geheimes Token zum Schutz des Zugriffs. Erzeugen Sie jetzt eines (teilen Sie es nur mit Render, sonst mit niemandem):

  • Auf dem Mac: Terminal öffnen und openssl rand -hex 24 eingeben, Ergebnis kopieren.

  • Sonst: ein beliebiger Passwortgenerator, der ~40 zufällige Zeichen erzeugt, funktioniert genauso.

Related MCP server: odoo-mcp-server

Schritt 1 – Diese Dateien auf GitHub ablegen (ohne Git)

1. Gehen Sie auf github.com und erstellen Sie ein kostenloses Konto, falls Sie noch keins haben.

2. Klicken Sie auf New repository. Name: odoo-mcp-bridge (oder was immer Sie möchten). Lassen Sie es auf Public (notwendig für das Render-Deployment ohne Konto-Verknüpfung). Nichts anderes anklicken. Create repository.

3. Klicken Sie auf der Seite des neuen leeren Repositorys auf uploading an existing file.

4. Ziehen Sie die 6 Dateien dieses Ordners per Drag & Drop in den Upload-Bereich (Dockerfile, proxy.py, oauth_provider.py, requirements.txt, start.sh, README.md).

5. Commit changes.

Notieren Sie die Repository-URL, etwa https://github.com/IHR-KONTO/odoo-mcp-bridge.

Schritt 2 – Den Dienst auf Render erstellen

1. Gehen Sie auf render.com und erstellen Sie ein kostenloses Konto.

2. New + → Web Service.

3. Wählen Sie Public Git Repository und fügen Sie die GitHub-URL aus Schritt 1 ein. Connect.

4. Dienstname: via-italia-odoo-mcp (oder etwas anderes).

5. Render erkennt das Dockerfile automatisch – lassen Sie den Modus Docker.

6. Instanztyp: Free zum Starten (reicht zum Testen aus).

Schritt 3 – Umgebungsvariablen

Erweitern Sie auf derselben Erstellungsseite den Bereich Advanced → Add Environment Variable, und fügen Sie hinzu:

(ODOO_DB ist nicht nötig, Odoo erkennt es automatisch.)

Klicken Sie auf Create Web Service. Das erste Deployment dauert 2–3 Minuten – Sie sehen die Build-Logs vorbeilaufen.

Schritt 4 – Prüfen, dass alles läuft

Sobald das Deployment als Live markiert ist, hat Ihr Dienst eine Adresse wie https://via-italia-odoo-mcp.onrender.com.

Testen Sie zuerst https://via-italia-odoo-mcp.onrender.com/healthz im Browser: Sie müssen ok sehen.

Ihre Connector-Adresse (die Sie Claude geben) ist einfach:

https://via-italia-odoo-mcp.onrender.com/mcp

Kein Token in dieser URL – sie kann bedenkenlos geteilt werden, der Schutz erfolgt im nächsten Schritt.

Schritt 5 – Claude verbinden

In Claude: Customize → Connectors → "+" → Add custom connector, fügen Sie die URL aus Schritt 4 ein, Add, dann klicken Sie auf Connect.

Eine Anmeldeseite öffnet sich und fragt nach Ihrem BRIDGE_SECRET (das Token aus Schritt 0) – geben Sie es ein und bestätigen Sie. Claude bleibt danach verbunden; Sie müssen es nur erneut eingeben, wenn Sie den Dienst neu bereitstellen (was die Sitzung im Speicher löscht).

Kehren Sie dann zum Chat mit Claude zurück und bitten Sie es, die Verbindung zu prüfen (z. B.: „Liste meine letzten Angebote auf“).

Schritt 6 – Auf Lesen/Schreiben umstellen

Sobald das Lesen funktioniert und Sie sich wohlfühlen, gehen Sie zurück zu Render → Ihr Dienst → Environment, ändern Sie ODOO_YOLO von read auf true, und stellen Sie neu bereit (Render macht das automatisch nach einer Variablenänderung). Claude kann dann auch Rechnungen erstellen, Bestände aktualisieren usw. – aktivieren Sie dies erst, wenn Sie bereit sind, dass wirklich in Odoo geschrieben wird.

Bekannte Grenzen

• Der Free-Plan von Render versetzt den Dienst nach 15 Minuten ohne Verkehr in den Ruhezustand: Die erste Anfrage nach einer Pause dauert 30–60 Sekunden, bis er wieder aufwacht. Für einen flüssigeren täglichen Gebrauch sorgt ein kostenpflichtiger Plan (ab ~7 $/Monat), der den Ruhezustand abschaltet.

• Die Sitzungen (ausgestellte OAuth-Tokens) werden vom Dienst nur im Speicher gehalten, nicht auf der Festplatte: Ein erneutes Deployment oder ein Neustart löscht sie, und Sie müssen die Verbindung auf Claude-Seite neu herstellen (einfach das BRIDGE_SECRET erneut eingeben, mehr nicht).