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-ключ пользователя.
Настройка клиентов
{
"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:
- Установите модуль и откройте Settings > MCP Server.
- В Enabled Models добавьте нужные модели и задайте права (чтение, запись, создание, удаление).
- Создайте API-ключ пользователя (Settings > Users & Companies > Users, вкладка API Keys); в Odoo 20 ключу нужна область
rpc. - Добавьте пользователя в группу MCP User.
Обязательные переменные: ODOO_URL и ODOO_API_KEY (или ODOO_USER и ODOO_PASSWORD); ODOO_DB определяется автоматически, если список баз доступен.
Подключение к клиентам
Конфиги приведены дословно из README; замените адрес, ключ и базу на свои. Подробнее — в инструкции как подключить MCP.
{
"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 и выполнение кода.
MCP BSL Platform Context
MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.