Conectar Claude Code con Odoo por MCP

Por qué conectar Claude Code con Odoo

• Escribir un módulo con los campos reales: tipos, relaciones y campos añadidos por los módulos instalados.
• Comprobar un dato sin salir del terminal: cuántos pedidos tienen tal estado, qué productos no tienen categoría.
• Preparar una importación o una migración: detectar los campos vacíos, comparar valores, contar los duplicados.
• Escribir un dominio de búsqueda de Odoo y probarlo enseguida con los datos reales.

Lo que necesita

• Claude Code instalado y conectado a su cuenta: vea la documentación de Claude Code;
• una cuenta Aidoo con una conexión Odoo configurada: vea Conectar su Odoo;
• un navegador en la misma máquina, para la autorización OAuth.

Añadir Aidoo a Claude Code

1. 1

   Paso 1. Añada el servidor

   En su terminal, desde la carpeta del proyecto:

   TerminalCopiar

   claude mcp add --transport http aidoo https://mcp.aidoo.ai/mcp

2. 2

   Paso 2. Elija el alcance

   Sin opciones, el servidor solo está disponible en el proyecto actual, y solo para usted. Añada --scope user para tenerlo en todos sus proyectos, o --scope project para registrarlo en el archivo .mcp.json del repositorio y compartirlo con el equipo. Este archivo no contiene ningún secreto: cada desarrollador se autentica con su propia cuenta.

   TerminalCopiar

   claude mcp add --transport http aidoo --scope user https://mcp.aidoo.ai/mcp

3. 3

   Paso 3. Autentíquese

   Inicie Claude Code, escriba /mcp, elija aidoo y siga la conexión en el navegador: inicio de sesión en Aidoo, elección del espacio de trabajo, permisos del conector, autorización. Por defecto, solo está marcada la lectura.

   Claude CodeCopiar

   /mcp

4. 4

   Paso 4. Compruebe

   El siguiente comando muestra sus servidores MCP y su estado. Después, haga una primera pregunta, por ejemplo: «Lista los modelos de Odoo cuyo nombre contiene invoice».

   TerminalCopiar

   claude mcp list

Ejemplos de solicitudes

• «Describe el modelo res.partner de esta base, campos personalizados incluidos.»
• «¿Cuántos productos no tienen categoría? Dame los 10 primeros.»
• «Escribe el dominio de Odoo que selecciona los presupuestos enviados hace más de 15 días y pruébalo.»
• «Compara la distribución de los estados de stock.picking en los tres últimos meses.»

Encontrará más solicitudes, clasificadas por departamento, en las recetas por área.

Buenas prácticas

• Para desarrollar, conecte preferiblemente un espacio Aidoo vinculado a una base de pruebas en lugar de a la de producción.
• Mantenga la solo lectura, y añada la escritura únicamente para una tarea concreta.
• Comparta la configuración con --scope project en lugar de hacer circular credenciales: el archivo .mcp.json solo contiene la dirección.
• Para Cursor o Windsurf, que no usan OAuth, siga la guía de los clientes locales con una clave API de Aidoo.

Ir más lejos: crear módulos de Odoo