mcp-server-odoo

mcp-server-odoo — MCP-сервер сообщества (автор — ivnvxd). Подключение к ERP Odoo: данные, записи и автоматизация процессов. Ставится через Docker или через pip. Лицензия MPL-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
ivnvxd
Лицензия
MPL-2.0
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Создаёт, изменяет и удаляет записи Odoo; режим YOLO=true обходит все проверки; call_model_method только с YOLO; API-ключ пользователя.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"odoo\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-odoo\"],\n      \"env\": {\n        \"ODOO_URL\": \"https://your-odoo-instance.com\",\n        \"ODOO_API_KEY\": \"your-api-key-here\",\n        \"ODOO_DB\": \"your-database-name\"\n      }\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

MCP Server for Odoo позволяет ИИ-ассистентам работать с ERP-системой Odoo обычным языком: искать записи (клиентов, товары, счета), создавать, изменять и удалять их, агрегировать данные и управлять экземпляром. Для рабочего использования нужен модуль Odoo MCP в самом Odoo, а для быстрых тестов и демонстраций есть режим YOLO, который работает с любой стандартной установкой Odoo.

Инструменты по README:

  • чтение: search_records, get_record, get_fields, list_models, get_current_context (пользователь, часовой пояс, компания), умный выбор полей и постраничный вывод;
  • запись: create_record и create_records, update_record и update_records, delete_record с учётом прав модели;
  • агрегирование: aggregate_records — группировка, суммы и подсчёт на сервере без выгрузки всех строк;
  • вложения и сообщения: чтение и загрузка вложений, список вложений записи, post_message в чаттер;
  • бизнес-методы: call_model_method вызывает публичные методы (проведение счёта, подтверждение заказа) — по отдельному разрешению;
  • ресурсы: изображения, документы и файлы ir.attachment по URI; ответы на нужном языке через ODOO_LOCALE.

Кому подойдёт

  • Компаниям на Odoo, которым нужен доступ к данным ERP из ассистента с контролем прав по моделям.
  • Разработчикам и интеграторам: режим YOLO для тестов на локальном Odoo без установки модуля.

Похожие серверы — в категории бизнес и 1С.

Установка

Нужен Python 3.10+ и uv. Для стандартного режима — Odoo 16.0+ с установленным модулем mcp_server:

  1. Установите модуль и откройте Settings > MCP Server.
  2. В Enabled Models добавьте нужные модели и задайте права (чтение, запись, создание, удаление).
  3. Создайте API-ключ пользователя (Settings > Users & Companies > Users, вкладка API Keys); в Odoo 20 ключу нужна область rpc.
  4. Добавьте пользователя в группу MCP User.

Обязательные переменные: ODOO_URL и ODOO_API_KEY (или ODOO_USER и ODOO_PASSWORD); ODOO_DB определяется автоматически, если список баз доступен.

Подключение к клиентам

Конфиги приведены дословно из README; замените адрес, ключ и базу на свои. Подробнее — в инструкции как подключить MCP.

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

В VS Code корневой ключ — servers, а не mcpServers. Для Claude Code README приводит тот же блок для .mcp.json и команду claude mcp add, а также конфиг для Windsurf.

Проверка

Попросите ассистента вызвать get_current_context — он покажет подключённого пользователя, компанию и часовой пояс. Затем запросите список доступных моделей.

Примеры задач

Найди всех клиентов из Германии и покажи их неоплаченные счета.
Сгруппируй заказы на продажу за прошлый месяц по менеджеру и посчитай суммы.

Риски

  • Запись в ERP. Сервер создаёт, изменяет и удаляет записи. В стандартном режиме действуют разрешения модуля по моделям и права доступа Odoo; включайте только нужные модели и операции.
  • Режим YOLO. ODOO_YOLO=true обходит все проверки MCP и даёт полный доступ ко всем моделям, включая запланированные и серверные действия. README запрещает использовать его в рабочей среде; для демонстраций есть режим только для чтения ODOO_YOLO=read.
  • Вызов методов. call_model_method включается флагом ODOO_MCP_ENABLE_METHOD_CALLS и только вместе с ODOO_YOLO=true — это опасный режим.
  • Учётные данные. API-ключ связан с пользователем и его правами. Используйте HTTPS, отдельного пользователя для агента и регулярно меняйте ключи.
  • Компании. ODOO_ALLOWED_COMPANIES ограничивает контекст вызовов, но это не граница безопасности: для жёсткой изоляции ограничьте компании пользователя в самом Odoo.
  • HTTP-транспорт. По умолчанию слушает только localhost; привязка к 0.0.0.0 открывает сервер в сеть.

Частые вопросы

Обязателен ли модуль Odoo MCP?

Для рабочей среды — да. Без него работает только режим YOLO, предназначенный для разработки и тестов.

Какие версии Odoo поддерживаются?

Стандартный режим — Odoo 16.0 и новее с модулем. Режим YOLO — любая версия с включённым XML-RPC, на Odoo 19+ также JSON-2.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

1C MCP Toolkit

MCP и REST API сервер для баз 1С во внешней обработке: запросы, метаданные, журнал, справка BSL и выполнение кода.

Риск: high Лицензия: GPL-3.0 ★ 371

MCP BSL Platform Context

MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Источники