Claude × Odoo (MCP)

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

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

https://mcp.planapulse.com/mcp

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

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

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

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

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

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

Акаунт в PLANA Business Cloud (Odoo) — обичайният ви вход в Odoo.
Достъп, предоставен от вашия PLANA администратор. Достъпът е с покана: администратор добавя вашия Google имейл в списъка с разрешени потребители, свързва го с вашата Odoo инстанция и оторизира влизането ви с Google. Ако още не сте добавени, пишете ни да активираме акаунта ви ↗.
Клиент с поддръжка на MCP — Claude Code, Claude Desktop, Cursor или VS Code.
Адресът на сървъра: https://mcp.planapulse.com/mcp.

Как работи

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

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

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

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

Изберете своя клиент. С Claude Code става най-бързо.

Claude Code (CLI)

Добавете сървъра с една команда:

bash

claude mcp add --transport http plana-odoo https://mcp.planapulse.com/mcp

plana-odoo е просто локалното име на сървъра — наречете го както искате.
Добавете --scope user, за да е достъпен във всички ваши проекти (по подразбиране е само за текущия проект).

Проверете дали е добавен или го премахнете по-късно:

bash

claude mcp list                 # показва конфигурираните сървъри + статус
claude mcp remove plana-odoo    # премахва го

Claude Desktop

Отдалечените конектори изискват платен план на Claude (Pro, Max, Team или Enterprise).

Settings → Connectors.
Натиснете Add custom connector.
Наименувайте го PLANA Odoo и задайте URL https://mcp.planapulse.com/mcp.
Натиснете Add.

Cursor

Добавете сървъра в ~/.cursor/mcp.json (глобално) или .cursor/mcp.json (само за текущия проект):

json

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

Рестартирайте Cursor, за да отрази промяната.

VS Code

Изпълнете MCP: Open User Configuration от Command Palette (Cmd/Ctrl + Shift + P) и добавете:

json

{
  "servers": {
    "plana-odoo": {
      "type": "http",
      "url": "https://mcp.planapulse.com/mcp"
    }
  }
}

Първия път, когато клиентът се свърже, той отваря браузъра ви за вход с Google. Така сървърът разбира кой сте.

Claude Code: изпълнете /mcp в сесия, изберете plana-odoo и след това Authenticate. Браузърът се отваря; влезте с Google и одобрете.
Claude Desktop / Cursor / VS Code: входът се задейства автоматично първия път, когато вие (или асистентът) използвате инструмент. Следвайте подканата в браузъра.

Влезте със същия Google акаунт, който администраторът ви е добавил в списъка с разрешени потребители. След успешен вход клиентът показва сървъра като свързан и инструментите odoo_* стават достъпни.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Тъй като инструментите са общи, асистентът може да изгради почти всяка справка — счетоводство, продажби, склад, 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 и го задайте отново
Инструментите не се появяват / „not connected“	Входът не е завършен	Изпълнете отново `/mcp` (Claude Code) или отворете конектора и се удостоверете пак
„This server is read-only“ при заявка за промяна на данни	По дизайн — сървърът не може да пише в Odoo	Правете промените директно в Odoo

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

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

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

Какви данни вижда асистентът?

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

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

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

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

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

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

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

Claude × Odoo (MCP) ​

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

Как работи ​

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

Claude Code (CLI) ​

Claude Desktop ​

Cursor ​

VS Code ​

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

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

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

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

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