Claude–Odoo 19 OAuth de Solo Lectura MCP Connector

Versión habilitada para OAuth del conector MCP de solo lectura para Odoo 19.

Claude
  -> OAuth 2.1 access token
  -> Python MCP Resource Server
  -> Odoo JSON-2 API

Arquitectura importante

El servicio Python es un Servidor de Recursos OAuth. Valida tokens de portador emitidos por un Servidor de Autorización OAuth/OIDC externo como Microsoft Entra ID, Auth0, Okta, u otro proveedor de identidad compatible.

La clave de API de Odoo permanece solo en el servidor del conector Python.

Related MCP server: MCP Server for Odoo

Herramientas de Odoo

• test_odoo_connection

• search_crm_opportunities

• get_crm_opportunity

• search_sales_orders

• get_sales_order

• search_products

• get_stock_by_location

• search_inventory_transfers

No se incluyen herramientas de Odoo de crear/actualizar/eliminar/confirmar/validar/cancelar.

Instalar en Windows

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env

Primera prueba local

Mantener:

AUTH_ENABLED=false
TRANSPORT=streamable-http
HOST=0.0.0.0
PORT=8000

Ejecutar:

python test_connection.py
python -m unittest discover -s tests
python -m app.server

Luego prueba http://127.0.0.1:8000/mcp con MCP Inspector.

Configuración de OAuth

Registra una API/recurso y un cliente OAuth con el proveedor de identidad del cliente. El proveedor debe emitir tokens de acceso JWT que contengan:

• iss que coincida con AUTH_ISSUER_URL

• aud que coincida con AUTH_AUDIENCE

• exp

• alcance requerido, por defecto odoo.read

Luego configura:

AUTH_ENABLED=true
AUTH_ISSUER_URL=https://auth.example.com
AUTH_RESOURCE_SERVER_URL=https://YOUR_PUBLIC_HOST/mcp
AUTH_JWKS_URL=https://auth.example.com/.well-known/jwks.json
AUTH_AUDIENCE=https://YOUR_PUBLIC_HOST/mcp
AUTH_REQUIRED_SCOPES=odoo.read
AUTH_ALGORITHMS=RS256

Reinicia:

python -m app.server

El SDK de MCP publicará metadatos de recursos protegidos utilizados por Claude para el descubrimiento de OAuth. El Servidor de Autorización en sí mismo permanece externo.

Claude

Agrega:

https://YOUR_PUBLIC_HOST/mcp

Si el proveedor de identidad no admite el registro dinámico de clientes, agrega el ID de Cliente OAuth y el Secreto de Cliente en la configuración Avanzada del conector de Claude.

Cada usuario autorizado de Claude luego hace clic en Conectar e inicia sesión a través del proveedor de identidad configurado.

Dev Tunnel

Se puede usar un Túnel de Desarrollo público de VS Code temporalmente para staging. Si su URL cambia, actualiza AUTH_RESOURCE_SERVER_URL y generalmente también AUTH_AUDIENCE.

No dejes AUTH_ENABLED=false en una implementación MCP persistente accesible públicamente.

peltierpro-mcp