PNS AI Engine

El dolor

IA para tus clientes como un módulo más. Código abierto, sin licencias. No un servicio al lado que conectas cliente a cliente. Una IA que se instala, se actualiza y se desinstala como cualquier otro módulo, en el Odoo que el cliente ya tiene. Aquí los agentes viven en módulos normales de Odoo.

Qué te llevas

Agentes que son Odoo

• Un agente es un registro que trae un módulo. Instalas el módulo y el agente está; lo desinstalas y se va.
• Cada agente tiene su propia lista de proveedores, en el orden que tú pongas.
• Todo está en la base de datos del cliente: no hay una segunda copia en otro sitio.

Proveedores para cada tarea

• OpenAI y cualquier servicio compatible con OpenAI, Anthropic, OpenRouter. También un modelo local (Ollama, LM Studio) en el propio servidor del cliente.
• Roles por proveedor: conversación, audio, imagen, vídeo, maquetar una página, pasar una frase a los campos de un skill, decisiones de sí o no.
• Si un proveedor falla, responde el siguiente de la lista.
• La clave se queda en la base de datos del cliente, nunca en el módulo.

Una caja de arena y una persona

• El código que escribe la IA lee en una transacción de solo lectura, con los permisos de quien preguntó.
• Un cambio en Odoo es un plan que espera a que una persona lo apruebe en Odoo.
• Cada llamada queda registrada: cada usuario ve su actividad, el administrador la de todos.
• Direcciones de fuera, solo las de una lista blanca que tú mantienes.

Conocimiento tuyo

• Contextos: las palabras, reglas y costumbres del cliente, editadas en Odoo.
• Skills: procedimientos que se escriben una vez y se lanzan por su nombre. Sus tablas y gráficos salen del código, no de la IA.
• Exportas toda la configuración de IA de un cliente a un fichero y la importas en el siguiente.

Un servidor MCP en el Odoo del cliente

• Cursor y otros clientes MCP se conectan a /mcp con una clave personal.
• Ninguna contraseña de administrador sale de Odoo. Cada clave lee con los permisos de su usuario.
• Piensa el modelo del propio cliente MCP; Odoo responde a sus llamadas. Para eso no hace falta proveedor.

Nada que licenciar

• Apache 2.0. Sin cuota por usuario, por base de datos ni por año.
• Un módulo de Odoo normal: sin servidor externo que mantener.
• El mismo módulo en todos los clientes de una versión soportada.

Agentes, roles y cadenas

Qué es un agente. Cualquier cosa de Odoo que use IA: un chat, un asistente de voz, un punto MCP, un trabajo que corre por detrás. En el motor es un registro (Motor de IA → Agentes) con un código, sus contextos, sus skills y su lista de proveedores.

Lo natural es que un agente venga con el módulo de Odoo que lo necesita: instalas el módulo y el agente está; lo desinstalas y se va. Un módulo puede traer más de uno. Este motor trae dos:

• MCP Server (pns_ai_mcp) da contextos y herramientas a un cliente de fuera, como Cursor. El modelo corre en ese cliente; Odoo contesta a sus llamadas.
• AI Admin (pns_ai_admin) hace los trabajos del propio motor: escribir un skill, leer la documentación de una API.

Chatboo trae el agente del chat. También se puede crear un agente a mano en Odoo.

Dos tipos. Inferencia: Odoo llama al modelo, con los proveedores del agente (un chat, un asistente de voz). Endpoint: el modelo está fuera y Odoo solo le sirve (MCP).

Roles. Un rol dice para qué sirve un proveedor. Un proveedor puede tener varios.

La cadena. Cada agente tiene sus proveedores, en el orden que pongas. Cuando un turno necesita un rol, el motor toma los proveedores de ese agente que lo tienen, en ese orden. Si uno falla o se queda colgado, contesta el siguiente.

• Cada enlace tiene sus tiempos de espera: segundos sin datos y segundos para una ronda entera.
• Un proveedor que solo tiene ese rol va antes que los que hacen de todo: se eligió para eso.
• Si la cadena no tiene a nadie para un rol que no sea Conversación, el motor busca entre todos los proveedores activos.
• Sin failover externo corta la cadena en ese proveedor. Sirve para un modelo local cuyos datos no deben salir.
• Una clave que llegó a su tope de gasto del mes se salta.
• Un agente sin cadena usa todos los proveedores activos.

Por ejemplo: un modelo grande para la conversación, uno pequeño solo con Parser, y un modelo local al final de la cadena como respaldo.

Qué trae el módulo

Leído de los propios ficheros del módulo, versión 3.1.931. Las descripciones van en inglés, como en el módulo.

Contextos

Proveedores de ejemplo

En static/examples/providers/, sin clave.

Qué no hace

• Sin pantalla de chat. El motor no trae ventana de conversación para los usuarios. Eso es Chatboo.
• No escribe por su cuenta. La IA nunca cambia Odoo sola. Cada cambio es un plan que aprueba una persona en Odoo.
• Cuatro protocolos de proveedor. Compatible con OpenAI, OpenRouter, Anthropic y SystemOne (decisiones de sí o no). Una API que no hable ninguno no se conecta.
• Dos versiones probadas. 14.0 y 19.0. De la 15.0 a la 18.0 construyes tú el módulo y lo pruebas antes; la 13.0 y anteriores no funcionan (ver Versiones de Odoo).

Preguntas

¿Es un servidor MCP? Lo incluye, en el mismo módulo. POST /mcp habla Streamable HTTP. /mcp/sse con /mcp/message es para clientes que solo hablan SSE. /mcp/<agente> ata la llamada a un agente. Tres herramientas: relaxaicode (Python de solo lectura contra Odoo), safe_plan_request (proponer un cambio) y safe_plan_status (ver si se aprobó).

¿Adónde van los datos del cliente? A los proveedores que configures, y a las direcciones de fuera y servidores de API que permitas. Cuando se conecta Cursor u otro cliente MCP, su propio modelo ve lo que devuelven las herramientas.

¿Necesito Chatboo? No. El motor solo ya sirve a clientes MCP. Chatboo añade el chat dentro de Odoo y trae el motor con él.

¿Qué es pns_base? La capa común de los módulos PNS: las mismas pantallas cargan en Odoo 14 y 19, y trae utilidades pequeñas (avisos, importar y exportar, PDF). Se instala como dependencia.

Puesta en marcha

1. Instala. ¿Quieres también el chat? Instala Chatboo; trae este módulo. Solo el motor: clona la rama 14.0 o 19.0 de pns_base y de pns_ai_mcp, añade cada clon al addons_path e instala PNS AI Engine desde Aplicaciones. En Odoo 14, antes, pip install "openpyxl>=3.1.2".
2. Hazte administrador de IA. Ajustes → Usuarios: date IA Administrador. Sal y vuelve a entrar.
3. Saca tu clave API. Motor de IA → Seguridad → Usuarios: tu fila, marca IA Conversacional y pulsa Generar Clave API.
4. Pon un proveedor. Motor de IA → Conexiones → Proveedores: protocolo, dirección, clave API y modelo, con el rol Conversación. O parte de uno hecho: en static/examples/providers/ están OpenRouter, OVH, OpenAI, Anthropic y Lemonade, sin clave. Ajustes → Motor de IA → Importar configuración, eliges el fichero y escribes tu clave en cada proveedor.

Listo. Apunta Cursor (o cualquier cliente MCP) a https://<tu-odoo>/mcp con la clave en la cabecera X-MCP-API-Key. Ejemplo más abajo, en Conectar un cliente MCP.

Para el equipo de IT

Conectar un cliente MCP

En Cursor, añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un proyecto). Los demás clientes MCP piden lo mismo: la dirección y la cabecera.

{
  "mcpServers": {
    "odoo-de-mi-cliente": {
      "url": "https://odoo.example.com/mcp",
      "headers": {
        "X-MCP-API-Key": "<tu-clave-api>"
      }
    }
  }
}

La clave es la del paso 3 y lee con los permisos de ese usuario. Una clave por persona; no subas a git el fichero con la clave dentro.

Estructura del repositorio

main es un solo árbol para todas las versiones. Una rama plana (14.0, 19.0) es ese árbol construido para una versión, listo para el addons path.

El instalador copia common/ y encima la pila; si un fichero está en los dos, gana el de la pila. Lo común se edita solo en common/. El módulo plano de una versión se construye con ./install_flat.sh 19.0 /ruta/a/addons. Utilidades de interfaz del dominio: utils/mcp_ui.py.

Python: no añadas requests ni reportlab (ya vienen con Odoo). pns_base no necesita nada de pip. En la 14, usa un openpyxl reciente (los antiguos fallan con NumPy moderno).

Versiones de Odoo

De la 15.0 a la 18.0. No hay rama que clonar. Construye tú el módulo plano desde main, que tiene el código de todas las versiones (owl2 para la 15.0 y siguientes). Lo mismo con pns_base:

git clone https://github.com/patanegra-soft/pns_base.git
git clone https://github.com/patanegra-soft/pns_ai_mcp.git
cd pns_base   && ./install_flat.sh 17.0 /ruta/a/addons && cd ..
cd pns_ai_mcp && ./install_flat.sh 17.0 /ruta/a/addons

El script avisa de que esa versión no está probada. Nadie ha usado el motor en estas versiones: pruébalo antes en una base de pruebas y pasa ahí los tests de Odoo (ver Tests). Si funciona, o si no, cuéntanoslo (CONTRIBUTING.md).

Odoo 13 no tiene OWL, sobre el que está hecho el chat. De Odoo 8 a 12 usan un Python anterior al 3.7, que es el que necesita el motor. La suite mantiene dos pilas (owl1 para la 14.0 y owl2 para la 15.0 y siguientes).

Tests

odoo-bin -d <db> -i pns_ai_mcp --test-enable --stop-after-init --test-tags /pns_ai_mcp

Licencia, marcas, entrenamiento

Apache-2.0: ver LICENSE y NOTICE. PATANEGRA Soft™ y PAAP™ (Patanegra Application Agent Protocol, que implementa este motor) son marcas de PATANEGRA Soft SL; la licencia no las concede. Se permite la minería de textos y el entrenamiento de IA (TDMRep tdm-reservation = 0).

Seguridad: SECURITY.md. Errores, ideas y preguntas: CONTRIBUTING.md.