Conexión y descubrimiento¶

Antes de operar contra una instancia nueva, identifica su versión, edición y despliegue. La capa de compatibilidad usa estos datos para resolver nombres de modelos y campos, así que casi nunca necesitas ramificar tus consultas por versión.

1. Identificar el entorno¶

Llama a odoo_version. Devuelve:

version — entero mayor (10–19)
raw_version — la cadena de versión completa reportada por Odoo
edition — community | enterprise | unknown
deployment — onprem | saas
transport — el transporte activo (jsonrpc en auto, o xmlrpc tras un fallback)

2. Chequeo de salud con /odoo-doctor¶

El comando /odoo-doctor hace un diagnóstico completo, sin escribir nada:

Llama a odoo_version y reporta versión / edición / despliegue / transporte.
Llama a odoo_connections y lista las sesiones activas.
Hace una lectura acotada de prueba: odoo_search_read { "model": "res.partner", "fields": ["name"], "limit": 1 }.
Si algún paso falla, indica el error exacto y te dirige a /odoo-tools:odoo-setup-mcp (o odoo-setup-cli).

3. Explorar el esquema¶

Cada instancia difiere. Antes de consultar campos que no conoces:

odoo_list_models — lista los modelos instalados, opcionalmente filtrando por un fragmento de nombre (like).
odoo_fields_get — devuelve las definiciones de campos de un modelo (con caché). Acepta nombres históricos o modernos; la capa de compatibilidad resuelve al correcto.
odoo_module_info — estado de instalación y metadatos de un módulo por su nombre técnico (útil para saber si un módulo Enterprise está presente).

Ejemplo: descubrir los campos de contactos¶

odoo_fields_get {
  "model": "res.partner",
  "attributes": ["string", "type", "required"]
}

4. Elegir la superficie correcta¶

Si uvx o Python 3.11+ están disponibles → servidor MCP (todas las herramientas + compatibilidad).
Si solo tienes Node → CLI de respaldo (ver CLI de respaldo).

Continúa con la Referencia de herramientas.