Claude te preguntará por tu Odoo (plan, versión, dónde está alojado), elegirá la vía que encaja, esperará a que apruebes el acceso en la web de tu Odoo y te enseñará tus oportunidades abiertas y tus facturas pendientes de cobro. Solo tienes que seguirle.
Quiero conectar mi Odoo a Claude Code para consultar mi CRM, ventas, facturación, inventario o contactos y, cuando yo lo apruebe, preparar borradores. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir.
CONTEXTO PARA TI
- Acceso según el plan (doc oficial: https://www.odoo.com/documentation/20.0/developer/reference/external_api.html y la FAQ de https://www.odoo.com/pricing): conectar un programa externo a Odoo solo está permitido en el plan Custom; en One App Free y Standard no hay acceso a la API externa. Si mi plan no es Custom, no intentes conectarte: trabajaremos con exportaciones (abajo) y te digo si quiero hablar con Odoo para cambiar de plan.
- Vía recomendada, el servidor MCP oficial de Odoo (doc: https://www.odoo.com/documentation/20.0/applications/productivity/ai/mcp_server.html). Forma parte de la app IA de Odoo, está documentado para Odoo 20 y para Odoo Online desde la versión 19.4, y vive en la URL de mi base de datos más /mcp (por ejemplo, https://miempresa.odoo.com/mcp). Instalar la app IA en una base con plan Standard dispara el paso al plan Custom (https://www.odoo.com/documentation/20.0/applications/productivity/ai.html): no la instales ni cambies ningún ajuste que afecte al plan sin mi OK explícito.
- Odoo recomienda conectarse con OAuth: en Claude Code, claude mcp add --transport http odoo <URL de mi Odoo>/mcp, mejor con --scope user para que funcione desde cualquier carpeta; luego claude mcp list para ver el estado. Se abre la página de inicio de sesión de Odoo y después «Grant Access», donde elijo cuánto tiempo dura el acceso y pulso Allow. OAuth es solo para usuarios internos (no de portal). Solo pueden pedir acceso los clientes aprobados, en Ajustes → Integraciones → MCP OAuth: si Odoo rechaza a Claude Code, dime que lo revise un administrador ahí, siguiendo la doc oficial. No me propongas activar el registro dinámico de clientes (DCR) para salir del paso: deja que cualquier aplicación se registre.
- Herramientas (lista oficial: https://www.odoo.com/documentation/20.0/applications/productivity/ai/mcp_server/mcp_tools.html): por defecto Odoo solo expone las de lectura (Get Models, Get Fields, Search, Read group y la de contexto inicial). Las de escritura (Create Records, Update Records) y el resto las tiene que exponer un administrador a mano, con el modo desarrollador, en Ajustes → Técnico → Acciones de servidor, marcando «Available in MCP». No me pidas exponer las de escritura hasta que quiera crear o cambiar algo. La casilla «Readonly Tool» solo le dice al cliente que la herramienta es segura; no es un permiso.
- Cada conexión aparece como una API key en Mis preferencias → pestaña Seguridad de mi usuario; para revocar el acceso, se borra esa clave. Odoo comprueba siempre los permisos de mi usuario: Claude nunca ve ni hace más que yo.
- Alternativa, si mi Odoo es la versión 19 (o no tiene la app IA) y el plan lo permite: la API JSON-2 (nueva en la 19.0; doc: https://www.odoo.com/documentation/20.0/developer/reference/external_api.html). Peticiones POST a <URL>/json/2/<modelo>/<método> (por ejemplo, /json/2/res.partner/search_read) con la cabecera Authorization: bearer <clave> y, si hace falta, X-Odoo-Database con el nombre de la base. La clave se crea en Preferencias → Seguridad de la cuenta → Nueva clave API (en Odoo 20, Mis preferencias → Seguridad → Crear clave API); se ve una sola vez y dura como mucho tres meses. La clave tiene todos los permisos de mi usuario, sin modo de solo lectura: para algo continuo, Odoo recomienda un usuario dedicado con los permisos mínimos. Cada llamada es su propia transacción y se guarda al momento: no hay deshacer.
- XML-RPC y JSON-RPC (/xmlrpc, /jsonrpc) están obsoletos desde la 19.0 y Odoo los retira en Odoo Online 21.1 (invierno de 2027) y en Odoo 22 (otoño de 2028). Úsalos solo si mi versión es anterior a la 19, y avísame de que caducan.
- Sin API (One App Free o Standard): en cualquier vista de lista, selecciono los registros → Acciones → Exportar → Excel (.xlsx) o CSV (doc: https://www.odoo.com/documentation/20.0/applications/essentials/export_import_data.html). Tú lees el fichero de esta carpeta. Si una exportación es muy grande, mejor por tandas.
QUÉ QUIERO QUE HAGAS
1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué quiero (CRM y pipeline, ventas y facturas, inventario, contactos, o también preparar borradores); dónde está mi Odoo (Odoo Online, la web acaba en odoo.com; Odoo.sh; o un servidor propio) y su URL; qué plan tengo (One App Free, Standard, Custom o no lo sé); qué versión (si no lo sé, compruébalo tú en la doc o en mi Odoo, sin cambiar nada); y si mi usuario es administrador.
2. REVISAR: comprueba tú mismo si Claude Code ya tiene el servidor de Odoo (claude mcp list o sus herramientas). Si ya está y responde, salta al paso 5.
3. RECOMENDAR: dime en dos frases qué vía encaja. Con plan Custom y Odoo 20 (u Online 19.4 o posterior), el MCP oficial con OAuth. Con plan Custom y Odoo 19, la API JSON-2. Sin plan Custom, exportar listas. Nunca un servidor MCP de la comunidad ni un módulo de terceros de la tienda de apps de Odoo.
4. CONECTAR: con el MCP, si la app IA no está instalada, dímelo y para: decidir instalarla es cosa mía (y del administrador), por el plan. Si está, ejecuta tú el comando de arriba (con --scope user), pidiéndome permiso antes. Se abrirá mi Odoo en el navegador: antes de que apruebe, explícame en una frase qué estoy dando, que elija una duración corta y que puedo rechazarlo. Cuando te diga «OK», comprueba que ves sus herramientas; si no, dime cómo reiniciar Claude Code. Si elegimos la API: guíame para crear la clave en mi Odoo con una caducidad corta; cuando la haya copiado y te diga «OK», léela tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdala directamente como variable de entorno de usuario ODOO_API_KEY (en Mac, una línea export en ~/.zshrc; en Windows, [Environment]::SetEnvironmentVariable con ámbito User), sin mostrarla, repetirla ni escribirla en el chat. Comprueba solo que no está vacía y después vacía el portapapeles. Si exportamos: dime qué lista exportar y dónde dejar el fichero.
5. PROBAR (solo lectura): dime a qué base de datos y con qué usuario estás conectado y enséñame en tablas cortas las oportunidades abiertas por etapa, las facturas pendientes de cobro (cliente, fecha, importe) y los últimos 5 contactos. Si solo tengo lo que el plan o mis permisos dejan ver, dímelo.
6. RECORDAR: crea una skill personal con cómo te conectas a mi Odoo (MCP, API o exportación), la URL de la base, mi plan y versión, la fecha en que caduca el acceso o la clave (para avisarme antes), lo que suelo pedirte y las reglas de abajo. Así la próxima vez me basta con preguntarte.
Reglas: trabaja en solo lectura salvo que yo pida otra cosa. No crees, edites, confirmes, envíes ni borres oportunidades, pedidos, facturas, contactos ni productos salvo que yo lo pida de forma explícita, y antes enséñame el borrador completo y espera mi OK. Una factura validada tiene efectos fiscales: si hay que corregir una, pregúntame antes. Antes de sobrescribir cualquier dato, guarda el original en un fichero de esta carpeta para poder volver atrás. No instales apps, no expongas herramientas de escritura ni cambies ajustes de Odoo sin mi OK, y nunca nada que cambie mi plan. Pide solo lo que haga falta: nada de recorrer toda la base de golpe. Nunca me pidas una clave en el chat. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo.
CÓMO TRABAJAR CONMIGO
- Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano.
- Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción.
- Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo.
- Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado.
- Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones.
- Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill.
- La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill.
- Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle):
hooks:
Stop:
- hooks:
- type: command
once: true
command: |
grep -q '"stop_hook_active":true' && exit 0
echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'