Saltar a contenido

Odoo Tools — Introducción

MCP-Odoo-Tools es un plugin de Claude Code / Cowork que unifica el acceso a Odoo en una sola instalación: un servidor MCP (superficie principal) y una CLI de respaldo. Funciona con Odoo Community, Enterprise y online (SaaS), desde la versión 10 hasta la 19, gracias a una capa de compatibilidad que resuelve automáticamente los nombres de modelos y campos que cambian entre versiones.

Está construido y mantenido por Transgenia, partner registrado de Anthropic (tier Registered). Es un proyecto open-source independiente con licencia MIT — no es un producto certificado ni de primera parte de Anthropic, y aún no está aprobado en el directorio oficial de plugins.

Qué resuelve

Los nombres de modelos y campos de Odoo cambian entre versiones:

  • account.invoice pasó a ser account.move en la v13.
  • Los campos analíticos cambiaron en la v16 (analytic_account_id → analytic_distribution).
  • Los modelos de paquetes cambiaron cerca de la v19.
  • El comportamiento de las API keys sobre /jsonrpc cambió en la v17.

Además, Enterprise incluye modelos que Community no tiene. Para un agente de IA, cada una de estas diferencias es un punto de falla silencioso: llama al nombre antiguo, el ERP responde con un error, y el agente no distingue si es un problema de permisos, de red o de versión.

Este plugin absorbe esas diferencias detrás de una sola superficie de herramientas estable, para que no tengas que ramificar tu código por versión.

Las dos superficies

Superficie Cuándo usarla Requisitos
Servidor MCP (recomendada) Uso normal desde Claude Code/Cowork: 18 herramientas + capa de compatibilidad completa uv/uvx (trae su propio Python) o Python 3.11+
CLI de respaldo Cuando no puedes correr el servidor MCP, o para acceso por lotes desde scripts Node.js 18+

Alcance (público vs. privado)

Este es el núcleo genérico público: habla con Odoo y nada más. Cualquier motor de localización, gobernanza o específico de un cliente (facturación electrónica por país, flujos de aprobación, respaldos, IA documental) queda deliberadamente fuera de este repositorio y se ofrece como parte de las implementaciones supervisadas de Transgenia.

Siguiente paso

Continúa con la Instalación o salta directo al Inicio rápido guiado.

Soporte de implementación

¿Necesitas ayuda para conectarlo a tu Odoo o una integración de IA/ERP a la medida? Transgenia ofrece servicios de implementación de IA y Odoo. Escríbenos a dev@transgenia.org.