Conecta Odoo con Claude

Le das a Claude acceso en vivo a tu Odoo: preguntas en el chat y responde con tus datos reales. Tres pasos, unos 20 minutos, sin exportar nada.

Lee facturas, clientes y pedidos Solo lectura si así lo dejas Vía la API oficial de Odoo
Claude Aquí haces la pregunta
mcp-server-odoo Corre en tu computadora y traduce entre los dos
Odoo Tus datos, donde ya viven

Lo que necesitas

ERP
Odoo 16.0 o superior
Online o en tu servidor, da igual
Asistente
Claude Desktop
La app de escritorio, no el navegador
Permisos
Administrador en Odoo
Para instalar el módulo una sola vez

Cómo conectarlo

Tres pasos. Copia los comandos tal cual y cambia solo lo que está en MAYÚSCULAS.

1

Prepara Odoo y saca la API key

Dentro de Odoo
  1. En Aplicaciones, busca MCP Server e instálalo. Es un módulo oficial del listado de Odoo Apps.
  2. Ve a Ajustes → MCP Server → Enabled Models y agrega solo lo que quieres que la IA vea. Para empezar: res.partner (clientes), account.move (facturas) y sale.order (pedidos). Deja marcado únicamente read.
  3. Ve a Ajustes → Usuarios y compañías → Usuarios, abre tu usuario, entra a la pestaña API Keys y genera una. Cópiala ahora: Odoo no vuelve a mostrarla.

Para confirmar que el módulo quedó vivo, abre esta dirección en el navegador. Debe responder, no dar 404:

https://TUEMPRESA.odoo.com/mcp/health
2

Instala uv en tu computadora

Es lo que descarga y corre el servidor. Una línea en la terminal, una sola vez.

macOS o Linux — Terminal
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows — PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Cierra la terminal y ábrela de nuevo al terminar. Si no, el sistema todavía no lo encuentra.

3

Pega la configuración en Claude

Claude Desktop
  1. Abre Ajustes → Desarrollador → Editar configuración. Se abre el archivo claude_desktop_config.json.
  2. Pega esto y reemplaza los tres valores en mayúsculas por los tuyos.
{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://TUEMPRESA.odoo.com",
        "ODOO_API_KEY": "LA_API_KEY_QUE_COPIASTE",
        "ODOO_DB": "NOMBRE_DE_TU_BASE"
      }
    }
  }
}

Cierra Claude por completo y vuelve a abrirlo. Cuando arranque, el ícono de herramientas en la caja de mensaje debe mostrar las de Odoo. Ahí ya está conectado.

Cómo se ve al terminar

Claude Odoo conectado
¿Cuánto le facturamos a Constructora del Este en julio?
search_records · account.move
En julio le facturaste RD$ 1,847,200 en 6 facturas. Dos siguen sin pagar, por RD$ 612,000, y la más vieja lleva 34 días vencida.
¿Cuáles son las dos que faltan?
La FAC/2026/0412 del 3 de julio por RD$ 380,000, vencida hace 34 días, y la FAC/2026/0455 del 21 de julio por RD$ 232,000, que vence el jueves.

No hay que aprenderse los nombres de los modelos ni escribir filtros. Preguntas como le hablarías a alguien de tu equipo, y responde con lo que hay en tu Odoo en ese momento.

Si algo no arranca

Lo que vesQué hacer
spawn uvx ENOENT Claude no encuentra uv. Corre which uvx en la terminal y pon la ruta completa que te devuelva en "command", en vez de uvx.
Access Denied al conectar Tu Odoo no deja listar bases de datos. Es normal: asegúrate de tener ODOO_DB con el nombre exacto de la tuya.
Conecta pero no encuentra nada Falta habilitar los modelos. Vuelve a Ajustes → MCP Server → Enabled Models y agrégalos.
i
Sobre los permisos: la API key hereda exactamente lo que ese usuario de Odoo puede ver. Si quieres acotar más, crea un usuario aparte con acceso solo a lo que necesitas y genera la key desde ahí. Es lo que hago en producción.
i
¿Y con ChatGPT? Es el mismo servidor. Cambia solo dónde pegas la configuración: en ChatGPT se agrega desde Ajustes → Conectores, en los planes que soportan MCP.

Preguntas frecuentes

¿Necesito saber programar?

No. Instalas un módulo desde Odoo Apps, copias una API key y pegas un bloque de configuración. El único comando de terminal es el instalador de uv, que se copia y se pega tal cual.

¿La IA puede borrar datos de mi Odoo?

Solo si se lo permites. En Ajustes → MCP Server cada modelo se habilita por separado con permisos de lectura, escritura, creación y borrado. Si dejas únicamente lectura, no hay forma de que modifique nada. Y la API key nunca puede más que el usuario de Odoo al que pertenece.

¿Funciona con Odoo Online o solo self-hosted?

Con los dos, siempre que sea Odoo 16.0 o superior. En Odoo Online el módulo se instala desde Aplicaciones como cualquier otro.

¿Mis datos se usan para entrenar el modelo?

No. El servidor corre en tu computadora y habla directo con tu Odoo. Los datos entran a la conversación solo cuando el asistente consulta algo, y en los planes de pago de Claude el contenido de las conversaciones no se usa para entrenamiento.

¿Sirve igual para ChatGPT?

Sí. Es el mismo servidor MCP; cambia solo dónde pegas la configuración. En ChatGPT se agrega desde Ajustes → Conectores, en los planes que soportan MCP.

Alejandro Miranda, Forward Deployed Engineer

¿Prefieres que lo deje andando y listo?

Llevo 16 años metido en operaciones de PyMEs. Si quieres saltarte la parte de configurar y que además quede acotado a lo que tu equipo de verdad necesita consultar, lo monto contigo en una sesión.

Agenda una llamada de diagnóstico
Actualizado el 5 de agosto de 2026.