Odoo (MCP server) в MCP: поиск, итоги и изменение записей Odoo из любого AI-агента

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Odoo (MCP server), вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Odoo (MCP server)

Подключите Claude, ChatGPT или Copilot к Odoo через собственный MCP-сервер Odoo (Odoo AI, Odoo Online saas-19.4 и Odoo 20): поиск по любой модели, группировка и итоги по записям, списки моделей и полей, а если администратор разрешит, то и создание и изменение записей. Права определяются пользователем Odoo и инструментами AI Tools, которые открыл ваш администратор.

Настройка

Настройка занимает около 5 минут. Нужна база данных Odoo с собственным MCP-сервером Odoo: Odoo Online начиная с версии saas-19.4 или Odoo 20, с установленным приложением AI. Версия указана внизу страницы Settings, а база с MCP-сервером предлагает область MCP при создании API-ключа.

1. В Odoo нажмите на свой аватар и откройте My Preferences (или My Profile) → Security → Add API Key. Подтвердите пароль и дайте ключу имя.
2. Выберите Scope MCP и в поле Expires укажите срок действия. Odoo показывает ключ только один раз, поэтому сразу скопируйте его. Создайте ключ от отдельного пользователя Odoo, чьи права доступа соответствуют тому, что можно видеть ассистенту: ключ действует от имени этого пользователя.
3. Вставьте ключ в ODOO_MCP_API_KEY. Это 40 строчных шестнадцатеричных символов; слово Bearer добавлять не нужно.
4. В ODOO_URL укажите адрес, по которому вы открываете Odoo, до имени хоста, например https://mycompany.odoo.com. Не добавляйте /odoo, /web, /mcp и косую черту в конце: /mcp коннектор добавит сам.
5. Установите коннектор и запустите odoo_mcp_ai_tool_mcp_retrieve_initial_context: он покажет вошедшего пользователя, его часовой пояс, активную компанию и все компании, между которыми он может переключаться.

Какой коннектор Odoo выбрать? Этот предназначен для баз с собственным MCP-сервером Odoo, где администратор Odoo решает, какие инструменты доступны и какие изменения разрешены. Для Odoo 19.0 (в нём нет MCP-сервера), для Odoo.sh или своего сервера без MCP-сервера, а также если вам нужны готовые инструменты для контрагентов, заказов продаж, счетов и товаров, используйте коннектор Odoo (JSON-2 API, Odoo 19 и новее). Для Odoo с 14 по 18 версию используйте Odoo 14-18 (JSON-RPC).

Инструменты приходят из вашей базы: при установке AnythingMCP спрашивает у MCP-сервера Odoo, какие инструменты он открывает. По умолчанию это Get Models, Get Fields, Search, Read group и MCP Retrieve initial context, все только для чтения, и Odoo выполняет их с правами пользователя, которому принадлежит ключ. Администратор может открыть и другие (Create Records, Update Records, меню, инструменты для сайта и изображений) в режиме разработчика в Settings → Technical → Server Actions, отметив Available in MCP на вкладке Usage инструмента. Затем откройте коннектор здесь и нажмите Discover tools. Генерация изображений расходует кредиты Odoo AI.

Что он читает: любую модель, которую может открыть пользователь Odoo, например контакты, заказы продаж, счета или товары. odoo_mcp_ai_tool_get_models находит нужную модель, odoo_mcp_ai_tool_get_fields показывает её поля, odoo_mcp_ai_tool_search ищет записи по домену Odoo, а odoo_mcp_ai_tool_read_group группирует их и считает итоги по дням, неделям, месяцам, кварталам или годам: выручка по месяцам, счета по клиентам, лиды по этапам.

Спрашивает перед каждым изменением: при установке ни один инструмент записи не включён. Когда администратор включит создание или изменение записей, ИИ покажет вам записи и точные значения и дождётся вашего согласия, прежде чем что-то записать.

Отключено при установке: odoo_mcp_ai_tool_create_records и odoo_mcp_ai_tool_update_records. Odoo скрывает их, пока администратор не откроет их для MCP, а здесь они к тому же устанавливаются выключенными, потому что создают записи или меняют значения полей у всех записей, подходящих под домен. Включайте их по одному, только если ассистент действительно должен менять данные в Odoo.

Ограничения: Search по умолчанию возвращает 50 записей и не больше 200 за вызов, поэтому большие выборки ИИ читает постранично, а для итогов использует Read group, вместо того чтобы загружать тысячи строк. API-ключ перестаёт действовать в день, выбранный в Expires: тогда создайте новый и вставьте его.

Частые ошибки: 401 означает, что ключ неверный, просрочен или создан без области MCP. 404 на /mcp означает, что у базы нет MCP-сервера (версия старше saas-19.4 или не установлено приложение AI): используйте коннектор Odoo или Odoo 14-18 (JSON-RPC). Odoo публикует Get Fields без параметров, но инструмент не работает без model_name и include_description, поэтому ИИ всегда передаёт оба.

Коннектор не добавляет инструменты, которые ваш Odoo не открывает, не выходит за права доступа пользователя Odoo, стоящего за ключом, и не работает с базами без MCP-сервера Odoo.

Предварительные требования: ODOO_URL, ODOO_MCP_API_KEY

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите Odoo (MCP server) и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Какой была наша выручка по подтверждённым заказам по месяцам в этом году? Дай итог за каждый месяц.»
• «У каких клиентов есть просроченные неоплаченные счета и сколько должен каждый из них?»
• «Найди контакт ООО Стройдом и покажи его email, телефон и ответственного менеджера.»
• «Какие десять товаров мы продали больше всего по количеству в прошлом квартале?»
• «Измени email контакта Анна Смирнова на [email protected]. Покажи запись, прежде чем её менять.»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT