Odoo MCP server for OpenCode

Este workspace incluye un servidor stdio MCP local (odoo_mcp) que expone las tareas, el chatter y los partes de horas de tu proyecto Odoo autoalojado como nueve herramientas tipadas que un agente puede invocar directamente. El mismo repositorio contiene el CLI original odoo_tasks.py, sin cambios de comportamiento, que comparte la capa de servicio con el servidor MCP.

Requisitos previos

• Python 3.10+ (el workspace se ha desarrollado contra 3.12)

• uv en el PATH (pip install uv si no está)

Instala todo de una vez:

uv sync

Related MCP server: MCP Server for Odoo

Credenciales (variables de entorno)

ODOO_URL debe ser una URL absoluta HTTPS para que las credenciales nunca se envíen por HTTP en claro.

Se recomienda encarecidamente usar una clave API en lugar de una contraseña (Odoo: Preferencias → Seguridad de la cuenta → Nueva clave API): es revocable y no se puede usar para el inicio de sesión web. Copia .env.example a .env, complétalo y cárgalo en tu shell, o define las variables como mejor gestiones los secretos. Tanto el servidor MCP como la ayuda CLI cargan automáticamente el .env de la raíz del workspace si existe; las variables de entorno ya establecidas por OpenCode o por el shell tienen prioridad. Haz nunca un commit del .env.

Advertencia de interpolación: opencode.json usa placeholders {env:VAR}. Si falta una variable cuando OpenCode arranca, se convierte en una cadena vacía y toda llamada de herramienta fallará con un error claro que nombra la variable o variables que faltan (Missing required environment variables: ODOO_USERNAME, ...) en lugar de enviar credenciales incorrectas a algún sitio. Los valores nunca se muestran en los logs ni en los resultados.

Registro con OpenCode

opencode.json de este workspace ya contiene:

{
  "mcp": {
    "odoo": {
      "type": "local",
      "command": ["uv", "run", "python", "-m", "odoo_mcp"],
      "environment": { "...": "{env:ODOO_*} placeholders" },
      "enabled": true
    }
  }
}

OpenCode carga la configuración al arrancar; después de cambiar las credenciales o este archivo, sal y reinicia OpenCode para que los cambios tengan efecto. El servidor se lanza una vez por sesión y escucha en ningún puerto de red.

Herramientas

Las herramientas de mutación se ejecutan inmediatamente por defecto; todas aceptan un flag dry_run=true que devuelve una vista previa sin escribir nada.

Los códigos de estado varían de un Odoo a otro — llama primero a get_task_states en lugar de adivinar; los estados no válidos se rechazan con la lista de los válidos.

Verificar la instalación

uv sync                                              # deps resolve
uv run pytest tests -q                               # protocol + service suites
uv run python -m unittest discover -s tests -v       # CLI characterization suite
uv run python odoo_tasks.py --help                   # legacy CLI still intact

El propio handshake de stdio está cubierto por tests/test_stdio_smoke.csé.