Instalación¶

Como plugin de Claude (recomendado)¶

/plugin marketplace add Transgenia/MCP-Odoo-Tools-CE-EE-and-online
/plugin install odoo-tools
/odoo-tools:odoo-setup-mcp

La entrada mcpServers del plugin lanza el servidor con:

uvx --from ${CLAUDE_PLUGIN_ROOT}/server odoo-mcp

De esta forma uv construye y ejecuta el servidor empaquetado desde el código fuente — no se necesita una publicación en PyPI.

Ejecutar el servidor MCP directamente¶

# con uv (recomendado; trae su propio Python)
uvx --from ./server odoo-mcp

# o desde un checkout con tu propio Python 3.11+
cd server && pip install -e . && python -m odoo_mcp

Requisitos¶

Servidor MCP: uv/uvx (trae su propio Python), o Python 3.11+ para correr python -m odoo_mcp desde server/.
CLI de respaldo (opcional): Node.js 18+.

Extras opcionales¶

pip install -e "./server[cache]"    # caché de esquema con TTL (cachetools)
pip install -e "./server[metrics]"  # métricas Prometheus en /metrics
pip install -e "./server[otel]"     # trazas OpenTelemetry (OTLP)

Los extras nunca bloquean el arranque: si no están instalados, esas capacidades simplemente quedan inactivas (degradación elegante).

Configuración (variables de entorno)¶

Variable	Requerida	Notas
`ODOO_URL`	sí	`https://host` (sin ruta final)
`ODOO_DB`	sí	nombre de la base de datos
`ODOO_LOGIN`	sí	correo de acceso
`ODOO_API_KEY`	sí*	Odoo ≥ 14; se crea en Account Security
`ODOO_PASSWORD`	sí*	úsala en Odoo < 14 (sin API keys)
`ODOO_TRANSPORT_PREF`	no	`auto` (default) / `jsonrpc` / `xmlrpc`
`ODOO_TIMEOUT`, `ODOO_CACHE_TTL`	no	enteros (segundos)
`ODOO_METRICS`, `ODOO_OTEL_ENDPOINT`	no	observabilidad opcional

* debes definir una de ODOO_API_KEY o ODOO_PASSWORD.

Las credenciales permanecen en tu entorno; nada se envía a Anthropic ni se persiste en disco por el plugin.

CLI de respaldo (opcional)¶

/odoo-tools:odoo-setup-cli

Requiere Node.js 18+. Instala la CLI en ~/.claude/tools/odoo-cli. Ver la página CLI de respaldo para el detalle de comandos.

Docker (transporte HTTP, opcional)¶

El directorio docker/ del repositorio incluye un ejemplo de despliegue HTTP multi-tenant, donde los clientes pasan cabeceras X-Odoo-Url/Db/Login + Bearer.

Verificar¶

Llama a la herramienta odoo_version (o corre /odoo-tools:odoo-doctor). Una respuesta exitosa que reporte versión, edición, despliegue y transporte confirma la instalación de extremo a extremo. Ver Conexión y descubrimiento.