Odoo MCP Pro (cloud based)

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

GitHub
74
Prueba este MCPPatrocinado

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 Python 3.10+ MCP Compatible Odoo 14-19+ OAuth 2.1

Omitte la configuración. La versión alojada está operativa 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 utiliza MCP (Model Context Protocol), un estándar abierto que permite a los asistentes de IA comunicarse con sistemas externos. Conecta tu asistente de IA a tu Odoo ERP, 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 50.000 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? Omitte la configuración: la versión alojada se conecta a tu Odoo en menos de 5 minutos. Empieza en pantalytics.com →

Cómo empezar

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.

  • Operativo 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, monitorización continua, 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

Ejecútalo en tu propia máquina. Solo para un único 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 independiente que se basa en este servidor de núcleo abierto.

Cómo funciona

odoo-mcp-pro es un conector de Odoo que implementa MCP (Model Context Protocol), un estándar abierto que permite a los asistentes de IA llamar a herramientas externas. Expone las siguientes herramientas que tu IA puede invocar 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-19+ — 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.

¿Prefieres seguridad gestionada? La versión alojada gestiona parches, rotación de tokens OAuth y monitorización 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-19+. 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 mobile (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.

¿Están seguros mis datos? 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 adecuados. Prueba:

  1. Regenera tu clave API en Odoo (Ajustes > 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 los ajustes 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á operativa 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 único 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 Mozilla Public License 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ó — está bajo la Elastic License 2.0.

Para las partes bajo licencia Elastic, 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 los avisos de licencia ni eludir la funcionalidad de las claves de licencia.

Las partes bajo licencia Elastic 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 implementadores 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 Elastic License 2.0. En su lugar, tenemos un Programa de Socios con comisión por referidos: recomiendas odoo-mcp-pro a tus usuarios finales, se registran a través de tu enlace de referido y 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 implementador 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 Mozilla Public License 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.