Odoo MCP server для OpenCode

В этом рабочем пространстве есть локальный stdio MCP-сервер (odoo_mcp), который открывает задачи вашего размещённого у себя Odoo, ленту обсуждений (chatter) и таймшиты как девять типизированных инструментов, к которым агент может обращаться напрямую. В этом же репозитории по-прежнему находится оригинальный CLI odoo_tasks.py — без изменений в поведении — который использует общий сервисный слой с MCP-сервером.

Предварительные требования

• Python 3.10+ (рабочее пространство разрабатывалось под 3.12)

• uv в PATH (pip install uv, если отсутствует)

Установите всё один раз:

uv sync

Related MCP server: MCP Server for Odoo

Учётные данные (переменные окружения)

ODOO_URL должен быть абсолютным HTTPS-URL, чтобы учётные данные никогда не передавались по незашифрованному HTTP.

Настоятельно рекомендуется использовать API-ключ, а не пароль (Odoo: Preferences → Account Security → New API Key): его можно отозвать, и он не подходит для входа в веб-интерфейс. Скопируйте .env.example в .env, заполните его и загрузите в свою оболочку — либо задайте переменные так, как вы обычно управляете секретами. И MCP-сервер, и CLI-помощник автоматически загружают .env из корня рабочего пространства, если он есть; переменные окружения, уже заданные OpenCode или оболочкой, имеют приоритет. Никогда не коммитьте .env.

Оговорка об интерполяции: opencode.json использует плейсхолдеры {env:VAR}. Если при запуске OpenCode какой-то переменной не хватает, она становится пустой строкой, и каждый вызов инструмента завершится с понятной ошибкой, в которой названы недостающие переменные (Missing required environment variables: ODOO_USERNAME, ...), а не с отправкой некорректных учётных данных куда-либо. Значения никогда не выводятся в логи или результаты.

Регистрация в OpenCode

opencode.json в этом рабочем пространстве уже содержит:

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

OpenCode загружает конфигурацию при запуске — после изменения учётных данных или этого файла закройте и перезапустите OpenCode, чтобы они вступили в силу. Сервер запускается один раз за сессию через stdio; никакой сетевой порт не прослушивается.

Инструменты

Инструменты, изменяющие данные, по умолчанию выполняются сразу; каждый из них принимает флаг dry_run=true, который возвращает предпросмотр без записи чего-либо.

Коды состояний различаются в зависимости от сборки Odoo — сначала вызовите get_task_states, а не угадывайте; недопустимые состояния отклоняются вместе со списком допустимых.

Проверка установки

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

Само рукопожатие канала stdio покрыто тестом tests/test_stdio_smoke.py.