Ir al contenido

Cómo conectar Odoo con Claude Code o ChatGPT Codex de forma segura

Clave de API de un usuario con permisos limitados, guardada en Secrevo, y primeras consultas al endpoint /json/2 de Odoo 19, primero en una base de pruebas.
20 de noviembre de 2026 por
Cómo conectar Odoo con Claude Code o ChatGPT Codex de forma segura
Wilfredo Fernando Pastor Avila
| Todavía no hay comentarios

Antes de empezar

Un agente de IA como Claude Code o ChatGPT Codex puede consultar y operar tu Odoo como lo haría un usuario más: lee, filtra, crea y configura registros con los permisos del usuario cuya clave usa. Esta guía explica cómo hacer esa conexión sin entregarle la clave al agente y sin arriesgar tu operación. Es la misma conexión que usamos en nuestras implementaciones de Odoo con IA.

Necesitas:

  • Un Odoo con API externa: plan Personalizado (Custom), Odoo.sh u on-premise. El plan Estándar no la incluye; más abajo explicamos qué hacer en ese caso.
  • La aplicación de escritorio de Claude Code o de ChatGPT Codex, trabajando en tu computadora. En el chat en la nube el agente no puede ejecutar comandos en tu máquina.
  • Una cuenta en Secrevo para guardar la clave.
  • Una base de pruebas de Odoo, separada de producción, para los cambios de riesgo.

Paso 1: prepara una base de pruebas para los cambios de riesgo

Antes de pedirle a un agente un cambio de riesgo en producción, pruébalo en una copia. En Odoo.sh es la rama de staging, que tiene una copia de los datos de producción y en la que Odoo retiene los correos salientes y desactiva las tareas programadas. Si tu Odoo está en tu propio servidor, usa una copia de la base. Lo que el agente haga ahí se revisa antes de repetirlo en producción. Para las tareas cotidianas y de bajo riesgo, el agente también puede operar directamente en producción, con los permisos justos y con revisión de lo que hace.

Paso 2: elige el usuario y crea su clave de API

El agente tiene exactamente los permisos del usuario dueño de la clave: si el usuario es administrador, el agente también. Para una implementación, usa un usuario que solo tenga los accesos que la tarea necesita. La documentación de Odoo recomienda la cuenta personal para uso interactivo y un usuario dedicado, con los permisos mínimos, para usos automáticos o desatendidos. Ten en cuenta que en Odoo Enterprise cada usuario interno adicional requiere licencia.

Para crear la clave, con ese usuario:

  1. Abre tu perfil, arriba a la derecha, y entra a Mis preferencias.
  2. En la pestaña Seguridad, en Claves API, pulsa Agregar clave API y confirma tu contraseña.
  3. Ponle una descripción que diga para qué es, por ejemplo «Claude Code de Ana, base de pruebas».
  4. Elige una Duración corta. La documentación de Odoo recomienda un día para uso interactivo y no permite claves de más de tres meses.
  5. Copia la clave: Odoo la muestra una sola vez. No la pegues en el chat del agente; pasa directo al paso 3.

Crea una clave por agente o por servicio. Si cambias de computadora o de agente, borras esa clave y creas otra, sin afectar a las demás.

Paso 3: guarda la clave en Secrevo

Todo lo que entra al contexto del agente, el chat, los archivos que lee o tus correos, hay que tratarlo como expuesto. Por eso la clave no se le da al agente: se guarda en Secrevo y el agente la usa sin verla.

  1. Crea tu espacio de trabajo en app.secrevo.com. Secrevo tiene un plan gratuito.
  2. En Secrets, crea un secreto, por ejemplo ODOO_PRUEBAS, con tres campos: url (la dirección con la que entras a Odoo, con https), database (el nombre de la base, que ves en modo desarrollador) y api_key (la clave del paso 2). Los campos se añaden con el botón Add field.
  3. Escribe una buena descripción: para qué sirve el secreto, de qué usuario es la clave y cómo regenerarla. El agente puede leer la descripción, así que no pongas valores secretos en ella.
  4. Instala la línea de comandos de Secrevo en tu computadora. En Windows (PowerShell):
irm https://github.com/getsecrevo/cli/releases/latest/download/install.ps1 | iex

En macOS o Linux:

curl -fsSL https://github.com/getsecrevo/cli/releases/latest/download/install.sh | bash

Después, en app.secrevo.com/agents crea un agente, genera un código de enrolamiento (vale una sola vez y por 15 minutos) y canjéalo en la computadora. El código del ejemplo es el de la documentación de Secrevo; usa el tuyo:

secrevo version
secrevo enroll K3M9-X2PA
secrevo auth whoami

Comprueba que el secreto existe. Secrevo muestra solo los nombres de los campos, nunca los valores:

secrevo secret get ODOO_PRUEBAS
{
  "name": "ODOO_PRUEBAS",
  "fields": ["api_key", "database", "url"]
}

Paso 4: la primera consulta al endpoint /json/2

En Odoo 19, la API externa es JSON-2: cada llamada es un POST a /json/2/<modelo>/<método>, con la clave en la cabecera Authorization: bearer y los parámetros con nombre en un objeto JSON. Las rutas antiguas /xmlrpc y /jsonrpc están anunciadas para retirarse en Odoo 22, así que conviene empezar ya con JSON-2.

Así se ve una petición:

POST /json/2/res.partner/search_count HTTP/1.1
Host: your-test-db.odoo.com
Authorization: bearer <API key>
X-Odoo-Database: your-test-db
Content-Type: application/json; charset=utf-8

{"domain": [["is_company", "=", true]]}

Puntos que conviene saber, según la documentación de Odoo 19:

  • X-Odoo-Database es necesaria cuando un mismo servidor tiene varias bases; si no, se puede omitir.
  • Todos los argumentos van con nombre: ids, context, domain, fields. No hay argumentos posicionales.
  • Cada llamada es una transacción propia: si falla, no se guarda nada de esa llamada.
  • Los errores llegan con un código HTTP y un JSON con message; una clave inválida devuelve 401.
  • Para saber con qué usuario estás conectado, llama a res.users/context_get sin ids.

Este script de ejemplo pregunta con qué usuario está conectado y lee cinco empresas. No contiene ninguna clave: las lee de variables de entorno.

import os
import requests

url = os.environ["ODOO_URL"].rstrip("/")
headers = {
    "Authorization": "bearer " + os.environ["ODOO_API_KEY"],
    "X-Odoo-Database": os.environ["ODOO_DB"],
    "Content-Type": "application/json; charset=utf-8",
    "User-Agent": "odoo-agent-test",
}

r = requests.post(url + "/json/2/res.users/context_get", headers=headers, json={})
r.raise_for_status()
print(r.json())

r = requests.post(url + "/json/2/res.partner/search_read", headers=headers, json={
    "domain": [["is_company", "=", True]],
    "fields": ["name", "vat"],
    "limit": 5,
})
r.raise_for_status()
print(r.json())

Y así se ejecuta con Secrevo, que inyecta cada campo del secreto como variable de entorno solo para ese proceso, sin escribirlo en disco ni mostrarlo:

secrevo run \
  --secret-field ODOO_PRUEBAS.url=ODOO_URL \
  --secret-field ODOO_PRUEBAS.database=ODOO_DB \
  --secret-field ODOO_PRUEBAS.api_key=ODOO_API_KEY \
  -- python odoo_test.py

En la práctica no tienes que escribir el script: se lo pides al agente. Por ejemplo: «Conéctate a mi Odoo de pruebas con el secreto ODOO_PRUEBAS de Secrevo, usando secrevo run y el endpoint /json/2. Nunca imprimas ni muestres los valores del secreto. Primero dime con qué usuario estás conectado y cuántos contactos hay.»

Buenas prácticas

  • Empieza por consultas de solo lectura. Cuando pases a crear o modificar, pide al agente que primero explique qué va a hacer y apruébalo. Cuando tengas confianza, usa la misma conexión con otro secreto (por ejemplo ODOO_PRODUCCION) para operar en producción, con el mismo cuidado.
  • Revisa en la pantalla de Odoo lo que el agente creó o cambió. El historial del registro muestra qué usuario lo hizo.
  • Una clave por agente, con descripción y vencimiento corto. Para rotarla, crea la nueva, actualiza el secreto en Secrevo y después borra la anterior.
  • Nunca guardes claves en el chat, en correos, en notas ni en archivos de tu computadora, porque el agente puede leerlos.
  • Revisa los permisos de tus usuarios antes de que cada persona conecte su propio agente: cada agente puede hacer lo mismo que su usuario.
  • Pide las cosas con precisión. «Ventas» puede ser pedidos, facturas u oportunidades; cuanto más claro, menos vueltas da el agente.

Si tu plan no tiene API

En Odoo Online, la API externa solo está disponible en el plan Personalizado; no en Uno gratis ni en Estándar. Sin API el agente no puede conectarse a tu Odoo, pero sigue siendo útil:

  • Prepara los archivos de importación (Excel o CSV) con las columnas que pide Odoo, a partir de tus datos, y revisa duplicados y datos incompletos.
  • Te guía paso a paso para importarlos desde la pantalla de Odoo y para hacer la configuración a mano.
  • Si más adelante pasas al plan Personalizado o a Odoo.sh, la conexión de esta guía funciona sin cambiar nada más.

¿Quieres implementar Odoo así?

Usamos esta conexión desde la primera sesión de cada implementación: tu equipo define con nuestro consultor, su agente ejecuta, también en producción cuando corresponde, y tu equipo revisa. Conoce el método en implementación de Odoo con IA.

Escríbenos por WhatsAppAgenda una reunión

Cómo conectar Odoo con Claude Code o ChatGPT Codex de forma segura
Wilfredo Fernando Pastor Avila 20 de noviembre de 2026
Compartir
Etiquetas
Archivo
Iniciar sesión dejar un comentario
¿Desarrollo en Odoo con IA por mi cuenta o contrato a alguien? 5 preguntas para decidir
Un test de 5 preguntas, probado con 3 casos típicos de Odoo