Odoo Migration Copilot
Zet Odoo-upgradelogs en addon-scans om in een geclassificeerde werklijst via de odoo-mcp server
Werkt met setup
Wat het doet
Een driefasen-playbook voor Odoo-versie-upgrades (16 naar 17 naar 18 naar 19/20) dat de migratietools van de odoo-mcp server aanstuurt: scan_addons_source en upgrade_risk_report voor inventarisatie, analyze_upgrade_log om staging-fouten te classificeren als no_action / needs_review / needs_script, lookup_model_history om modelhernoemingen op te lossen, en generate_json2_payload voor de XML-RPC-naar-JSON-2 transitie. De output is een fasekop, een werklijsttabel met actie/categorie/bewijs/oplossing/status, en een go/no-go besluit met het aantal openstaande needs_script. Activeert wanneer u het upgraden of migreren van Odoo-versies, een falende upgradelog, Odoo 17 "attrs" weergavefouten, of XML-RPC deprecation vermeldt.
Testrapport
De repo gekloond en skills/odoo-migration-copilot geïnstalleerd in een tijdelijke HOME (export HOME=$(mktemp -d)) — SKILL.md komt op het juiste pad, frontmatter parset naar exact naam+beschrijving, geen scripts waarnaar wordt verwezen, geen curl|sh / base64 / secret-exfil / injection tekst ergens onder skills/, en ruwe fetches van de SKILL.md, de zuster skill odoo-data-quality-gate, diagnostics.py en data/odoo_renames.json retourneerden allemaal HTTP 200. De MCP server heeft live Odoo credentials nodig, maar vier van de vijf tools die het playbook aanroept zijn puur input-gedreven functies, dus ik heb analyze_upgrade_log_report, scan_addons_source_report, upgrade_risk_report, lookup_model_history_report en generate_json2_payload_report direct uitgevoerd tegen een 14-regelige synthetische Odoo 16-naar-17 faillog en een synthetische acme_sales addon tree; alleen get_odoo_profile en data_quality_report waren onuitvoerbaar. Het skill-artefact kreeg een echte structuur boven mijn onondersteunde baseline — de voorgeschreven actie|categorie|bewijs|oplossing|status tabel, een expliciete "no-go, 9 open needs_script", en lookup_model_history die account.invoice koppelde aan account.move vanaf Odoo 13.0 met de move_type filter notitie, plus een geverifieerde POST /json/2/sale.order/search_read preview. Daartegenover stonden de regexes van analyze_upgrade_log die stilzwijgend twee van de elf foutregels oversloegen die mijn proza-baseline wel opving ("Model acme.commission.rule references undefined model account.invoice" en "dependency website_theme_install not found"), en de cascade-regel "Failed to load registry" als een eigen needs_script item scoorden, dus het letterlijk volgen van de tool-output levert een dunnere werklijst op dan zelf de log lezen.
Getest op: 2026-07-21 · Claude Code 2.x (agent harness)
Installatie
git clone --depth 1 https://github.com/tuanle96/mcp-odoo.git /tmp/odoo-migration-copilot-src mkdir -p ~/.claude/skills cp -R /tmp/odoo-migration-copilot-src/skills/odoo-migration-copilot ~/.claude/skills/odoo-migration-copilot # REQUIRED, not optional: the skill is only a playbook — every step calls a tool from the # odoo-mcp MCP server. Without that server connected the skill has nothing to run. # uvx odoo-mcp --setup # prints the MCP client config snippet # Needs Odoo connection env vars (ODOO_URL / ODOO_DB / ODOO_USER / ODOO_PASSWORD or API key). # Phase 1 addon audit additionally needs ODOO_ADDONS_PATHS pointing at your custom addon tree. # Sibling skill referenced by Phase 1 step 4 (install it too if you want the data gate): # cp -R /tmp/odoo-migration-copilot-src/skills/odoo-data-quality-gate ~/.claude/skills/odoo-data-quality-gate # Upstream also offers: npx skills add erpipe-org/mcp-odoo (installs all 4 skills in the pack)
Commando's en voorbeeldprompts
/odoo-migration-copilotZet Odoo-upgradelogs en addon-scans om in een geclassificeerde werklijst via de odoo-mcp server
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Plan our Odoo upgrade from 16 to 18Fix these broken upgrade log errorsPreview the JSON-2 payload changes for our upgrade