Cómo conectar Odoo (MCP server) a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Odoo (MCP server), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Odoo (MCP server) + Cursor

Conecta Claude, ChatGPT o Copilot a Odoo a través del propio servidor MCP de Odoo (Odoo AI, Odoo Online saas-19.4 y Odoo 20): busca en cualquier modelo, agrupa y totaliza registros, lista modelos y campos y, si tu administrador lo permite, crea y actualiza registros. Regido por el usuario de Odoo y las AI Tools que tu administrador expone.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ODOO_URL, ODOO_MCP_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una base de datos de Odoo con el propio servidor MCP de Odoo: Odoo Online desde la versión saas-19.4, u Odoo 20, con la app AI instalada. Tu versión aparece al final de Settings, y una base de datos con servidor MCP ofrece el scope MCP al crear una clave de API.

1. En Odoo, haz clic en tu avatar y abre My Preferences (o My Profile) → Security → Add API Key. Confirma tu contraseña y ponle un nombre a la clave.
2. Pon Scope en MCP y elige en Expires cuánto tiempo es válida. Odoo muestra la clave una sola vez, así que cópiala ya. Créala con un usuario de Odoo propio para esto, con los permisos de lo que el asistente puede ver: la clave actúa como ese usuario.
3. Pega la clave en ODOO_MCP_API_KEY. Son 40 caracteres hexadecimales en minúscula; no añadas la palabra Bearer.
4. En ODOO_URL pon la dirección con la que abres Odoo, hasta el host, por ejemplo https://mycompany.odoo.com. Quita /odoo, /web, /mcp y la barra final: el conector añade /mcp por su cuenta.
5. Instala el conector y ejecuta odoo_mcp_ai_tool_mcp_retrieve_initial_context: muestra el usuario conectado, su zona horaria, la empresa activa y todas las empresas a las que puede cambiar.

¿Qué conector de Odoo? Este es para bases de datos con el propio servidor MCP de Odoo, donde tu administrador de Odoo decide qué herramientas existen y qué cambios se permiten. Para Odoo 19.0 (que no tiene servidor MCP), para Odoo.sh o tu propio servidor sin él, o si quieres herramientas fijas para contactos, pedidos de venta, facturas y productos, usa el conector Odoo (API JSON-2, Odoo 19 y posteriores). Para Odoo 14 a 18, usa Odoo 14-18 (JSON-RPC).

Las herramientas vienen de tu base de datos: al instalar, AnythingMCP pregunta al servidor MCP de Odoo qué herramientas expone. Por defecto son Get Models, Get Fields, Search, Read group y MCP Retrieve initial context, todas de solo lectura, y Odoo las ejecuta con los permisos del usuario dueño de la clave. Un administrador puede exponer más (Create Records, Update Records, menús, herramientas de sitio web y de imágenes) en modo desarrollador en Settings → Technical → Server Actions, marcando Available in MCP en la pestaña Usage de la herramienta. Después abre aquí el conector y haz clic en Discover tools. La generación de imágenes gasta créditos de Odoo AI.

Qué lee: cualquier modelo que el usuario de Odoo pueda abrir, como contactos, pedidos de venta, facturas o productos. odoo_mcp_ai_tool_get_models encuentra el modelo adecuado, odoo_mcp_ai_tool_get_fields lista sus campos, odoo_mcp_ai_tool_search busca registros con un dominio de Odoo y odoo_mcp_ai_tool_read_group los agrupa y totaliza por día, semana, mes, trimestre o año: ventas por mes, facturas por cliente, oportunidades por etapa.

Pregunta antes de cada cambio: al instalar no hay ninguna herramienta de escritura activa. Cuando un administrador activa crear o actualizar registros, la IA te muestra los registros y los valores exactos y espera tu sí antes de escribir.

Desactivadas al instalar: odoo_mcp_ai_tool_create_records y odoo_mcp_ai_tool_update_records. Odoo las oculta hasta que un administrador las expone a MCP, y aquí además se instalan apagadas, porque crean registros o cambian valores en todos los registros que cumplen un dominio. Actívalas una a una solo cuando el asistente deba cambiar Odoo.

Límites: Search devuelve 50 registros por defecto y como máximo 200 por llamada, así que la IA pasa de página en resultados grandes o usa Read group para los totales, en lugar de traer miles de filas. La clave de API caduca en la fecha que elegiste en Expires: entonces crea una nueva y pégala.

Errores comunes: 401 significa que la clave es incorrecta, ha caducado o se creó sin el scope MCP. 404 en /mcp significa que la base de datos no tiene servidor MCP (es anterior a saas-19.4 o la app AI no está instalada): usa el conector Odoo u Odoo 14-18 (JSON-RPC). Odoo publica Get Fields sin parámetros, pero la herramienta falla si no recibe model_name e include_description, así que la IA siempre pasa los dos.

El conector no añade herramientas que tu Odoo no expone, no va más allá de los permisos del usuario de Odoo detrás de la clave y no funciona con bases de datos sin el servidor MCP de Odoo.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Odoo (MCP server).

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto vendimos en pedidos confirmados cada mes de este año? Dame el total de cada mes."
• "¿Qué clientes tienen facturas vencidas sin pagar, y cuánto nos debe cada uno?"
• "Busca el contacto Construcciones García y enséñame su email, su teléfono y su comercial."
• "¿Cuáles fueron los diez productos más vendidos por cantidad el último trimestre?"
• "Cambia el email del contacto Ana Martín a [email protected]. Enséñame el registro antes de actualizarlo."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT