Referencia de herramientas MCP
Las trece herramientas que Aidoo expone a tu asistente: qué hace cada una, qué permiso exige y si se concede por defecto.
5 min de lecturaActualizado el 7 de agosto de 2026
Aidoo expone tu Odoo en forma de herramientas. El asistente elige una, Aidoo comprueba que tiene derecho a usarla y ejecuta la llamada sobre tu base.
Esta página es el inventario completo. Cada herramienta enlaza con la página que la detalla.
La matriz completa
| Herramienta | Permiso | Por defecto |
|---|---|---|
| aidoo_query | query | Sí |
| aidoo_read | read | Sí |
| aidoo_schema | schema | Sí |
| aidoo_report | report | Sí |
| aidoo_print | print | Sí |
| aidoo_create | create | No |
| aidoo_write | write | No |
| aidoo_delete | delete | No |
| aidoo_execute | execute | No |
| aidoo_workflow | execute | No |
| aidoo_workflow_run | workflow | No |
| aidoo_feedback | feedback | No |
| aidoo_attach | attach | No |
Una clave API recién creada recibe los cinco permisos de lectura. Todo lo demás debe activarse explícitamente en Claves API.
Las herramientas de lectura
No pueden modificar nada: el vínculo herramienta → método de Odoo está bloqueado en el servidor, y aidoo_query solo sabe llamar a search_read y search_count.
Busca y lee registros. Es la herramienta más usada, la que responde a «qué presupuestos…», «cuántos clientes…», «la lista de facturas…».
Parámetros: model, domain (el filtro de Odoo), fields, limit (80 por defecto), offset, order. Devuelve los registros, pero también total_count y has_more, para que el asistente sepa que solo ve una página.
Lee registros cuyos identificadores ya se conocen. Más directo que aidoo_query cuando el asistente acaba de encontrar un id.
Descubre la estructura de tu base: la lista de modelos, o los campos de un modelo concreto con su tipo y sus relaciones. No lee ningún dato de negocio.
También es la herramienta que devuelve los hints: tus instrucciones de negocio asociadas a un modelo.
aidoo_reportPermiso report · activado por defectoAgrega sin traerse los datos. Agrupa por uno o varios campos y calcula una medida: facturación por mes, pendiente por comercial, cantidades por categoría.
Conviene preferirla siempre a aidoo_query cuando se trata de totales: Odoo hace el cálculo y solo viajan los resultados.
Genera un PDF mediante el motor de informes QWeb de Odoo y devuelve un enlace de descarga. Factura, presupuesto, albarán, orden de fabricación.
Se clasifica como solo lectura: produce un documento, no modifica ningún registro.
Las herramientas de escritura
Ninguna se concede por defecto. Lo que las acota son los permisos de tu clave, no un paso de confirmación adicional, consulta Escribir en Odoo.
aidoo_createPermiso create · hay que activarlo manualmenteCrea uno o varios registros. En modo por lotes, los registros salen en una sola llamada a Odoo, lo que preserva la coherencia.
aidoo_writePermiso write · hay que activarlo manualmenteModifica registros existentes. En modo por lotes, cada grupo de identificadores recibe sus propios valores, y el resultado detalla el éxito o el fallo de cada grupo.
aidoo_deletePermiso delete · hay que activarlo manualmenteElimina definitivamente: es el unlink de Odoo. Irreversible, sin papelera.
Concédelo con pleno conocimiento
delete es el único permiso que destruye información sin recurso. En la mayoría de los despliegues permanece desactivado: archivar un registro con aidoo_write cubre la misma necesidad y se puede deshacer.
Dispara una acción de negocio de Odoo, los botones de tus pantallas: confirmar un presupuesto, validar una factura, recibir una transferencia. Solo se aceptan los métodos con prefijo action_ o button_.
Llama a un método arbitrario de Odoo, para los casos que las demás herramientas no cubren. Los métodos que duplicarían una herramienta dedicada están bloqueados (create, write, unlink, read, search_read…), de modo que un permiso no pueda usarse para eludir otro.
Es la herramienta más potente del catálogo, y por tanto la que conviene conceder con mayor prudencia.
Las herramientas especializadas
Tres herramientas, una misma palabra
Tres herramientas llevan «workflow» en el nombre y hacen cosas totalmente distintas. Es la confusión más frecuente de todo el catálogo.
| Herramienta | Qué ejecuta | Permiso |
|---|---|---|
aidoo_workflow | Un botón de Odoo: confirmar un presupuesto, contabilizar una factura. Nada que ver con los flujos de Aidoo | execute |
aidoo_workflow_list | Nada. Lista tus flujos de Aidoo guardados | workflow |
aidoo_workflow_run | Un flujo de Aidoo: la secuencia de pasos que guardaste | workflow |
La línea divisoria: aidoo_workflow actúa dentro de Odoo, las otras dos actúan sobre lo que guardaste en Aidoo.
aidoo_workflow_run
Ejecuta un flujo de trabajo de Aidoo: una secuencia de pasos guardada una vez y repetida con una frase, con variables.
Un flujo guardado puede realizar operaciones que las herramientas individuales rechazarían: fuiste tú quien lo validó al crearlo.
El asistente invoca aidoo_workflow_list al inicio de la conversación para saber qué existe, y luego aidoo_workflow_run para ejecutar el que corresponda.
Actualiza el hint de un modelo cuando corriges al asistente. Es el mecanismo de aprendizaje de Aidoo, consulta Hints y aprendizaje.
Exige el permiso feedback y el derecho canUpdateHints en tu perfil de miembro.
Hace llegar un archivo a Odoo sin que pase por la IA: el asistente te da un enlace de envío de un solo uso, tú depositas el archivo y Odoo lo recibe. Sirve también para digitalizar facturas de proveedor.
Cómo elegir los permisos a conceder
Una progresión que funciona
Empieza en solo lectura durante una semana. Añade create cuando aparezca una necesidad concreta. Abre execute solo para un uso identificado, y mantén delete cerrado.
| Uso | Permisos |
|---|---|
| Consulta, informes, análisis | Los cinco permisos de lectura, por defecto |
| Introducción asistida (contactos, notas, actividades) | + create, write |
| Tratamiento de principio a fin (confirmar, validar) | + execute |
| Saneamiento de datos, correcciones masivas | + delete, de forma temporal |
Cada permiso se configura por clave y por entorno: puedes permitir la escritura en tu base de pruebas y denegarla en producción.
Lo que el asistente sabe antes de intentarlo
Al arrancar, aidoo_context devuelve la lista de herramientas realmente disponibles. El asistente sabe de antemano lo que no puede hacer y te lo dice, en lugar de intentar la operación y fallar.
Si te deniegan una acción que creías permitida, comprueba en este orden: el permiso de la clave, luego los permisos de la cuenta de Odoo, y por último los modelos bloqueados en Seguridad y permisos.