Solución de problemas y preguntas frecuentes¶
Encabezados en forma de pregunta para que encuentres tu caso rápido.
¿Por qué mi API key deja de funcionar en Odoo 17 o superior?¶
A partir de Odoo 17, el endpoint /jsonrpc rechaza las API keys. El servidor
lo detecta y hace fallback automático a XML-RPC (fija XML-RPC tras el primer
fallback y avisa una vez). No necesitas hacer nada; si quieres forzarlo, define
ODOO_TRANSPORT_PREF=xmlrpc.
Recibo "database not found"¶
El nombre de la base de datos es incorrecto. Revísalo en Settings → Database o
en la URL de login. ODOO_DB debe coincidir exactamente.
Un campo aparece en dropped_fields y no en el resultado¶
Ese campo no existe en la versión destino. Es el comportamiento esperado: en
lugar de fallar toda la consulta, el servidor descarta el campo no disponible y
lo reporta. Consulta la tabla de Compatibilidad para el
nombre moderno equivalente (p. ej. analytic_account_id → analytic_distribution
en v16).
Obtengo un CompatError sobre un modelo Enterprise¶
Estás consultando un modelo exclusivo de Enterprise (p. ej. helpdesk.ticket,
sign.request) contra una instancia detectada como Community. El sondeo de
módulos en tiempo de ejecución es la autoridad: si el módulo no está instalado,
el modelo no está disponible.
¿Necesito API key o puedo usar contraseña?¶
- Odoo ≥ 14: usa una API key (recomendado), variable
ODOO_API_KEY. - Odoo < 14: no hay API keys; usa
ODOO_PASSWORD.
Define una de las dos.
uvx no está instalado¶
Instala uv (guía oficial)
o usa Python 3.11+ directamente: cd server && pip install -e . && python -m odoo_mcp.
No tengo Python, solo Node¶
Usa la CLI de respaldo: /odoo-tools:odoo-setup-cli (Node.js 18+).
¿Cómo verifico que todo quedó bien?¶
Corre /odoo-doctor o llama a odoo_version. Una respuesta con versión, edición,
despliegue y transporte confirma la conexión de extremo a extremo. Ver
Conexión y descubrimiento.
¿Los datos de mi empresa se envían a Anthropic?¶
No. El servidor corre en tu infraestructura y habla directamente con tu Odoo. Ver Seguridad.
¿Funciona con otros agentes además de Claude?¶
Sí: con cualquier cliente que implemente el protocolo MCP. Claude Code es el entorno de referencia para el que está empaquetado el plugin.