Puente MCP Odoo ↔ Claude — guía de despliegue

Este pequeño proyecto conecta su instancia de Odoo (via-italia.odoo.com) con Claude, para que yo pueda leer/escribir directamente en Odoo (stock, facturas, clientes, recordatorios) sin que usted tenga que hacer clic en la interfaz.

Se ejecuta de forma continua en un proveedor de alojamiento en la nube (Render, gratuito para empezar). Claude se conecta mediante una autenticación adecuada (OAuth): la primera vez, una página de inicio de sesión le pide su token secreto; después Claude permanece conectado automáticamente, sin que el secreto aparezca nunca en una URL.

No se necesita ninguna línea de comandos de Git: todo se hace en el navegador.

Paso 0 — lo que necesita antes de empezar

• La clave API de Odoo generada en via-italia.odoo.com (Mis preferencias → Seguridad de la cuenta → Nueva clave API). Guárdela, la pegará en el paso 3.

• Un token secreto para proteger el acceso. Genere uno ahora (no lo comparta más que con Render, nunca en otro lugar):

  • En Mac: abra Terminal y escriba openssl rand -hex 24, copie el resultado.

  • Si no: cualquier generador de contraseñas que dé ~40 caracteres aleatorios sirve.

Related MCP server: odoo-mcp-server

Paso 1 — subir estos archivos a GitHub (sin Git)

1. Vaya a github.com y cree una cuenta gratuita si no tiene una.

2. Haga clic en New repository. Nombre: odoo-mcp-bridge (o lo que quiera). Déjelo Public (necesario para el despliegue en Render sin vincular una cuenta). No marque nada más. Create repository.

3. En la página del nuevo repositorio vacío, haga clic en uploading an existing file.

4. Arrastre y suelte los 6 archivos de esta carpeta (Dockerfile, proxy.py, oauth_provider.py, requirements.txt, start.sh, README.md) en la zona de carga.

5. Commit changes.

Anote la URL del repositorio, del tipo https://github.com/SU-CUENTA/odoo-mcp-bridge.

Paso 2 — crear el servicio en Render

1. Vaya a render.com y cree una cuenta gratuita.

2. New + → Web Service.

3. Elija Public Git Repository y pegue la URL del repositorio de GitHub del paso 1. Connect.

4. Nombre del servicio: via-italia-odoo-mcp (u otro).

5. Render detecta el Dockerfile automáticamente — deje el modo Docker.

6. Tipo de instancia: Free para empezar (suficiente para probar).

Paso 3 — variables de entorno

Todavía en esta página de creación, despliegue Advanced → Add Environment Variable, y añada:

(ODOO_DB no es necesario, Odoo lo detecta automáticamente.)

Haga clic en Create Web Service. El primer despliegue tarda 2-3 minutos — verá los registros de compilación desfilar.

Paso 4 — verificar que funciona

Una vez que el despliegue esté marcado como "Live", su servicio tiene una dirección del tipo https://via-italia-odoo-mcp.onrender.com.

Pruebe primero https://via-italia-odoo-mcp.onrender.com/healthz en un navegador: debe ver ok.

Su dirección de conector (la que debe dar a Claude) es simplemente:

https://via-italia-odoo-mcp.onrender.com/mcp

No hay token en esa URL — se puede compartir sin riesgo, la protección se hace en el siguiente paso.

Paso 5 — conectar Claude

En Claude: Customize → Connectors → "+" → Add custom connector, pegue la URL del paso 4, Add, y luego haga clic en Conectar.

Se abre una página de inicio de sesión y le pide su BRIDGE_SECRET (el token generado en el paso 0) — introdúzcalo y valide. Claude permanece conectado; no tendrá que repetirlo salvo que vuelva a desplegar el servicio (lo que borra la sesión en memoria).

Vuelva luego a la conversación con Claude y pídale que verifique la conexión (por ejemplo: "lista mis últimos presupuestos de Odoo").

Paso 6 — pasar a lectura/escritura

Una vez que la lectura funcione y se sienta cómodo, vuelva a Render → su servicio → Environment, cambie ODOO_YOLO de read a true, y vuelva a desplegar (Render lo hace automáticamente después de un cambio de variable). Claude podrá entonces también crear facturas, actualizar stocks, etc. — actívelo solo cuando esté listo para que realmente escriba en Odoo.

Límites a conocer

• El plan Free de Render pone el servicio en reposo después de 15 minutos sin tráfico: la primera solicitud después de una pausa tarda 30-60 segundos mientras se despierta. Para un uso diario más fluido, un plan de pago (~7 $/mes) elimina este reposo.

• Las sesiones (tokens OAuth emitidos) se guardan en memoria por el servicio, no en disco: un nuevo despliegue o un reinicio las borra, y habrá que volver a hacer "Conectar" en el lado de Claude (solo volver a escribir el BRIDGE_SECRET, nada más).