Odoo MCP Pro (cloud based)

Una versión alojada o autoalojada en la nube de Odoo MCP

GitHub
87

Documentación

Odoo      Model Context Protocol

odoo-mcp-pro

Conector de IA para Odoo ERP: habla con tus datos de negocio usando lenguaje natural.
Busca, crea, actualiza y gestiona registros: solo pregunta.

License: Elastic 2.0 and MPL-2.0 Python 3.10+ MCP Compatible Odoo 14-20 OAuth 2.1

Omitete la configuración. La versión alojada está funcionando en 5 minutos, con actualizaciones automáticas, OAuth gestionado y claves API cifradas. Empieza en pantalytics.com →

Odoo connected to Claude, OpenAI, Gemini, Copilot, Mistral via MCP

La idea

Odoo es potente. La IA es potente. Juntos son mejores.

odoo-mcp-pro es un conector de IA para Odoo que usa MCP (Protocolo de Contexto de Modelo), un estándar abierto que permite a los asistentes de IA hablar con sistemas externos. Conecta tu asistente de IA a tu ERP de Odoo, para que puedas usar lenguaje natural como interfaz con tus datos de negocio. No para reemplazar la interfaz de Odoo, sino para darte una segunda interfaz más rápida para muchas tareas. Funciona con Claude, ChatGPT, Cursor, Windsurf y cualquier otra herramienta de IA compatible con MCP.

"Muéstrame todas las facturas impagadas de más de 5.000 EUR del cuarto trimestre" — tu IA consulta tu instancia de Odoo directamente y devuelve los resultados.

Demo of odoo-mcp-pro

Usa la interfaz que se ajuste a la tarea. ¿Configuración compleja? Usa la interfaz de Odoo. ¿Consultas rápidas de datos, preguntas masivas o crear registros sobre la marcha? Solo pregunta a tu IA.

Lo que puedes hacer

  • "Encuentra todos los contactos en Ámsterdam con presupuestos abiertos"
  • "Crea un cliente potencial para Acme Corp, ingresos esperados de 50k EUR"
  • "¿Qué pedidos de venta del mes pasado no tienen entrega todavía?"
  • "¿Qué campos tiene el modelo sale.order?"
  • "Actualiza la fecha de cierre esperada de la oportunidad #42 al próximo viernes"

Funciona con cualquier modelo de Odoo: ventas, facturas, contactos, inventario, CRM, RR. HH., lo que sea.

¿Quieres probarlo ahora? Omitete la configuración: la versión alojada se conecta a tu Odoo en menos de 5 minutos. Empieza en pantalytics.com →

Comenzar

Alojado (recomendado)

La forma más rápida y segura de empezar. Nosotros ejecutamos el servidor por ti: regístrate, pega tu URL de Odoo + clave API, y listo.

  • Funcionando en 5 minutos. Sin instalación, sin Docker, sin infraestructura. Funciona con Claude, ChatGPT, Cursor, Windsurf y cualquier herramienta de IA compatible con MCP.
  • Siempre actualizado. Los parches de seguridad, la compatibilidad con versiones de Odoo y las nuevas funciones de MCP se implementan automáticamente, sin trabajo de actualización por tu parte.
  • Más seguro por defecto. Claves API cifradas (AES-128), OAuth 2.1 gestionado, monitoreo continuo, infraestructura europea. Nosotros nos encargamos de lo aburrido pero crítico para que tú no tengas que hacerlo.
  1. Regístrate en pantalytics.com
  2. Inicia sesión e introduce tu URL de Odoo + clave API (cómo generar una)
  3. Añade el servidor MCP a tu herramienta de IA (Claude, ChatGPT, Cursor, etc.)
  4. Empieza a hacer preguntas

Tus datos permanecen en Odoo: el servidor es un proxy sin estado. Las claves API están cifradas en reposo.

Empieza en pantalytics.com →

Autoalojado

Ejecuta en tu propia máquina. Solo para un solo inquilino: una instancia de Odoo, configurada mediante variables de entorno. La autenticación es tu clave API de Odoo: sin OAuth, sin gestión de usuarios, sin interfaz de administración.

# Install
pip install "mcp-server-odoo @ git+https://github.com/pantalytics/odoo-mcp-pro.git"

# Run (stdio mode, for Claude Desktop / Claude Code)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key python -m mcp_server_odoo

# Run (HTTP mode, for remote access from one trusted network)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key \
  python -m mcp_server_odoo --transport streamable-http --host 0.0.0.0 --port 8000

El modo HTTP no tiene autenticación integrada: expónlo detrás de un proxy inverso o restringe el acceso a nivel de red.

O añádelo a tu Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_API_KEY": "your_api_key_here"
      }
    }
  }
}

¿Necesitas multiinquilino, conexiones por usuario, OAuth o una interfaz de administración? Eso es territorio SaaS. La versión alojada es más rápida de configurar, se actualiza automáticamente y gestiona los parches de seguridad por ti, y cuesta menos que el tiempo que dedicarías al autoalojamiento. Estas funciones viven en un paquete comercial separado que se basa en este servidor de núcleo abierto.

Cómo funciona

odoo-mcp-pro es un conector de Odoo que implementa MCP (Protocolo de Contexto de Modelo), un estándar abierto que permite a los asistentes de IA llamar a herramientas externas. Expone las siguientes herramientas que tu IA puede llamar según tus preguntas:

HerramientaQué hace
search_recordsBusca cualquier modelo con filtros de dominio, ordenación y paginación
get_recordObtiene un registro específico por ID con selección inteligente de campos
list_modelsDescubre los modelos de Odoo disponibles
list_resource_templatesDescubre las plantillas de URI de recursos disponibles
create_record / create_recordsCrea uno o varios registros
update_record / update_recordsActualiza uno o varios registros
delete_record / delete_recordsElimina uno o varios registros
import_recordsUpsert idempotente mediante IDs externos (igual que la importación CSV de Odoo)
server_infoVersión del servidor, estado de la conexión

Compatible con Odoo 14-20: usa la API JSON/2 para Odoo 19+ y XML-RPC para versiones anteriores. El protocolo correcto se selecciona automáticamente.

Seguridad

  • Odoo manda. Todos los datos, permisos y lógica de negocio viven en Odoo. La clave API de cada usuario determina lo que puede ver y hacer: las ACL y las reglas de registro se aplican con normalidad.
  • Proxy sin estado. El servidor MCP no almacena ni guarda en caché tus datos de negocio.
  • Claves API cifradas en reposo con AES-128 (Fernet). Nunca se exponen a la IA, al navegador ni a los registros.
  • Tú mantienes el control. Revoca tu clave API en Odoo en cualquier momento para cortar el acceso al instante.
  • ¿Has encontrado una vulnerabilidad? Envía un correo a rutger@pantalytics.com, consulta SECURITY.md. Los informantes reciben crédito en el registro de cambios.

¿Prefieres seguridad gestionada? La versión alojada gestiona parches, rotación de tokens OAuth y monitoreo de incidentes: tus datos siguen en Odoo, nosotros solo ejecutamos el proxy por ti.

Desarrollo

uv venv --python 3.10
source .venv/bin/activate
uv pip install -e ".[dev]"
pytest tests/ -q
ruff check . && ruff format .

Consulta architecture.md para detalles técnicos y CLAUDE.md para convenciones de código.

Contribuciones

Las contribuciones son bienvenidas. Haz un fork del repositorio, crea una rama de funcionalidad, ejecuta pytest tests/ y ruff check ., y luego abre un PR.

Preguntas frecuentes

¿Qué versiones de Odoo son compatibles? Odoo 14-20. El servidor detecta automáticamente si usar JSON/2 (Odoo 19+) o XML-RPC (14-18). No se necesita configuración.

¿Funciona en mi teléfono? Sí: la versión alojada funciona en Claude móvil (iOS/Android), Claude.ai en cualquier navegador, Claude Desktop, Claude Code y ChatGPT. Las instalaciones locales (STDIO) solo funcionan en la máquina donde están instaladas.

¿Mis datos están seguros? Tus datos permanecen en Odoo. El servidor MCP es un proxy sin estado: no almacena ni guarda en caché datos de negocio. Las claves API están cifradas en reposo con AES-128 (Fernet). Se aplican los permisos de Odoo de cada usuario: solo puedes ver y hacer lo que tu rol en Odoo permite.

Recibo "Acceso denegado" en todos los modelos Esto suele significar que tu clave API de Odoo no tiene los permisos correctos. Prueba:

  1. Regenera tu clave API en Odoo (Configuración > Usuarios > Claves API) y actualízala donde la hayas configurado (alojado: /admin/setup; autoalojado: tu variable de entorno ODOO_API_KEY)
  2. Asegúrate de que tu usuario de Odoo tenga al menos acceso de lectura a los modelos que quieres consultar
  3. Si estás en Odoo.sh, verifica que tu plan de suscripción sea compatible con la API JSON/2

Recibo "Autenticación requerida" o "invalid_token" (versión alojada) Esto significa que la conexión OAuth entre tu herramienta de IA y el servidor MCP falló. Prueba a desconectar y reconectar el servidor MCP en la configuración de tu herramienta de IA. Las instalaciones autoalojadas no usan OAuth: se autentican directamente con tu clave API de Odoo.

¿Necesito configurar ODOO_DB? Solo si autoalojas Odoo con varias bases de datos. Odoo.sh y Odoo Online no lo necesitan: el nombre de host determina la base de datos.

¿Debo usar la versión alojada o la autoalojada? Alojada, salvo que tengas una razón de peso para no hacerlo. La versión alojada está funcionando en 5 minutos, se actualiza automáticamente con cada versión de Odoo y tiene OAuth gestionado + claves API cifradas. El autoalojamiento es solo para un solo inquilino (una instancia de Odoo, autenticación con clave API, sin interfaz de administración), y tú eres responsable de los parches y la seguridad. Empieza con la versión alojada en pantalytics.com →

Licencia

Este proyecto tiene doble licencia:

  • Los archivos derivados del mcp-server-odoo original de Andrey Ivanov permanecen bajo la Licencia Pública de Mozilla 2.0 (LICENSE.MPL-2.0). Estos archivos llevan un encabezado SPDX-License-Identifier: MPL-2.0, y NOTICE los enumera.
  • Todo lo demás, el código que Pantalytics añadió por encima, está bajo la Licencia Elástica 2.0.

Para las partes bajo la Licencia Elástica, en términos sencillos:

  • Puedes usar, copiar, modificar y distribuir este software, incluso para fines comerciales propios (ejecutarlo dentro de tu propia empresa, tu propia instancia de Odoo, tus propios proyectos).
  • No puedes ofrecerlo a terceros como un servicio alojado o gestionado que les proporcione acceso a un conjunto sustancial de sus funciones: eso es lo que hace Pantalytics y lo que la licencia protege.
  • No puedes eliminar avisos de licencia ni eludir la funcionalidad de las claves de licencia.

Las partes bajo la Licencia Elástica tienen el código fuente disponible, pero no son de código abierto según OSI. Consulta LICENSE, LICENSE.MPL-2.0 y NOTICE para ver el panorama completo.

Para socios de implementación de Odoo

¿Quieres ofrecer Odoo con IA a tus clientes? Ejecutar tu propia versión alojada de odoo-mcp-pro para clientes no está permitido bajo la Licencia Elástica 2.0. En su lugar, tenemos un Programa de Socios con comisión por referidos: recomiendas odoo-mcp-pro a tus usuarios finales, ellos se registran a través de tu enlace de referido y tú ganas una tarifa recurrente. Sin alojamiento ni mantenimiento por tu parte.

¿Interesado? Contacta con rutger@pantalytics.com para más detalles.

Creado por Pantalytics

odoo-mcp-pro está creado y mantenido por Pantalytics, un socio de implementación de Odoo con sede en Utrecht, Países Bajos.

Originalmente bifurcado de mcp-server-odoo de Andrey Ivanov. Los archivos que provienen de ese proyecto permanecen bajo la Licencia Pública de Mozilla 2.0; consulta NOTICE.

Odoo es una marca registrada de Odoo S.A. El logotipo de MCP se usa bajo la Licencia MIT. Este proyecto no está afiliado ni respaldado por Odoo S.A. ni por Anthropic.