Saltar a contenido

Inicio rápido (setup guiado)

El comando /setup-odoo-tools te lleva paso a paso por la conexión, una pregunta a la vez, y verifica el resultado. Esta página resume ese flujo por si prefieres hacerlo manualmente.

Paso 0 — Detectar lo que ya tienes

El comando primero revisa si uvx/node están disponibles y si las variables de entorno (ODOO_URL, ODOO_DB, ODOO_LOGIN y un secreto) ya están puestas. Si todo está listo, salta directo a la verificación.

Paso 1 — Elegir la superficie

  • Servidor MCP (recomendado) — herramientas completas + capa de compatibilidad. Necesita uv/uvx (o Python 3.11+).
  • CLI de respaldo — ligera, solo Node. Úsala si no puedes correr el MCP.

Paso 2 — Versión y edición de Odoo (opcional)

Community · Enterprise · Online (odoo.com/SaaS) · No estoy seguro. La capa de compatibilidad cubre las versiones 10–19 automáticamente; este dato es solo contexto.

Paso 3 — Datos de conexión

  1. URL de Odoo — p. ej. https://mi-empresa.odoo.com (esquema + host, sin ruta final).
  2. Nombre de la base de datos — Settings → Database, o visible en la URL de login.
  3. Correo de acceso — la cuenta con la que inicias sesión.
  4. Credencial — una API key (Odoo 14+, recomendada) o una contraseña (Odoo < 14). Para la API key: Preferencias → Account Security → New API Key (se muestra una sola vez — cópiala).

Seguridad

Nunca escribas el secreto en un archivo que el repositorio rastree. Usa un usuario de Odoo de mínimo privilegio para el agente. Ver Seguridad.

Paso 4 — Persistir la configuración

export ODOO_URL="…"
export ODOO_DB="…"
export ODOO_LOGIN="…"
export ODOO_API_KEY="…"
Añádelas a ~/.bashrc o ~/.zshrc y reinicia Claude.

setx ODOO_URL "…"
setx ODOO_DB "…"
setx ODOO_LOGIN "…"
setx ODOO_API_KEY "…"
Reinicia Claude para que el plugin tome las variables.

Para la CLI, corre /odoo-tools:odoo-setup-cli: instala la CLI y escribe un .env local en ~/.claude/tools/odoo-cli.

Paso 5 — Verificar (definición de terminado)

  • MCP: llama a odoo_version. Éxito = devuelve versión + edición + despliegue + transporte. Luego prueba: odoo_search_read { "model": "res.partner", "fields": ["name"], "limit": 1 }.
  • CLI: node ~/.claude/tools/odoo-cli/dist/cli.js contacts '{"limit":1}'.

Si falla, diagnostica por el error:

  • error de autenticación → revisa DB / login / API key
  • error de transporte → revisa la URL (esquema + host)
  • "database not found" → revisa el nombre exacto de la base

Paso 6 — Primeros prompts

  • "lista las facturas publicadas del mes pasado"
  • "cuántas suscripciones activas hay"
  • "exporta los productos a CSV"

Usa /odoo-doctor para un chequeo rápido y /odoo-tools:odoo-crossversion para notas de versión.