Crear un módulo
De la descripción de la necesidad al módulo probado: conectar el conector, describir, dejar que Claude escriba, desplegar en una sandbox y corregir.
7 min de lecturaActualizado el 1 de octubre de 2026
Esta guía parte de una necesidad expresada en lenguaje corriente y termina con un módulo funcionando de verdad en una instancia de Odoo de pruebas.
Conectar el conector
Aidoo Modules tiene su propio conector MCP, distinto del que accede a tus datos de Odoo. Requisito previo: una conexión de Odoo activa en Aidoo AI, de la que Aidoo deduce la edición y la versión de tus módulos.
Añade el conector en Claude
Igual que con Aidoo AI: Ajustes → Conectores → Añadir conector personalizado, con la URL del conector de Modules. La autenticación se hace por OAuth, sin ninguna clave que copiar.
Autoriza el espacio de trabajo
Se te redirige a Aidoo, eliges el espacio y autorizas. El conector obtiene entonces una clave de la familia dedicada a los módulos, sin ningún acceso a tus datos de Odoo.
Cada proyecto muestra su estado, su nombre técnico, la edición y la versión de Odoo a las que apunta, y su número de archivos. Arriba está la sandbox compartida del entorno: un único Odoo de pruebas donde conviven todos los módulos activados. La página Sandbox del menú Modules resume el estado de la sandbox de cada entorno (Producción, Preproducción) y los módulos instalados en ella.
Describir la necesidad
Es el paso que determina la calidad del resultado. Hay tres cosas que precisar.
Qué hace, desde el punto de vista del usuario. No «añade un campo many2one», sino «cada pedido debe vincularse a una obra, y hay que poder filtrar los pedidos por obra».
Dónde se ve. En qué vista, en qué parte de la pantalla, con qué columnas en la lista. Sin esa precisión, el campo existirá sin ser visible donde lo esperas.
Las reglas de negocio. Obligatorio o no, valor por defecto, quién puede modificarlo y qué ocurre cuando el registro cambia de estado.
Crea un módulo «Gestión de obras». Añade un modelo Obra con un código, un nombre, un cliente y una fecha de fin prevista. Los pedidos de venta y las facturas pueden vincularse a una obra; el campo es visible en la lista y filtrable. Añade una pantalla de seguimiento que muestre, por obra, el total pedido y el total facturado.
Qué hace Claude
Lee la estructura de tu Odoo
Los modelos implicados, sus campos reales y sus relaciones. Por eso el módulo generado encaja con tus personalizaciones existentes en lugar de partir de un Odoo estándar. Para ver el punto de partida estándar, recorre por ejemplo la ficha res.partner de nuestro explorador.
Crea el esqueleto
Manifiesto, árbol de directorios, archivos base. La edición y la versión de Odoo se deducen de tu conexión, no tienes que indicar nada.
Escribe los archivos
Modelos Python, vistas XML, permisos de acceso, datos de demostración. Cada archivo se contrasta con las reglas de sintaxis de tu versión de Odoo, y cualquier advertencia se corrige antes del despliegue. Ves cada archivo a medida que avanza y puedes pedir una corrección en cualquier momento.
Despliega en una sandbox
Se aprovisiona una instancia de Odoo efímera, se instala tu módulo en ella y recibes una URL de acceso.
Seguir el despliegue
La instalación tarda unos minutos. Claude consulta los registros y te dice en qué punto está el aprovisionamiento, y luego si la instalación ha funcionado. Ante un error de Python o XML, lee la traza y lo corrige por sí mismo.
Probar de verdad
Este es el paso que no conviene despachar deprisa
Un módulo que se instala sin errores no es un módulo que haga lo que quieres. Abre la sandbox, crea registros y sigue tu flujo real de principio a fin.
La ficha de un módulo tiene tres pestañas: la principal (sandbox de pruebas, paso a producción, medios), la del código (versiones de Odoo, archivos y editor) y la de Odoo Store (ficha de publicación).
Todo parte de la tarjeta Sandbox de pruebas, en la pestaña principal. «Abrir la sandbox» te conecta automáticamente al Odoo de pruebas, sin credenciales que teclear. «Logs» sigue la instalación en directo, y «Actualizar este módulo» reinstala solo este módulo, sin tocar los demás del entorno.
La pestaña del código muestra el árbol de archivos y su contenido: el manifiesto, los modelos, las vistas y los permisos de acceso. Es lo que ha escrito Claude, legible y modificable a mano.
Lo que hay que comprobar:
- el campo aparece donde lo necesitas, no solo en el formulario
- los filtros y las agrupaciones funcionan en la vista de lista
- las reglas de negocio se disparan en el momento adecuado
- no se ha roto nada en las pantallas estándar cercanas
- los permisos de acceso coinciden con tus perfiles de usuario
Cuando algo no encaje, descríbelo sin más:
El campo obra no aparece en la vista de lista de las facturas, y me gustaría poder agrupar por obra desde el menú Agrupar por.
Claude corrige y vuelve a desplegar. Cada modificación devuelve el proyecto a borrador: se exige una nueva prueba antes de cualquier despliegue en producción.
Capturas de pantalla y vídeo
Cuando la sandbox está lista, la tarjeta Medios (beta) de la pestaña principal genera capturas de pantalla y un vídeo de las pantallas del módulo: «Generar», eliges fotos, vídeo o ambos, e indicas si quieres qué mostrar. Cuenta alrededor de un minuto. Claude también puede lanzarlas:
Haz capturas del seguimiento por obra, con los totales pedidos y facturados.
Las capturas se suman a la galería del módulo y pueden ilustrar su ficha en la Odoo Apps Store.
Adaptar el módulo a otra versión de Odoo
En la pestaña del código, el botón para añadir otra versión copia el código de la versión mostrada a otra versión de Odoo (de 16.0 a 19.0) y ajusta el número de versión del manifiesto. No se adapta nada automáticamente: Aidoo señala los archivos cuya sintaxis no encaja con la versión de destino, y Claude hace la adaptación.
Adapta el módulo Gestión de obras a Odoo 18.
Cada versión tiene su propia pestaña. Modificar una variante no devuelve la versión base a borrador. La sandbox de pruebas instala la versión base del módulo.
El icono del módulo
Un módulo de Odoo tiene un icono en el menú de Aplicaciones. Puedes pedir uno, elegido de una biblioteca de iconos de negocio con un color de fondo, o cambiarlo haciendo clic en el icono en la parte superior de la ficha del módulo. Es común a todas las versiones del módulo.
Ponle al módulo un icono de obra en naranja.
Cuánto cuesta
Cada instalación o actualización de un módulo en la sandbox cuesta 25 créditos, tomados del fondo compartido con los agentes. Escribir archivos, leer el esquema y hacer capturas no cuesta nada más allá de la propia conversación.
En la práctica, un módulo sencillo requiere entre dos y cuatro despliegues hasta quedar a punto: calcula alrededor de cien créditos.
Una sandbox a la vez durante la prueba
La prueba gratuita permite una sola sandbox simultánea y tres proyectos de módulo, sin despliegue en producción. El plan Standard lo eleva a tres sandboxes y proyectos ilimitados.
Siguiente paso
- GitHub y puesta en producción: versionar el módulo e instalarlo en tu Odoo real