- Python 100%
Nils hat die Regel (Server-Aktion mit Code) in Odoo gelöscht, wegen der Kosten für eigene Code-Zeilen. CLAUDE.md beschreibt jetzt den Stand ohne Umbenennung und ohne eigenen Code. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .claude | ||
| odoo_module/jetzt_it_invoice_layout | ||
| .gitignore | ||
| CLAUDE.md | ||
| README.md | ||
odoo_mcp – Claude Code für unsere Odoo-Datenbank
Mit diesem Repo arbeitet Claude Code direkt mit unserer Odoo-Datenbank (https://odoo.jetzt-it.de, Odoo 20 Online, Enterprise).
Kurz: Connector „Odoo“ in claude.ai aktivieren → Projekt in der Claude-App öffnen → fertig. Du brauchst keinen API-Key und kein Terminal.
1. Voraussetzungen
- Die Claude Desktop-App ist installiert. Du nutzt den Reiter Code.
- Du hast Zugriff auf das Forgejo-Repo
jetzt-IT/odoo_mcp. - Du hast einen eigenen Odoo-User. Jede Person meldet sich mit ihrem eigenen Login an. Claude sieht in Odoo nur das, was du auch siehst.
2. Projekt holen
Frag den Admin, ob er den Ordner odoo_mcp für dich auf deinem Rechner anlegt.
Oder, wenn du Git kennst:
git clone ssh://git@forgejo.jetzt-it.de:2222/jetzt-IT/odoo_mcp.git
3. Odoo-Connector aktivieren (nur einmal)
Odoo läuft über den claude.ai-Connector „Odoo“, nicht über eine Datei im Repo.
- In claude.ai bzw. der Claude-App Einstellungen → Connectors öffnen.
- Odoo verbinden und mit deinem Odoo-Login anmelden.
- Den Zugriff erlauben.
4. Projekt in der Claude-App öffnen
- Claude-App öffnen.
- Reiter Code wählen.
- Neue Sitzung starten und den Ordner
odoo_mcpauswählen.
Test: Schreib „Wer bin ich in Odoo?“
Die Anmeldung bleibt gespeichert. Du musst sie nur wiederholen, wenn Claude dich danach fragt.
5. Was kann ich fragen?
- „Zeige mir die offenen Posten“ → offene Kundenrechnungen nach Fälligkeit
- „Zeige mir die Pipeline“ → CRM-Verkaufschancen nach Stufe
6. Was ist im Repo?
| Datei | Zweck |
|---|---|
.claude/settings.json |
Gemeinsame Rechte: Lesen ohne Rückfrage, Schreiben immer mit Rückfrage. |
.claude/settings.local.json |
Deine persönlichen Overrides. Wird nicht committet. |
CLAUDE.md |
Regeln für Claude bei der Arbeit mit Odoo. |
.claude/skills/odoo-offene-posten |
Offene Kundenrechnungen nach Fälligkeit. |
.claude/skills/odoo-pipeline |
CRM-Pipeline nach Stufe + liegengebliebene Leads. |
7. Schreibrechte
Ob Claude in Odoo etwas ändern darf, entscheidet der Odoo-Admin serverseitig pro Aktion.
Zusätzlich fragt Claude Code vor jedem schreibenden Tool nach. Und laut CLAUDE.md
fasst Claude jede Änderung vorher in einem Satz zusammen.
8. Wenn etwas nicht geht
| Problem | Lösung |
|---|---|
| Odoo-Tools fehlen | In den Connector-Einstellungen prüfen, ob Odoo verbunden und für die Sitzung aktiv ist. Sonst Schritt 3 wiederholen. |
| Schreib-Tools laufen ohne Rückfrage | Connector-ID hat sich geändert. Präfix in .claude/settings.json anpassen (siehe unten). |
| Tool wird „nicht erlaubt“ gemeldet | Aktion ist in Odoo nicht freigegeben. Odoo-Admin fragen. |
| Sonst etwas | Admin fragen. |
Für Admins: technische Hinweise
Connector statt .mcp.json (seit 2026-10-16): Der frühere Projekt-Server in .mcp.json
(https://jetzt-it-gmbh.odoo.com/mcp) scheiterte an der Prüfung der Adresse („Protected resource …
does not match expected …“). Er ist entfernt. Odoo kommt jetzt über den claude.ai-Connector.
Rechte: Die Tools heißen mcp__04e6eda9-8f95-46e1-9bf5-d8874f4f4eb9__<tool>. So stehen sie in
.claude/settings.json. Hat ein Kollege eine andere Connector-ID, greifen diese Regeln bei ihm
nicht. Er trägt dann seine eigenen in .claude/settings.local.json ein.
Alter Weg mit API-Key: Wird nicht mehr gebraucht. Ein evtl. vorhandener Key
(ODOO_MCP_KEY, Schlüsselbund-Eintrag odoo-mcp) kann gelöscht werden. Den Key in Odoo
unter Mein Profil → Account-Sicherheit widerrufen.