cf-odoo-mcp-server

MCP server para Odoo ERP que se ejecuta en Cloudflare Workers

Usa un transport stateless HTTP — no necesita Durable Objects, ni contenedores, ni procesos en ejecución; cabe cómodamente en el free tier de Workers.

Es un port de odoo-mcp-claude, que ofrece el mismo conjunto de 10 herramientas, pero se ejecuta como un proceso de Python y habla mediante XML-RPC.

Odoo 19 tiene 2 tipos de API key — comprueba cuál necesitas

Odoo 19 permite crear API keys con 2 scopes que no son intercambiables.

La separación de scopes es estricta en ambos sentidos: una key de tipo rpc que llame a /mcp recibirá un 401, y una key de tipo mcp no puede autenticarse vía JSON-RPC.

Por eso puede que no necesites usar este proyecto en absoluto. Si tu agente solo lee, el servidor MCP integrado de Odoo no requiere despliegue, ni buscar alojamiento, ni llevar el código de Odoo a otro sitio — basta con apuntar el cliente a https://<odoo-ของคุณ>/mcp con una key de tipo mcp. Además rechaza los modelos técnicos, una salvaguarda que este proyecto no tiene.

El trabajo que requiere escribir datos necesita una key de tipo rpc, que es la razón de ser de este proyecto — además de poder conectar varios Odoo a través de un único endpoint y tener un límite predeterminado al leer. Ambos pueden ejecutarse en paralelo.

NOTES.md tiene la comparación completa, incluidos los puntos donde el schema del servidor MCP integrado hace tropezar al agente.

Por qué usar JSON-RPC y no XML-RPC

El xmlrpc.client de Python necesita un raw socket, que el runtime de Workers no proporciona. Pero Odoo expone el mismo execute_kw vía JSON-RPC en /jsonrpc, que es HTTP normal y corriente, usable directamente con fetch sin necesidad de adaptaciones.

Requisitos

Odoo debe ser accesible desde Internet mediante HTTPS — el Worker no puede entrar en la LAN. Si Odoo aún no es público, pon Cloudflare Tunnel delante.

Herramientas

Configuración

Conviene usar una API key de Odoo en lugar de la contraseña de la cuenta, y dar a esa cuenta solo los permisos que las herramientas necesiten de verdad — odoo_delete y odoo_write acceden a todo lo que la cuenta pueda acceder.

ODOO_SERVERS tiene este aspecto

{
  "default_server": "prod",
  "servers": {
    "prod": { "url": "https://odoo.example.com", "db": "mydb", "username": "bot@example.com", "password": "api-key" }
  }
}

Desarrollo local

npm install
cp .dev.vars.example .dev.vars   # แล้วกรอกค่าให้ครบ
npm run dev

.dev.vars ya está en gitignore; no commitees contraseñas jamás.

Despliegue

npx wrangler login
npx wrangler deploy

npx wrangler secret put MCP_AUTH_TOKEN     # openssl rand -hex 32
npx wrangler secret put ODOO_URL
npx wrangler secret put ODOO_DB
npx wrangler secret put ODOO_USERNAME
npx wrangler secret put ODOO_PASSWORD

Los secretos se almacenan cifrados y no aparecen en wrangler.jsonc.

Conectar el cliente

.mcp.json en esta carpeta es un archivo de Claude Code, no del Worker — solo le dice al cliente con qué endpoint y con qué token hablar. Este archivo toma valores del environment, así que no contiene secretos y se puede commitear a git.

{
  "mcpServers": {
    "odoo": {
      "type": "streamable-http",
      "url": "${ODOO_MCP_URL:-https://cf-odoo-mcp-server.<subdomain>.workers.dev/mcp}",
      "headers": { "Authorization": "Bearer ${MCP_AUTH_TOKEN}" }
    }
  }
}

Claude Code no carga .env por ti; tienes que exportar las variables al environment antes de invocarlo.

cp .env.example .env    # แล้วกรอก MCP_AUTH_TOKEN
set -a; . ./.env; set +a
claude

Si olvidas exportarlas, las variables no se sustituirán; claude mcp list avisará de que no encuentra las variables y el Worker responderá 401 — falla de forma visible, no en silencio.

ODOO_MCP_URL sirve para apuntar a otro Worker, por ejemplo staging y production, sin tener que editar .mcp.json.

Para otros clientes que no lean .mcp.json, configura el endpoint y la cabecera Authorization: Bearer <token> con el mismo formato.

GET /health no requiere autenticación y devuelve {"status":"ok"}.

Seguridad

Este endpoint es público; toda petición que entre a /mcp debe llevar un bearer token, y se compara en tiempo constante. Si MCP_AUTH_TOKEN no está definido, el Worker devuelve 500 en lugar de abrirse del todo.

Un único token compartido es adecuado para un servidor privado o de uso interno. Si necesitas identidades individuales, pon Workers OAuth Provider delante.

Notas de uso real

NOTES.md documenta lo probado con un Odoo real y las precauciones importantes al dejar que un agente de IA maneje estas herramientas — en especial cómo Odoo descarta silenciosamente los valores escritos en campos de solo lectura.

Licencia

MIT