Guía Técnica

Conecta Odoo con Hermes Agent vía XML-RPC

Odoo Expertos 7 agosto 2026 6 min lectura

Imagina poder preguntarle a un asistente de IA cosas como "¿cuántos clientes tenemos en CRM?" o "crea una orden de venta para el cliente X" y que responda en tiempo real desde tu Odoo. Eso es exactamente lo que permite Hermes Agent conectado a Odoo vía XML-RPC, sin middleware, sin servidores MCP y sin pipelines de n8n. Solo tu agente y tu ERP hablando directamente.

Esta es la primera y más simple de las tres formas de integrar Odoo con Hermes Agent —llamadas directas a la API XML-RPC. Es la ruta más rápida: un salto, un bloque de configuración, y una cosa menos que puede fallar. Para consultas simples, prototipos y demostraciones, es la elección correcta.

Qué vas a construir

Al final de esta guía tendrás un agente Hermes que puede consultar y manipular datos de tu Odoo en tiempo real usando XML-RPC.

Prerrequisitos

  • Una instancia de Odoo (Community o Enterprise) con acceso de administrador
  • Hermes Agent instalado. Si aún no lo tienes, sigue la guía de instalación en derez.ai
  • Acceso a la terminal o interfaz de Hermes

Paso 1 — Generar una clave API de Odoo

Ve a Ajustes → Usuarios → Técnico en tu Odoo. Selecciona tu usuario y, en la pestaña Claves API, genera una nueva clave. Asígnale un nombre descriptivo como hermes-agent. Copia la clave generada: la necesitarás en el siguiente paso.

Paso 2 — Añadir la conexión a Hermes

En tu archivo de configuración de Hermes, añade un bloque de conexión Odoo. La estructura básica incluye la URL de tu instancia, el nombre de la base de datos, el usuario y la clave API:

url: "https://tu-instancia.odoo.com"
db: "nombre-de-tu-base-de-datos"
user: "tu@email.com"
api_key: "tu-clave-api-generada"
readonly: true

El parámetro readonly: true es recomendable si solo quieres realizar consultas. Para operaciones de escritura, cámbialo a false.

Paso 3 — Darle el prompt de conexión a tu agente

Hermes Agent necesita un prompt que le indique cómo conectarse a tu Odoo. El prompt debe incluir las credenciales y el alcance de las operaciones permitidas. Puedes usar el prompt de ejemplo que encontrarás en la guía completa en derez.ai.

Paso 4 — Iniciar Hermes y verificar

Inicia Hermes Agent y haz tu primera consulta. Por ejemplo, pregúntale: "¿Cuántos clientes hay en CRM?". Si todo está configurado correctamente, tu agente responderá con el número de registros.

> ¿Cuántos clientes tenemos en CRM?
Total: 8 clientes en CRM

Qué puedes hacer ahora

Una vez conectado, tu agente puede:

  • Consultar clientes, productos, pedidos y facturas
  • Crear y actualizar registros en cualquier modelo
  • Ejecutar búsquedas complejas con filtros en múltiples modelos
  • Automatizar tareas rutinarias desde una sola conversación

Seguridad primero

La conexión XML-RPC expone tu Odoo directamente al agente. Es importante usar claves API específicas para cada integración, activar readonly cuando sea posible, y limitar el acceso del agente a los modelos estrictamente necesarios.

¿Por qué XML-RPC?

La vía directa por XML-RPC es el camino más rápido: un salto, un bloque de configuración, una cosa menos que puede fallar. Sin servidores MCP que mantener, sin flujos de n8n que depurar. Para consultas simples, prototipos y experimentación, es la elección correcta. Para integraciones más complejas, puedes explorar los otros dos enfoques (MCP y n8n) en el blog de derez.ai.

Este artículo está basado en la guía original de derez.ai.