Odoo MCP-пилот: чтение продаж и остатков с границами

Odoo MCP-пилот Tvijo проверяет практическую задачу: может ли ассистент дать проверяемый ответ о продажах и запасах в строго ограниченном режиме чтения? Первый прототип использует вымышленные данные. Реальная Odoo и выпущенный клиент TvijoCode требуют отдельной приёмки.

Статус: экспериментальный пилот, 29 октября 2026 года. Каталог бизнес-интеграций.

Кому подходит проверка

Odoo-интеграторам, дистрибьюторам и аналитикам, которым нужна сверка исходных данных перед большой автоматизацией. Первое предложение — диагностика или пилот одной задачи с владельцем данных и согласованным контрольным отчётом.

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

• «Покажи подтверждённые заказы за период, раздели валюты и укажи, полный ли ответ».
• «Прочитай физические остатки и резервы разрешённой компании; объясни значения».
• «Сравни разрешённую выгрузку с контрольным отчётом и перечисли расхождения для специалиста».

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

Что существует и что предстоит

Синтетическая демонстрация

За период 1–29 октября 2026 года включительно, UTC, в фикстуре есть два разрешённых подтверждённых заказа: DEMO-S001: 1 200 UAH; DEMO-S002: 800 UAH. Суммы вымышлены и не являются реальными продажами. Черновик заказа и заказ другой компании исключаются.

У первого складского товара 50 физических единиц и 12 единиц в резерве. Это отдельные поля. Их разность не является полным расчётом доступного к обещанию количества. В production нужно проверить единицы измерения.

Инструменты: odoo_connection_status, odoo_sales_read, odoo_inventory_read. Статус описывает конфигурацию, а не доказывает успешное live-подключение. Чтение возвращает компанию, модель-источник, поля, время наблюдения, режим synthetic/live и признак усечения. Одну страницу нельзя выдавать за полный оборот компании.

Закрытый прототип работает через stdio на официальном MCP Python SDK. После согласования доступа демонстрация запускается без ERP-ключей. В открытой документации есть пример; реализация не опубликована как общедоступный установочный пакет.

Сначала проверьте совместимость

Первый live-вариант рассчитан на Odoo 19 JSON-2 с отдельным пользователем только для чтения и фиксированными моделями. Официальная документация Odoo описывает API и права конкретной версии. Для соответствующего облачного предложения Odoo внешний API доступен на Custom; One App Free и Standard не подходят для этого пути. Self-hosted требует отдельной проверки.

Проверяются фактические версия, редакция, размещение, модули, схема базы, компания, права на записи и поля. Первый адаптер поддерживает публичные HTTPS-имена на порту443; внутренние/VPN-инсталляции требуют отдельного рассмотрения сетевого профиля.

Пилот читает подтверждённые заказы с налогом в amount_total, а не бухгалтерскую выручку по проведённым документам. Он читает складские quants и резервы, а не оценку запасов или готовое решение о закупке. Лимит — 100 возвращаемых записей за вызов и период продаж до366 дней. Большая выгрузка требует отдельно проверенных пагинации и сверки.

Границы данных и действий

В прототипе нет инструментов записи в ERP, платежей, проведения счетов, произвольного выполнения методов или SQL. Компания и список полей задаются вне разговора. Права ERP обязательны; компания в ответе проверяется повторно до передачи клиенту.

Локальный stdio не гарантирует локальную обработку моделью: клиент может отправлять ответ внешнему провайдеру. До работы с реальными записями согласуйте поля, провайдера и хранение. Ключи нельзя вставлять в промпт, публичное обращение или исходный код. Текст из ERP — недоверенные данные, а не разрешение выполнять команды.

Прототип не является сертификатом безопасности. Ещё нужны проверки реальных прав, отзыва ключа, зависимостей, безопасности и установки в точной сборке клиента. Для синтетической демонстрации production ERP не использовалась.

Украинская локализация и аналитика

В Odoo 19 есть официальный модуль l10n_ua, описывающий украинский учёт и план счетов. Наличие модуля не доказывает полного покрытия зарплаты, налогов, отчётности и документооборота вашей компании. Установленный пакет и требования проверяют бухгалтер и Odoo-специалист. MCP не предоставляет такого соответствия.

Прогноз спроса требует собственных доказательств: определения цели и горизонта, качественной истории, учёта отсутствия товара, сезонного наивного baseline и rolling backtest. ARIMA/SARIMA, Prophet и градиентный бустинг — кандидаты, а не автоматическая польза от подключения MCP. DWH требует отдельных ETL, сверки и измерений SQL-производительности.

Что должен доказать пилот

1. Пользователь видит только согласованные компанию, модели и поля; запрещённое чтение отклоняется.
2. Записи совпадают с контрольным отчётом при одинаковых определении и моменте среза.
3. Конкретная сборка клиента обнаруживает инструменты и выполняет разрешённое чтение без утечки ключа.
4. Пользователь повторяет полезную задачу; время, ошибки и поддержку измеряют относительно исходного процесса.

Успешная синтетическая проверка не закрывает live-требования автоматически. Процент экономии времени, рост выручки и точность прогноза не обещаются.

Запросить проверку задачи

Открыть публичный запрос пилота с аккаунтом GitHub. Укажите только нечувствительную задачу, версию Odoo, размещение и свою роль. До передачи конфиденциальных сведений запросите закрытый канал. Не прикладывайте выгрузки, персональные данные и ключи.

Предлагаем диагностику, затем двухнедельный пилот одного согласованного сценария. Объём, приёмка и цена фиксируются письменно. Эта страница не является оплатой, автоматическим зачислением в пилот или обещанием production-совместимости.

Источники и альтернативы

Технические источники автоматически просмотрены 29 октября 2026 года; человеческая экспертная проверка не заявляется.

• Odoo 19 external API.
• MCP Python SDK.
• Рекомендации безопасности MCP.
• Уже существуют FGRibreau/mcp-odoo и oconsole/odoo-mcp-server. Описания возможностей принадлежат разработчикам; мы их независимо не тестировали и не сертифицируем.

Предлагаемая ценность Tvijo — проверенный сценарий, установка и сопровождение конкретной клиентской задачи. Само наличие MCP не является уникальным преимуществом.