Documentación del Asistente IA y del Conector MCP para Odoo

Qué es

Son dos piezas que se instalan en tu Odoo y comparten el mismo motor. Las dos trabajan exactamente como la persona que las usa: con sus permisos, sus compañías y sus pantallas. Lo que no se ve en la pantalla de esa persona no existe para el asistente; lo que es de solo lectura no se escribe, y los botones que no se ven no se pulsan.

Ninguno de los dos aplica nada por su cuenta: todo cambio se ensaya primero y se aplica cuando la persona lo aprueba.

Volver al índice

Requisitos

• Odoo 16.0 o 18.0, Community o Enterprise.
• Dónde: en tu servidor o en el nuestro. No en Odoo Online, que no admite módulos propios.
• Servidor web: el proxy debe dejar pasar /mcp, /oauth/* y /.well-known/oauth-*; proxy_mode = True, para que las direcciones salgan en https; y una base de datos por dominio (dbfilter).
• Recursos: corre en los workers de Odoo, sin servicios aparte. El conector no añade dependencias de Python.
• Chat: si la base tiene queue_job, las respuestas van por su cola; si no, por una tarea programada de Odoo.
• Conector: una aplicación compatible con MCP, como Claude, ChatGPT en modo desarrollador, Claude Code, n8n o Cursor.

Volver al índice

Activarlo en tu Odoo

Lo instalamos y lo dejamos configurado nosotros. Estos son los pasos, para que sepas qué se toca:

1. Instalar el módulo como cualquier otro. Instalar no abre nada.
2. Ajustes > Asistentes IA > Asistentes activados. Hasta ese momento nadie puede conectarse.
3. Dar a cada persona su grupo: Asistentes IA: Usar (lectura) o Usar (lectura y escritura). Sin grupo, no puede ni conectarse. Si la base usa roles, el grupo se añade al rol.
4. Opcional: restricciones (botones o entradas del menú Acción que los asistentes no deben usar aunque la persona pueda), topes, lista de asistentes permitidos y la opción de borrar, que viene apagada.

Para el chat, en Ajustes > Asistentes IA > Asistente en el chat: se enciende, se eligen las personas que lo tienen (es el mismo grupo de lectura y escritura; con solo lectura, el chat queda en modo consulta) y, si se quiere, su nombre, su foto y un texto de Cómo se trabaja en esta empresa que el asistente lee siempre, por compañía. El modelo de lenguaje lo dejamos configurado. Va incluido en los paquetes. El uso del modelo lleva un tope por persona y al mes que fija tu empresa.

Volver al índice

Conectar Claude, ChatGPT u otro cliente MCP

Tres pasos, en cualquier aplicación:

1. Pegar la dirección de tu Odoo terminada en /mcp como conector personalizado.
2. Entrar con tu usuario de Odoo, en el login de tu Odoo y con su doble factor. La contraseña nunca sale de Odoo.
3. Dar el permiso, de solo lectura o de lectura y escritura.

Más contexto para quien lo va a usar, en conectar Odoo con Claude y ChatGPT.

Volver al índice

Las herramientas

Ocho herramientas, las mismas en cualquier base. Multiempresa: cada llamada puede indicar en qué compañías de la persona se trabaja.

El asistente del chat usa estas mismas herramientas y algunas propias: leer documentos, recordar cómo trabaja cada persona, consultar las fichas de conocimiento, preparar un borrador de correo, abrirte una lista en pantalla y programar tareas.

Los ficheros (un PDF impreso, un adjunto) no viajan dentro de la respuesta: se entrega un enlace de descarga propio de ese fichero, que caduca a los 15 minutos y deja de valer si se revoca la conexión.

Volver al índice

El ensayo antes de aplicar

Guardar, pulsar un botón y lanzar una entrada del menú Acción se hacen en dos tiempos: primero con confirm=false, que ensaya, y después con confirm=true, que aplica exactamente lo ensayado.

• Qué enseña: los campos que cambian (antes y después), las líneas que se añaden o se quitan, el total y lo que saldría fuera de Odoo: a quién iría un correo, envíos al SII, tareas en cola.
• Qué no pasa durante el ensayo: el correo, las llamadas HTTP y cualquier otra conexión de red se cortan, y la numeración no se consume.
• Qué comprueba: los campos obligatorios, los permisos y lo que ofrece la pantalla. Algunas validaciones que Odoo hace al guardar, como el formato de un NIF, solo salen al aplicar.
• Un caso que no se puede ensayar: si un módulo confirma la transacción a mitad de la operación, el ensayo se para ahí. Esa operación solo se puede hacer de verdad.

En el chat, el ensayo se enseña como una propuesta con Aplicar, Descartar y Ver en la ficha. Caduca a las 2 horas. La propuesta de un lote caduca antes, a los 25 minutos, para que no sobreviva al lote que la respalda, que dura 30 minutos (ver cambios en muchos registros). Así es la tarjeta (dibujo con datos ficticios):

Volver al índice

Cambios en muchos registros

odoo_lote no es otra forma de escribir: en cada registro llama a las mismas funciones que las herramientas sueltas (abrir, cambiar, guardar, pulsar o una entrada del menú Acción), con las mismas comprobaciones.

• El ensayo pasa por todos y dice cuántos salen bien, cuántos fallan y por qué, con ejemplos y lo que saldría fuera.
• Devuelve un lote que es lo único que se puede aplicar: solo esa persona y durante 30 minutos. En el chat, la propuesta de ese lote caduca a los 25, un poco antes que el lote. Un registro que cambie entre medias se salta.
• Cada registro va por su lado: si uno falla, los demás siguen.
• Repetir un lote no duplica: añadir un texto no lo repite y las etiquetas se añaden o se quitan.
• Admite un valor distinto en cada registro, como una tarifa que llega en un Excel, en un solo ensayo.
• También las filas de una tabla que se abren en su ficha, como los lotes de cada producto de un albarán.
• Los registros se recorren por fecha e id si el modelo tiene fecha: las facturas se numeran en el orden de su fecha.

Volver al índice

Qué queda cerrado

Aunque la persona sea administradora, los asistentes no tocan:

• Usuarios, grupos y permisos.
• Código: acciones de servidor, automatizaciones, tareas programadas, vistas y plantillas.
• Ajustes técnicos y módulos.
• Servidores de correo y claves. Los secretos salen tapados.
• Todo lo de los propios asistentes: conexiones, auditoría y, del chat, la memoria, el conocimiento, las propuestas y las tareas.

Además, quien administra puede cerrar botones o entradas del menú Acción concretos aunque la persona pueda usarlos, poner topes (resultados por búsqueda, registros por operación, acciones por sesión) y decidir si se puede borrar, que viene apagado.

Volver al índice

Rastro y auditoría

• Cada registro tocado lleva en su historial una línea como «Modificado a través de Claude (asistente IA, en nombre de Ana Gil).»
• Cada llamada queda en Asistentes IA > Actividad: quién, qué asistente, qué herramienta, qué registro, qué efecto y con qué resultado. Nadie la edita.
• El chat tiene además su registro de respuestas, con pasos, tiempos y uso del modelo, y el uso de cada persona en el mes.

Volver al índice

Cómo se revoca el acceso

• Una conexión: en Asistentes IA > Mis conexiones, cada persona ve las suyas y las revoca.
• Todas las de una persona: cambiar su contraseña, su doble factor o su login, o archivar el usuario, corta todas sus conexiones.
• Una persona: quitarle el grupo de Asistentes IA le quita el acceso con asistentes externos y el chat.
• Toda la base: apagar Asistentes activados en Ajustes.
• Tokens de asistente: caducan solos y se revocan igual que una conexión.

Volver al índice

El asistente en el chat de Odoo

Cada persona con el asistente tiene su chat privado con él en Conversaciones desde que entra en Odoo. Se abre con el botón del asistente, en la barra superior, con Ctrl+K («Preguntar al asistente: …») o desde Conversaciones. En escritorio se acopla a la derecha, sin tapar la pantalla de trabajo; en el móvil ocupa la pantalla entera.

• Documentos: PDF con texto o escaneados, fotos, Excel y CSV, Word y texto, hasta 25 MB por fichero. Lo que pone un documento son datos, nunca órdenes para el asistente.
• Voz: una nota de voz se transcribe y la transcripción se ve bajo el audio.
• Propuestas: nunca cambia nada solo. Prepara el cambio, lo ensaya y enseña la propuesta; la persona pulsa Aplicar o Descartar.
• Memoria: una nota por persona con cómo quiere que le conteste («recuerda que…», «olvida que…»). En Odoo nadie ve la memoria de otro, salvo quien administra los asistentes. Para contestarte, lo que le pides y lo que lee se envía al proveedor del modelo de IA que dejamos configurado, bajo contrato de encargado del tratamiento.
• Conocimiento: fichas de la persona y de la empresa (procedimientos, condiciones, manuales). Las de la empresa se dirigen por compañías, roles o personas.
• Tareas programadas: «cada mañana a las 8, resúmeme lo pendiente», «avísame cuando pague Pérez». Pueden avisar solo si hay algo. Nunca aplican nada: si hay que cambiar datos, dejan una propuesta.
• Precio: va incluido en los paquetes. El uso del modelo lleva un tope por persona y al mes que fija tu empresa.

Volver al índice

Estándares

• MCP Streamable HTTP, versiones 2026-07-28 (sin estado, server/discover) y 2025-11-25, 2025-06-18 y 2025-03-26 (con initialize), en el mismo endpoint. Siempre JSON, sin sesiones.
• OAuth 2.1 con PKCE S256 obligatorio: RFC 9728 (metadatos del recurso), RFC 8414 (metadatos del servidor), RFC 8707 (audiencia), CIMD y RFC 7591 (registro), RFC 9207 (iss), RFC 8628 (código de dispositivo) y RFC 7009 (revocación).
• Renovación de tokens que rota, con detección de reutilización (RFC 9700).

Volver al índice

Límites conocidos

• Solo Odoo 16.0 y 18.0. No se instala en Odoo Online.
• Algunas validaciones de Odoo solo salen al aplicar, no en el ensayo.
• Una operación que un módulo confirma a mitad no se puede ensayar.
• Los asistentes no administran Odoo: ver qué queda cerrado.
• Sin queue_job, las respuestas del chat van de una en una para toda la base.

¿Protección de datos? Cumple el RGPD y firmamos contigo el contrato de encargado del tratamiento. ¿Precio? Va incluido en los paquetes de implantación de Odoo en marcha; si ya tienes Odoo 16 o 18, te decimos cómo en la demo.

Volver al índice