Gemini × Odoo (MCP)

PLANA Odoo MCP сървърът позволява на Gemini CLI — отворения команден AI агент на Google — да чете и анализира вашия PLANA Business Cloud (Odoo) ERP на обикновен език. Попитайте „колко фактурирахме миналия месец?“ или „кои продукти са под точката си на презареждане?“ и Gemini прави заявката към Odoo вместо вас и написва отговора.

Говори MCP (Model Context Protocol) през един-единствен хостван адрес:

https://mcp.planapulse.com/mcp

Използвате друг инструмент?

Същият сървър работи с всеки MCP клиент. Вижте ръководствата за Claude и OpenCode.

Само за четене и с вашите права

Сървърът може само да чете — може да търси, брои, групира и чете записи, но никога не може да създава, променя или изтрива нищо в Odoo. Свързва се като вас, с вашия собствен Odoo API ключ, така че виждате единствено данните, до които вашият Odoo акаунт вече има достъп.

Преди да започнете

Нужни са ви четири неща:

Акаунт в PLANA Business Cloud (Odoo) — обичайният ви вход в Odoo.
Достъп, предоставен от вашия PLANA администратор. Достъпът е с покана: администратор добавя вашия Google имейл в списъка с разрешени потребители, свързва го с вашата Odoo инстанция и оторизира влизането ви с Google. Ако още не сте добавени, пишете ни да активираме акаунта ви ↗.
Скорошна инсталация на Gemini CLI — вграденият OAuth за отдалечени MCP сървъри изисква актуална версия (npm update -g @google/gemini-cli).
Адресът на сървъра: https://mcp.planapulse.com/mcp.

Как работи

Свързването е три стъпки, които се правят еднократно:

  ┌────────────────┐   1. добавяне   ┌─────────────────────┐   2. вход с Google  ┌──────────┐
  │   Gemini CLI   │ ──────────────▶ │  mcp.planapulse.com │ ────── OAuth ─────▶ │  Google  │
  │   (терминал)   │ ◀────────────── │   (PLANA Odoo MCP)  │ ◀──── вие сте X ─── └──────────┘
  └────────────────┘   инструменти   └─────────────────────┘
                                                │ 3. вашият Odoo API ключ
                                                ▼
                                         ┌──────────────┐
                                         │ Вашето Odoo  │  (само за четене, като вас)
                                         └──────────────┘

Добавете сървъра в конфигурацията на Gemini CLI.
Влезте с Google — така доказвате кой сте.
Свържете своето Odoo, като дадете на сървъра Odoo API ключ — еднократно — за да може да чете от ваше име.

Два входа с Google — умишлено

Gemini CLI влиза с Google, за да използва самия Gemini; стъпката по-долу е отделен вход с Google, който свързва PLANA Odoo MCP сървъра. За MCP входа използвайте акаунта си от списъка с разрешени потребители.

Стъпка 1 · Добавете сървъра

Добавете сървъра с една команда. --transport http е важно — казва на Gemini CLI да ползва Streamable HTTP, а -s user го прави достъпен във всичките ви проекти:

bash

gemini mcp add --transport http -s user plana-odoo https://mcp.planapulse.com/mcp

plana-odoo е просто локалното име на сървъра — наречете го както искате.

Или го добавете на ръка в ~/.gemini/settings.json (за целия потребител) или .gemini/settings.json (само за текущия проект):

json

{
  "mcpServers": {
    "plana-odoo": {
      "httpUrl": "https://mcp.planapulse.com/mcp"
    }
  }
}

Използвайте httpUrl, а не url

Нашият сървър използва Streamable HTTP, което Gemini CLI избира чрез полето httpUrl. Полето url е за стари SSE сървъри и връзката тук няма да се осъществи.

По-късно управлявайте сървърите с gemini mcp list, gemini mcp remove plana-odoo и gemini mcp disable plana-odoo / enable.

Стартирайте Gemini CLI и проверете сървъра:

bash

gemini

В сесията изпълнете /mcp, за да видите статуса на сървъра. Ако е нужно удостоверяване, задействайте входа:

/mcp auth plana-odoo

Браузърът ви се отваря; влезте със същия Google акаунт, който администраторът ви е добавил в списъка с разрешени потребители, и одобрете. Gemini CLI запазва получения токен и го използва повторно. Изпълнете /mcp отново, за да потвърдите, че plana-odoo е CONNECTED и инструментите odoo_* са изброени.

Входът е блокиран или достъпът е отказан?

„Access blocked / this app isn't verified“ от Google → вашият Google акаунт още не е оторизиран.
Влезли сте, но сървърът казва, че достъпът е отказан → имейлът ви не е в списъка с разрешени потребители (или е бил деактивиран).

И двете се решават от вашия администратор — пишете ни ↗. Вижте Отстраняване на проблеми.

Стъпка 3 · Свържете своето Odoo

Влизането доказва кой сте; на сървъра все още му трябва Odoo API ключ, за да чете данни като вас. Давате го веднъж и той се съхранява криптиран под вашата самоличност.

Помолете Gemini да „вземе инструкциите за настройка на Odoo“ (това извиква инструмента get_odoo_setup_instructions) или следвайте тези стъпки във вашето Odoo:

Отворете своята Odoo инстанция в браузъра и влезте.
Натиснете аватара си (горе вдясно) → My Profile (Preferences).
Отворете таба Account Security.
Натиснете New API Key. Може да се наложи да въведете отново паролата си / 2FA.
Наименувайте го (напр. Plana MCP) и по избор задайте срок на валидност.
Копирайте ключа веднага — Odoo го показва само веднъж.

След това го дайте на Gemini — кажете „задай моите Odoo идентификационни данни“ и поставете ключа (това извиква set_odoo_credentials). Ключът се проверява срещу вашето Odoo и се запазва криптиран.

Проверете връзката си

Помолете Gemini да „провери статуса на връзката“ (get_connection_status) по всяко време, за да видите към коя Odoo инстанция сте свързани и дали ключът ви е зададен.

Това е всичко — свързани сте. Оттук нататък Gemini може да чете вашия ERP, когато го помолите.

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

Сървърът предоставя малък набор от общи инструменти само за четене. Рядко ще ги извиквате по име — просто попитайте на обикновен език и Gemini избира правилния:

Инструмент	Какво прави
`odoo_list_models` · `odoo_get_fields`	Открива какви данни съществуват и кои полета са налични
`odoo_search_read` · `odoo_read`	Чете записи по филтър или по id
`odoo_search_count`	Брои записи (евтино)
`odoo_read_group`	Агрегира — суми, средни стойности, броеве — за справки
`odoo_name_search`	Намира клиент / продукт / сметка по име

Тъй като инструментите са общи, Gemini може да изгради почти всяка справка — счетоводство, продажби, склад, CRM — без предварително готов шаблон. Неща, които можете да попитате:

„Колко отворени клиентски фактури имаме и какво е общото несъбрано вземане?“
„Разбий продажбите за тази година по месеци.“
„Кои са топ 10 наши клиенти по оборот тази година?“
„Кои продукти са под точката си на презареждане в момента?“
„Обобщи просрочените вземания по клиент.“

Отстраняване на проблеми

Симптом	Причина	Решение
Google: „Access blocked / app isn't verified“	Вашият Google акаунт още не е оторизиран за вход	Помолете администратора си да го оторизира — пишете ни ↗
Влезли сте, но „access denied“	Имейлът ви не е в списъка с разрешени потребители или е деактивиран	Свържете се с вашия администратор
„No Odoo instance is configured for you“	Акаунтът ви още не е свързан с Odoo инстанция	Свържете се с вашия администратор
„Invalid API key / login“ при задаване на данните	Грешен или изтекъл ключ, или входът не съвпада	Създайте нов API ключ в Odoo и го задайте отново
Сървърът не се свързва / „MCP issues detected“	Използвано е `url` вместо `httpUrl` или версията е стара	Минете на `httpUrl`, обновете Gemini CLI, после изпълнете `/mcp auth plana-odoo`
Свързан е, но няма нито един инструмент	Google акаунтът, с който сте влезли, не е в списъка с разрешени потребители (или е деактивиран), или е друг Google акаунт, а не този, който е добавил администраторът. API ключът и правата в Odoo още нямат значение	Проверете с кой Google акаунт сте влезли и го изпратете на администратора си (пишете ни ↗). След като бъде добавен, отворете нов чат или сесия
Остава само един инструмент и той казва „пробният ви период изтече“	Пробният период е свършил; достъпът е спрян автоматично в посочения час	Свържете се с PLANA на contact@planapulse.ai, за да продължите. Нищо не е изтрито: след удължаване отворете нов чат или сесия
Инструментите не се появяват	Входът не е завършен	Изпълнете `/mcp auth plana-odoo`, след това `/mcp` за потвърждение
„This server is read-only“ при заявка за промяна на данни	По дизайн — сървърът не може да пише в Odoo	Правете промените директно в Odoo

Често задавани въпроси

Може ли да променя или изтрива нещо в моето Odoo?

Не. Сървърът е строго само за четене — може да търси и чете, но не може да създава, променя или изтрива записи.

Какви данни вижда Gemini?

Само това, което вашият Odoo потребител има право да вижда. Свързва се с вашия собствен API ключ, така че съществуващите ви права за достъп в Odoo важат непроменени.

Записва ли се моята активност?

Да. Всяко извикване на инструмент се записва в одитен журнал (кой, кой инструмент, кой модел, статус, време). Журналът съхранява само метаданни и кратки обобщения — никога съдържанието на вашите ERP записи.

Къде се съхранява моят API ключ?

Криптиран при съхранение и обвързан с вашата самоличност. Можете да го замените по всяко време, като създадете нов ключ в Odoo и го зададете отново.

Към коя Odoo инстанция се свързвам?

Тази, която администраторът е задал за вашия акаунт. Всеки потребител е обвързан с една Odoo инстанция — не я избирате при свързване.

Gemini × Odoo (MCP) ​

Преди да започнете ​

Как работи ​

Стъпка 1 · Добавете сървъра ​

Стъпка 2 · Влезте с Google ​

Стъпка 3 · Свържете своето Odoo ​

Какво можете да правите ​

Отстраняване на проблеми ​

Често задавани въпроси ​