MCP Server for Odoo
MCP-сервер для Odoo: агент читает, создает и обновляет записи ERP, ищет данные и вызывает бизнес-операции через права Odoo
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает, обновляет и удаляет записи в базе ERP
- Требует ключ API или логин с паролем к экземпляру Odoo
- Режим YOLO и вызов методов моделей обходят проверки безопасности
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-for-odooОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'ODOO_URL=<значение ODOO_URL>' odoo -- uvx mcp-server-odooИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"odoo","type":"stdio","command":"uvx","args":["mcp-server-odoo"],"env":{"ODOO_URL":"<значение ODOO_URL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"odoo": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add odoo --env 'ODOO_URL=<значение ODOO_URL>' -- uvx mcp-server-odooИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.odoo]
command = "uvx"
args = ["mcp-server-odoo"]
env = { ODOO_URL = "<значение ODOO_URL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'ODOO_URL=<значение ODOO_URL>' odoo uvx mcp-server-odooИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"odoo": {
"type": "local",
"command": [
"uvx",
"mcp-server-odoo"
],
"environment": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_URL": "<значение ODOO_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_URLобязательнаяODOO_API_KEYсекрет, необязательнаяODOO_DBнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь в конфигурацию MCP клиента сервер odoo с командой uvx и аргументом mcp-server-odoo. В блоке env пропиши ODOO_URL, ODOO_API_KEY и при необходимости ODOO_DB.
Другие способы из описания автора
{
"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"
}
}
}
}Запуск через uvx из PyPI. Сервер работает на вашей машине, нужен uv.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту доступ к системе Odoo ERP через стандартные ресурсы и инструменты. Агент ищет и достает любые записи, от клиентов и товаров до счетов, создает новые записи с проверкой полей и прав, обновляет и удаляет данные с учетом разрешений модели и считает записи по условиям. Есть агрегация на стороне сервера, вызов публичных бизнес-методов как отдельная опция, работа с вложениями и бинарными файлами через URI ресурсов и умный выбор полей под каждую модель. Ставится через uvx с PyPI или запускается в docker.
Для кого. Для разработчиков, специалистов по продажам и финансам, которые работают с данными в Odoo.
Подходит, если
- Нужно искать и доставать записи Odoo из агента
- Нужно создавать или обновлять данные ERP с проверкой прав
- Нужна сводка или агрегация по записям на стороне сервера
Не подходит, если
- Нет доступа к экземпляру Odoo или прав пользователя
- Не хотите давать агенту запись в боевую базу ERP
- Нужен только предпросмотр, а не изменяющие операции
Пример запроса к агенту
Найди в Odoo неоплаченные счета за последний месяц и покажи сумму по клиентамОграничения
Нужен доступ к экземпляру Odoo: обязательна переменная ODOO_URL, для входа используется ключ ODOO_API_KEY или пара ODOO_USER и ODOO_PASSWORD. Для боевого режима нужен модуль MCP на стороне Odoo и версия 16 и новее, режим YOLO для тестов обходит проверки безопасности и годится только для демо. Вызов методов моделей включается отдельно и требует YOLO, это опасная опция. Сервер работает на вашей машине, а не на сервере Odoo.
Как отключить. Удалите запись odoo из конфигурации MCP клиента, остановите контейнер docker, если он запущен, и отзовите ключ API в настройках Odoo.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ODOO_URL обязательная | Адрес экземпляра Odoo |
| ODOO_API_KEY секрет | Ключ API для входа, альтернатива паре логин и пароль |
| ODOO_USER | Логин, если вход без ключа API |
| ODOO_PASSWORD секрет | Пароль, если вход без ключа API |
| ODOO_DB | Имя базы, если оно не определяется автоматически |
Проверка безопасности
- Создает, обновляет и удаляет записи в базе ERP
- Требует ключ API или логин с паролем к экземпляру Odoo
- Режим YOLO и вызов методов моделей обходят проверки безопасности
Коротко о README
README описывает сервер, который дает ассистентам доступ к Odoo ERP: поиск, чтение, создание, обновление и удаление записей, подсчет, инспекция полей, серверная агрегация, вызов бизнес-методов как опция и работа с вложениями. Показаны установка UV и конфигурации для Claude Desktop, Claude Code, Cursor и VS Code через uvx mcp-server-odoo, а также запуск в docker. Приведена таблица переменных: ODOO_URL, ODOO_API_KEY, ODOO_USER, ODOO_PASSWORD, ODOO_DB и другие. Отдельно описан тестовый режим YOLO. Лицензия MPL-2.0.
Частые вопросы
Что нужно на стороне Odoo?
Для боевого режима нужен модуль MCP для Odoo и версия 16 и новее. Режим YOLO работает без модуля, но обходит проверки безопасности и подходит только для тестов.
Как настроить вход?
Обязателен ODOO_URL. Для входа задают ODOO_API_KEY либо пару ODOO_USER и ODOO_PASSWORD. Базу можно указать в ODOO_DB, если она не определяется автоматически.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма