Saltar a contenido

Soporte comercial

MCP-Odoo-Tools es un proyecto open-source (MIT): puedes instalarlo, configurarlo y operarlo por tu cuenta siguiendo este manual.

Empieza aquí

En Claude Code, ejecuta /odoo-tools:odoo-setup-mcp: la ruta guiada de configuración, verificación, entrenamiento, uso diario y despliegue. ¿Sin un Odoo para practicar? /odoo-tools:deploy-local levanta un sandbox local. /odoo-doctor revisa una conexión existente.

¿Usas Cowork o Claude chat?

Las herramientas de Odoo no corren ahí: las skills y los comandos del plugin cargan, pero esas apps no arrancan su servidor MCP ni tienen un formulario para las opciones de conexión. Nada está mal con tu cuenta, tu Odoo ni tu Python. Si Claude o la app muestran el servidor de este plugin como not_started con el motivo user_config_unsupported, es este caso, no un error, y ninguna actualización lo cambia. Abre una sesión local de la pestaña Code de Claude Desktop (o Claude Code en una terminal, VS Code o JetBrains): el plugin que instalaste en tu cuenta de Claude aparece ahí como plugin sincronizado cuando entras con la misma cuenta. Una sesión en la nube de la pestaña Code tampoco funciona, por otra razón: tus opciones de conexión se quedan en tu equipo. O pide a Transgenia una configuración asistida (abajo). Ver Dónde funciona.

Si algo falla: el reporte de soporte

Corre /odoo-tools:odoo-doctor. Primero revisa si las herramientas de Odoo corren donde estás, luego la conexión (en Claude Code, también qué copia de odoo-tools responde y si hay una segunda copia o una anterior a la 1.5.0; ver Dos copias de odoo-tools), y termina con un reporte de soporte que puedes enviar a Transgenia. El reporte no contiene API keys, contraseñas, URLs, logins ni datos de registros.

  • En Claude Code, el doctor lo genera con python3 <carpeta del plugin>/server/run_stdio.py --diagnose, que solo lee los archivos locales de diagnóstico y de auditoría del plugin y no contacta nada.
  • En Cowork, los comandos de Claude corren en una máquina virtual, no en tu equipo, así que el doctor escribe el reporte a partir de la línea que el hook de inicio de sesión del plugin deja para Claude (Cowork corre los hooks del plugin en tu propio equipo): la superficie, la app que inició la sesión, el último estado del servidor MCP y la carpeta de los archivos de diagnóstico.
  • En Claude chat los hooks del plugin no corren, así que el reporte solo nombra la superficie.
  • En Cowork, en Claude chat o en una sesión en la nube, si la app mostró un estado y un motivo para el servidor de este plugin (como not_started y user_config_unsupported), el doctor los agrega al reporte tal como aparecen, con la versión de la app: confirman la superficie, no son una falla que corregir.

En Claude Code, el reporte se ve así (recortado). Trae las versiones, la carpeta de diagnóstico (tu carpeta personal aparece como ~), los últimos eventos del servidor y del hook revisados otra vez contra la lista permitida, los conteos de auditoría de los últimos 7 días por estado y por regla de rechazo, la política que el servidor cargó en su último arranque y la política calculada sin conexión con el entorno del propio comando (que no tiene las opciones del plugin, por eso va marcada así):

odoo-tools support report (no keys, URLs, logins or record data)
plugin: 1.6.0
python: 3.12.4
os: Darwin 24.6.0 arm64
diagnostics folder: ~/.claude/plugins/data/<plugin id>/diagnostics (exists)
last 5 server events (server.jsonl):
  {"v":1,"ts":"2026-10-30T15:02:11Z","event":"start","pid":4242,"plugin":"1.6.0",...,"settings":{"url":true,"db":true,"login":true},"credential":"api_key","audit":"file","entrypoint":"cli"}
  {"v":1,"ts":"2026-10-30T15:02:14Z","event":"connect","pid":4242,"ok":true,"transport":"json2","odoo_major":19,"edition":"enterprise","deployment":"saas"}
last 3 hook events (hook.jsonl):
  {"v":1,"ts":"2026-10-30T15:02:10Z","event":"session_start","source":"startup",...,"entrypoint":"cli","server_last":"ok","age_h":20,"container":false}
audit, last 7 days: 2 files, 41 calls; by status: ok 39, refused 2; refusals by rule: profile:standard 2
policy at the server's last start: profile standard, digest 21524d1933f3, locked no
policy computed offline from this command's environment (the plugin's options may differ; never contacts Odoo): profile standard, digest 21524d1933f3, locked no, policy file no, read-only no

Los archivos detrás del reporte se quedan en tu equipo, en la carpeta diagnostics de la carpeta de datos del plugin. En Claude Code es ~/.claude/plugins/data/<id del plugin>/diagnostics/ (en Windows, %USERPROFILE%\.claude\plugins\data\<id del plugin>\diagnostics\); en Cowork, el doctor te dice la carpeta, tal como la reportó el hook de inicio de sesión. Los archivos guardan solo metadatos (qué arrancó, qué superficie, qué tipo de error), nunca valores, y el plugin nunca los envía a ningún lado. Adjúntalos a tu correo si soporte te los pide. Ver Privacidad.

Servicios de Transgenia

Si prefieres acompañamiento, Transgenia ofrece servicios de implementación de IA y Odoo:

  • Diagnóstico de tu instancia (versión, edición, módulos, flujos candidatos a automatización con IA).
  • Conexión y piloto de solo lectura antes de tocar datos de producción.
  • Gobernanza de escrituras (revisión humana antes de crear/modificar registros).
  • Integraciones a la medida entre Odoo, agentes de IA y tus sistemas.
  • Mantenimiento y soporte del plugin y de tu conexión con Odoo.
  • Capacitación de tu equipo por rol (ventas, contabilidad, inventario, dirección).
  • Despliegue asistido a producción: hospedaje, seguridad, migraciones entre versiones de Odoo y puesta en marcha para varios usuarios.

Transgenia es partner registrado de Anthropic (tier Registered) y opera agentes de IA gobernados en producción propia. Trabajamos con implementaciones verificables en los sectores salud y B2B.

Contacto

Canales oficiales

Contacta a Transgenia solo por estos canales:

Transgenia nunca te pedirá tu API key ni tu contraseña de Odoo por chat o correo.

Dónde te lo sugiere el plugin

Desde la v1.3.0 el plugin menciona estos canales en los momentos en que ayudan, no en cada respuesta:

  • cuando las herramientas de Odoo no corren donde estás (Cowork o Claude chat): el hook de inicio de sesión y /odoo-tools:odoo-doctor te ofrecen una sesión local de la pestaña Code de Claude Desktop y, después, la configuración asistida de Transgenia;
  • cuando la configuración se bloquea (errores de credenciales, autenticación o transporte, y /odoo-doctor cuando algo falla);
  • al terminar el entrenamiento de la ruta guiada;
  • al terminar el sandbox local y la fase de despliegue;
  • cuando pides ayuda de mantenimiento, soporte, capacitación, personalización o despliegue.

Errores y solicitudes de funciones

Abre un issue en el repositorio con la versión del plugin, la versión y edición de Odoo, y el reporte de soporte de /odoo-tools:odoo-doctor (no contiene credenciales). Para vulnerabilidades de seguridad, sigue Seguridad.

Recursos del proyecto

Honestidad de marca

Transgenia es partner registrado de Anthropic. Este plugin es un proyecto open-source independiente; no es un producto certificado ni de primera parte de Anthropic. Está publicado en el directorio de plugins de Anthropic, donde cada versión nueva llega cuando un revisor de Anthropic la aprueba, así que el directorio puede ofrecer una versión anterior a la que describe este manual.