Servidor MCP¶

Con el servidor MCP habilitado, su base de datos de Odoo puede conectarse a aplicaciones de IA externas que hablan el Model Context Protocol, como Claude, ChatGPT o un editor de código con IA. La aplicación puede entonces buscar y leer los datos que su usuario ve en Odoo y, con confirmación, proponer cambios, desde la propia aplicación que la persona ya utiliza.

Nota

Es la dirección opuesta a IA ‣ Configuración ‣ Proveedores ‣ Servidores MCP, donde Odoo llama a herramientas de otros servidores (véase Configuración). Aquí Odoo es el servidor.

Habilitar el servidor¶

Instale los módulos AI MCP Gateway (y, para usuarios del portal, AI MCP Gateway - Portal).
Abra IA ‣ Configuración ‣ Ajustes, busque el bloque Servidor MCP y actívelo. El ajuste está desactivado por defecto.
Copie la dirección de URL del servidor MCP. Es la dirección de su Odoo seguida de /mcp y es lo que pega en la aplicación de IA.

Importante

Las aplicaciones de IA llaman al servidor sin cookie de sesión, por lo que Odoo debe seleccionar esta base de datos solo a partir del nombre de host. Si el servidor sirve varias bases de datos, configure su opción dbfilter para que este nombre de host seleccione únicamente esta base de datos (por ejemplo ^%d$ con una base de datos por subdominio), o sirva una sola base de datos. Si no es así, la página de ajustes muestra una advertencia y las aplicaciones reciben «404 Not Found».

Conectar una aplicación de IA¶

En la aplicación de IA, añada un conector personalizado o servidor MCP y pegue la URL del servidor.
La aplicación abre una página de inicio de sesión de Odoo. Inicie sesión con su propia cuenta. Solo pueden conectarse los usuarios internos del grupo IA: Usuario, y el grupo se vuelve a comprobar en cada petición.
Una página de consentimiento indica qué aplicación quiere conectarse, qué podrá hacer (Solo lectura o Leer y proponer cambios) y qué herramientas puede utilizar. Haga clic en Permitir o Rechazar. El consentimiento se pide cada vez que una aplicación se conecta.

Internamente la conexión usa OAuth 2.1 con PKCE. Los tokens de acceso son de corta duración y los de renovación rotan en cada uso; solo se almacenan hashes. Los clientes con scripts pueden usar alternativamente una clave de API de Odoo como token bearer, si Aceptar claves API de Odoo está activado.

Aplicaciones conectadas y desconexión¶

Cada usuario ve sus propias conexiones en sus Preferencias, en la pestaña Aplicaciones de IA conectadas, con la fecha de conexión y el último uso. Desconectar surte efecto de inmediato.

Los administradores ven todas las conexiones en IA ‣ Configuración ‣ Servidor MCP ‣ Aplicaciones de IA conectadas (con Revocar) y las aplicaciones registradas en IA ‣ Configuración ‣ Servidor MCP ‣ Aplicaciones de IA. Revocar un token de renovación revoca toda la conexión.

Qué herramientas se exponen¶

El servidor no entrega todo lo que puede hacer el asistente. Ofrece una lista de herramientas permitidas que se sabe que respetan la confirmación, filtrada por las capacidades del propio usuario:

Leer y consultar: buscar, leer, agrupar y agregar registros, describir campos, buscar en la documentación de los modelos, leer el entorno, enumerar acciones y habilidades permitidas y usar una habilidad, calcular fechas, leer adjuntos, enumerar menús, buscar en la memoria, buscar y obtener páginas web (si la capacidad Web access está activada).
Modificar (solo si la capacidad Escritura, Borrado o Acciones de negocio está activada): crear, actualizar y eliminar registros, llamar a una acción de negocio permitida, obtener un archivo en un campo.

No se exponen, sean cuales sean las capacidades: guardar u olvidar recuerdos, crear o ejecutar automatizaciones, cambiar vistas, campos o modelos, generar imágenes y las herramientas del constructor web. Un token con solo acceso de lectura ve únicamente las herramientas de lectura. Cada llamada a una herramienta se ejecuta como el usuario, con las mismas reglas de acceso, comprobaciones de política y auditoría que el asistente dentro de Odoo.

Cambios realizados por aplicaciones de IA¶

Por defecto se aplica Pedir siempre confirmación: cada conexión tiene su propia conversación («MCP: nombre de la aplicación») y cada creación, modificación, borrado o acción se convierte en una propuesta que usted aprueba en el panel de IA (véase El panel de IA). La alternativa Seguir los ajustes de escritura de la IA usa en su lugar el modo de escritura global. Cada llamada a una herramienta se anota en el registro de IA como llamada MCP y cuenta para los límites de frecuencia.

Elija el comportamiento en el ajuste Cambios realizados por aplicaciones de IA.

Registro de aplicaciones¶

Hay dos formas de dejar entrar a una aplicación.

Usted mismo la registra en IA ‣ Configuración ‣ Servidor MCP ‣ Aplicaciones de IA: el Nombre de la aplicación que se muestra en la página de consentimiento y las URI de redirección permitidas. Use Generar secreto para una aplicación confidencial (el secreto se muestra una sola vez) o Hacer público (solo PKCE) para aplicaciones que no pueden guardar un secreto.
O bien usted activa Permitir el registro dinámico de clientes y las aplicaciones se registran solas. Está desactivado por defecto. Los usuarios siguen iniciando sesión y aprobando cada conexión, pero el registro está limitado:
- por dirección de red (Registros por dirección y hora, 10 por defecto). Más allá, la aplicación recibe «Too many app registrations from this address»;
- una aplicación puede registrar como máximo 10 URI de redirección, cada una de como máximo 2048 caracteres, en una solicitud de como máximo 16 KB;
- cada URI de redirección debe coincidir con uno de los Patrones de URI de redirección permitidos (véase más abajo);
- se aceptan como máximo 1000 aplicaciones autorregistradas (el parámetro del sistema ai_mcp_gateway.dcr_max_clients). Las aplicaciones que nunca se conectaron y son más antiguas que el tiempo de limpieza indicado a continuación no cuentan; y
- una aplicación que se registró por sí sola y nunca se conectó se elimina mediante un trabajo planificado tras 72 horas (el parámetro del sistema ai_mcp_gateway.dcr_unused_client_hours).
Un error de autorización detectado antes de la página de consentimiento (por ejemplo, la falta de un desafío PKCE) no se devuelve a una aplicación autorregistrada: se le muestra a usted en una página de error, para que una aplicación sin revisar no pueda usar el servidor para redirigirle a otro sitio. Después de la página de consentimiento, su propio Rechazar siempre se devuelve a la aplicación, como espera el protocolo. Las aplicaciones que usted mismo registró reciben sus errores como de costumbre.

Más ajustes en el bloque Servidor MCP: Duración de los tokens (minutos del token de acceso y días del token de actualización) y Orígenes de navegador permitidos para aplicaciones basadas en navegador.

Reglas de las URI de redirección¶

Los sitios a los que la aplicación de IA puede devolverle tras iniciar sesión están restringidos por los Patrones de URI de redirección permitidos. Toda URI de redirección, ya la introduzca usted o la registre una aplicación, debe coincidir con uno de los patrones (separados por espacios o comas). Un patrón tiene la forma scheme://host[:port][/path]:

el host es un nombre literal, * para cualquier host, o *.example.com para exactamente una etiqueta más delante de example.com (a.example.com, no a.b.example.com);
el puerto es un número o * para cualquier puerto. Sin puerto, la dirección no puede indicar ninguno (salvo el puerto predeterminado del esquema);
la ruta está vacía (cualquier ruta), es una ruta fija (coincidencia exacta) o termina en /* (esa ruta y todo lo que hay debajo);
nada más es un comodín, y * nunca se extiende sobre una /.

Por ejemplo, https://claude.ai/api/* solo permite las direcciones situadas bajo esa ruta. Los patrones por defecto aceptan cualquier dirección https:// y las direcciones de bucle local (127.0.0.1, localhost y [::1]) que usan las herramientas de escritorio.

Con independencia de los patrones, una URI de redirección debe ser absoluta, no debe contener fragmento ni información de usuario, no debe usar los esquemas javascript, data, file o vbscript, y http sin cifrar solo se permite para direcciones de bucle local. Las URI con segmentos de punto o espacios nunca coinciden. Cuando una aplicación pide que se la redirija a una URI, esta debe ser exactamente igual a una registrada; solo el puerto de una dirección http de bucle local registrada puede diferir.

Usuarios del portal¶

Con el módulo de portal y el ajuste Los usuarios del portal pueden conectar aplicaciones de IA (desactivado por defecto), los usuarios del portal también pueden conectar aplicaciones de IA desde la página «Mis aplicaciones de IA» del portal. Solo obtienen las herramientas de búsqueda, lectura y agrupación, de solo lectura, y únicamente para modelos que tengan una regla de permiso de lectura explícita en un grupo de acceso de IA al que pertenezcan. Un grupo vacío incluido, Usuarios del portal (MCP), está asignado a todos los usuarios del portal para ese fin. Los permisos propios del portal de Odoo se siguen aplicando por debajo.

Límites¶

El servidor no tiene estado y responde a peticiones individuales: sin streaming, sin mensajes iniciados por el servidor, sin recursos ni prompts.
Las aplicaciones se identifican por registro (el suyo o dinámico), no por un documento de identidad de cliente basado en URL.
Un usuario archivado, retirado del grupo de IA o bloqueado pierde el acceso en la siguiente petición.