OpenCode × Odoo (MCP)

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

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

https://mcp.planapulse.com/mcp

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

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

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

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

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

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

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

Как работи

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

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

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

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

Добавете MCP сървъра под ключа mcp в конфигурацията на OpenCode. Използвайте глобалната конфигурация ~/.config/opencode/opencode.json, за да е достъпен навсякъде, или opencode.json в корена на проект — само за този проект:

json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "plana-odoo": {
      "type": "remote",
      "url": "https://mcp.planapulse.com/mcp",
      "enabled": true
    }
  }
}

plana-odoo е просто локалното име на сървъра — наречете го както искате.
"type": "remote" казва на OpenCode, че това е хостван (HTTP) сървър, а не локална команда.

Предпочитате воден процес? Изпълнете opencode mcp add и следвайте подканите, за да добавите remote сървър с горния адрес.

OpenCode се грижи за OAuth входа вместо вас. Задействайте го веднъж:

bash

opencode mcp auth plana-odoo

Браузърът ви се отваря; влезте със същия Google акаунт, който администраторът ви е добавил в списъка с разрешени потребители, и одобрете. OpenCode запазва получения токен локално и го използва повторно.

Потвърдете връзката — това извежда вашите сървъри и техния статус:

bash

opencode mcp list

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

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

И двете се решават от вашия администратор — пишете ни ↗. Вижте Отстраняване на проблеми. За диагностика на проблем с връзката изпълнете opencode mcp debug plana-odoo.

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

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

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

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

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

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

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

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

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

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

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

Тъй като инструментите са общи, OpenCode може да изгради почти всяка справка — счетоводство, продажби, склад, 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 и го задайте отново
`opencode mcp auth` не се разпознава	OpenCode е твърде стар за вградения MCP OAuth	Обновете OpenCode до скорошна версия
Свързан е, но няма нито един инструмент	Google акаунтът, с който сте влезли, не е в списъка с разрешени потребители (или е деактивиран), или е друг Google акаунт, а не този, който е добавил администраторът. API ключът и правата в Odoo още нямат значение	Проверете с кой Google акаунт сте влезли и го изпратете на администратора си (пишете ни ↗). След като бъде добавен, отворете нов чат или сесия
Остава само един инструмент и той казва „пробният ви период изтече“	Пробният период е свършил; достъпът е спрян автоматично в посочения час	Свържете се с PLANA на contact@planapulse.ai, за да продължите. Нищо не е изтрито: след удължаване отворете нов чат или сесия
Сървърът се показва като несвързан	Входът не е завършен или има временна грешка	Изпълнете отново `opencode mcp auth plana-odoo`, след това `opencode mcp debug plana-odoo`
„This server is read-only“ при заявка за промяна на данни	По дизайн — сървърът не може да пише в Odoo	Правете промените директно в Odoo

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

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

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

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

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

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

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

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

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

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

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

OpenCode × Odoo (MCP) ​

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

Как работи ​

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

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

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

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

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

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