Odoo es uno de esos programas que te permiten llevar un negocio entero desde un solo lugar: contabilidad, CRM, documentos, sitio web, compras, ventas, facturación y muchos otros procesos que normalmente necesitarían varias aplicaciones distintas. Hasta ahora todo eso se manejaba desde su interfaz gráfica. Lo nuevo es que Odoo trae un servidor MCP oficial, así que puedes conectarlo a herramientas de IA como Claude Code y gestionar tu negocio simplemente pidiéndolo por chat.
En este artículo te cuento paso a paso cómo hacer esa conexión y todo lo que se puede lograr una vez que el agente tiene acceso a tus datos: registrar contactos, importar un Excel completo, crear oportunidades del CRM a partir de un texto o convertir un correo en una cita del calendario.
Qué es Odoo y por qué importa el MCP
Odoo es una plataforma modular: según tu negocio puedes activar contabilidad, seguimiento de clientes, firma de documentos, sitio web, tienda en línea, inventario, fabricación o ventas, y ampliarla a medida que tu empresa crece. Ya había mostrado antes cómo usarlo, instalarlo e incluso extenderlo con código.
La diferencia ahora es el MCP (Model Context Protocol), un estándar abierto que permite que un modelo de lenguaje interactúe de forma segura con aplicaciones externas. En el caso de Odoo, significa que todas esas funciones se pueden usar desde una aplicación de IA. Y no hace falta una herramienta concreta: Claude Code, GPT Codex, Cursor, OpenCode y la mayoría de clientes actuales ya soportan MCP.
La idea de fondo es sencilla: un agente de IA se vuelve realmente útil cuando deja de trabajar aislado y puede acceder al contexto, las herramientas y los datos que necesita para ejecutar tareas reales.
Crear tu cuenta y elegir las apps
Para empezar, en la web de Odoo hay un botón de prueba gratuita (puedes crear tu cuenta aquí). Lo primero que te pide es elegir los módulos iniciales. Lo ideal es quedarte con los que más vas a usar, porque luego puedes añadir los que quieras. En mi caso elegí el sitio web con tienda en línea, el CRM, documentos y el módulo de empleados.
Después completas tus datos y, en unos segundos, Odoo te pregunta qué quieres empezar a administrar. Por ejemplo, para el sitio web le describes el negocio (en el video, una tienda de computadoras con configuraciones personalizables), eliges uno de los diseños que genera y la plantilla del catálogo. El sitio queda listo para editarlo.
En el CRM puedes registrar a mano una oportunidad: nombre del cliente, qué quiere comprar, su correo, un precio en la moneda que hayas configurado, y aparece como una tarjeta que puedes mover entre etapas. Es justo este tipo de tareas lo que después vamos a hacer desde la IA.
Qué es el servidor MCP de Odoo
Odoo tiene una documentación oficial del servidor MCP que explica todo el proceso. En resumen:
- El servidor vive en la dirección de tu base de datos con el sufijo
/mcp(por ejemplo,https://tuempresa.odoo.com/mcp). - El cliente se autentica con una API key de alcance MCP, y cada petición usa esa clave para comprobar tu identidad y tus permisos en la base de datos.
- Por defecto se exponen cinco herramientas de lectura: obtener modelos, obtener campos, buscar, agrupar registros y recuperar el contexto inicial.
- Las demás acciones (crear o actualizar registros, por ejemplo) se activan una por una como acciones de servidor.
Paso 1: preparar Claude Code
Aunque la documentación trae los pasos, la forma más fácil es copiar su URL y pedirle a la IA que haga la configuración por ti. En la aplicación de Claude, en la sección Code (que además de chatear puede crear archivos y escribir código), crea una carpeta en el escritorio, por ejemplo o-mcp, y ábrela como carpeta de trabajo. No es obligatorio, pero ayuda a tener ordenados los reportes y archivos que vayas generando.
Luego escríbele algo como "Ayúdame a configurar el cliente MCP de Odoo" y pega la dirección de la documentación.
Paso 2: activar el módulo del servidor MCP
En las cuentas nuevas suele venir activado. Si no, entra en Aplicaciones, borra el filtro, busca MCP y aparecerá el módulo del servidor MCP de IA. Actívalo (o actualízalo desde los tres puntos). Cuando en su ficha ves los botones "Actualizar" y "Desinstalar", la integración ya está disponible.
Paso 3: crear la API key
Desde tu perfil, entra en Preferencias → Seguridad → Claves API → Nueva clave API y:
- Ponle un nombre que la identifique (por ejemplo, "Claude").
- En el alcance elige MCP. Es muy importante marcarlo.
- Elige cuánto durará el acceso: un día si solo estás probando, un mes o un año.
Al crearla, Odoo te muestra la clave y la dirección de tu base de datos. Copia las dos en ese momento, porque la clave no se vuelve a mostrar.
Paso 4: conectar Odoo con Claude Code
Pégale a Claude la clave y la dirección y pulsa Enter. Claude hace la instalación y te confirma que tiene un servidor nuevo llamado odoo, conectado a Claude Code, con las cinco herramientas de lectura.
Si prefieres hacerlo a mano, la documentación indica este comando:
claude mcp add --transport stdio odoo -- npx -y mcp-remote https://tuempresa.odoo.com/mcp --header "Authorization: Bearer <TU_API_KEY>"
Añade --scope user si quieres tenerlo disponible en todos tus proyectos. Necesitas Node.js instalado.
Paso 5: habilitar más herramientas (escritura)
Leer datos está bien, pero lo interesante es que el agente pueda crear y editar registros. Para eso:
- Ve a Ajustes, baja hasta el final y pulsa Activar el modo de desarrollador.
- Aparece el menú Técnico. Dentro, entra en Acciones de servidor.
- Verás la lista de herramientas marcadas como "AI Tool": crear páginas, describir informes contables, obtener el HTML de una página, buscar imágenes o en la web, crear registros, actualizar registros…
- Abre la que quieras, ve a la pestaña Uso, marca Disponible en MCP y guarda.
Un detalle: si tu interfaz está en español, los nombres aparecen traducidos ("Crear registros", "Actualizar registro"). En el video activé varias y Claude pasó de 5 a 13 herramientas, entre ellas las de escritura.
Lo que puedes hacer con Odoo y Claude
Registrar y actualizar contactos
Con la herramienta de crear registros basta con decir "registra este contacto en Odoo" y darle nombre, teléfono y correo. Como también puede leer, Claude incluso detecta si la persona ya existe antes de crearla. Actualizar es igual de directo: le pides cambiar el correo de un contacto, primero lo busca y luego lo modifica.
Importar 150 contactos desde un Excel
En lugar de insertar uno por uno, le pasé un Excel con 150 personas y le pedí registrarlas todas. Claude lee el contenido, lo limpia (sin duplicados ni espacios vacíos) y, lo más útil, detecta cuando las columnas del archivo no coinciden con los campos que espera Odoo. Al terminar, los 150 contactos aparecen en la aplicación.
Oportunidades del CRM a partir de texto
Aquí está la gracia: no necesitas conocimientos técnicos ni saber rellenar cada campo. Describí a tres clientes en texto libre (quién es, su número, que quiere armar una PC y con qué presupuesto) y le pedí registrarlos en el CRM. Claude lee los campos del CRM, crea los contactos y las tres oportunidades, con los componentes que pidió cada cliente. Después puedes seguir preguntándole sobre esos datos.
De un correo a CRM, calendario y checklist
Pegué un correo típico ("Hola, soy tal persona, de tal lugar, y queremos un plan de mantenimiento") y le pedí crear la oportunidad en el CRM, programar la visita en el calendario y preparar un checklist con lo que hay que hacer. Antes eso significaba saltar entre varios módulos; ahora se hace pidiéndolo. Si algo falla, por ejemplo un número de identificación fiscal no válido, te lo avisa y te propone opciones.
Convertir moneda y actualizar la oportunidad
Como no tenía activada la conversión de monedas, Claude me ofreció hacerla él. Lo registró en el CRM con los cálculos hechos y, cuando el cliente quiso más equipos, le pedí actualizar la oportunidad: el presupuesto cambió y quedó anotado que se encargaron seis computadoras de oficina.
Buenas prácticas
- No lo dejes todo en automático al principio. Puedes aprobar paso a paso ("listo para el paso uno" → "continúa") hasta que el agente conozca tu flujo de trabajo.
- Dale ejemplos. Cuando el flujo esté claro, puedes convertirlo en una skill para no tener que explicarlo cada vez.
- Activa solo las herramientas que necesitas. Cada acción de servidor se habilita por separado, y el agente trabaja con los permisos del usuario dueño de la API key.
- Usa claves con caducidad, sobre todo mientras estás probando.
Conclusión
Usar un ERP hoy puede ser mucho más fácil que aprender cada una de sus interfaces. Con el servidor MCP:
- ✅ Conectas Odoo a Claude Code (o a Codex, Cursor u OpenCode) con una API key y una dirección.
- ✅ Decides qué puede hacer el agente activando herramientas de escritura una por una.
- ✅ Automatizas tareas reales: contactos, importaciones, CRM, calendario y presupuestos, todo desde un chat.
Este es el primer video de una serie sobre agentes de IA conectados a empresas reales. Y tú, ¿qué proceso de tu negocio automatizarías primero? Te leo en los comentarios del video en YouTube.