Odoo MCP Server | FREE | Governed & Audited | Claude · ChatGPT · Gemini | OAuth 2.1 · Per-Model Permissions · Immutable Audit Log
by Faceela FZE LLC https://faceela.comMCP Connector
Turn your Odoo database into a Model Context Protocol server, so an AI assistant can read it and act in it — under permissions you set, as a real Odoo user, with every call written to an audit log.
What it does
Assistants that speak MCP — Claude and others — connect to a single endpoint on your own server. No data is sent anywhere else, and no code is downloaded at runtime.
Nothing is exposed by defaultYou list the models the assistant may reach, one by one. Read, create, update and delete are granted separately on each. A model you did not list cannot be seen, described or touched. |
It acts as a real userEvery call runs in the Odoo user's own environment, so the access rights, record rules and multi-company scoping you already configured apply unchanged. The connector cannot widen them. |
Every call is on the recordWho called, which tool, which model, the arguments, the record ids touched, the duration and the outcome — written to a log that refuses edits and deletions, including from automation. |
The eight tools
A deliberately small surface. Each one is refused unless the matching permission is granted on that model.
| Tool | What the assistant can do | Permission |
|---|---|---|
odoo_list_models | See which models it may reach and what it may do on each. | Always |
odoo_describe_model | Read the fields of a model — types, labels, selections, relations. | Read |
odoo_search | Search with an Odoo domain and read fields back. | Read |
odoo_aggregate | Group and total, the way a pivot view does, instead of pulling thousands of rows. | Read |
odoo_create | Create one record. | Create |
odoo_update | Write values onto existing records. | Update |
odoo_delete | Delete permanently — and only with an explicit confirm. | Delete |
odoo_call_method | Call a business method, such as confirming an order. | Methods you name |
action_confirm,action_post. Anything
not on your list is refused, with the refusal recorded.
Connecting an assistant
- Install the app and open MCP Connector → Exposed Models. Add the models you want reachable and tick the operations you allow.
- Point the assistant at
https://your-odoo/mcp. - Authenticate either way:
- Odoo API key — for a self-hosted client or a script. The key is generated by Odoo itself, in the user's own preferences, and revoked there.
- OAuth 2.1 — for a hosted assistant. The assistant registers itself, the user sees a consent page naming it, and approval issues a token bound to that one user. PKCE is required, codes are single-use, and refresh tokens rotate.
- Watch MCP Connector → Call Log. Filter to Changed Data to see only calls that wrote something.
Built the way Odoo is
- Depends on
basealone — it installs on any Odoo 19 database, with or without Sales, Accounting or anything else. - One administrator group decides what is exposed and reads the log. Any Odoo user may connect, and reaches exactly their own rights, narrowed by the matrix.
- Fully translated to Arabic, and the interface is checked in a right-to-left database, not only in English.
- No external service, no telemetry, no runtime code download. The connector talks only to your own Odoo.
- Three books ship inside the app, under MCP Connector → Help — one for the user, one for the implementer, one for the administrator — alongside an About & Support screen carrying the installed version and our address, so nobody has to leave the database to find out who to write to.
Free, and supported
The price is zero and it stays zero. What that does and does not buy, written plainly.
The whole appNo feature is held back, no record cap, no expiring trial and no licence key. What is described on this page is what installs. |
Support is includedWrite to us about a bug or a configuration question and you get a person, in English or Arabic. Bugs are fixed in the addon and published for everyone; we do not charge for a defect. |
What is quoted separatelyNew features, your own models, an implementation, or training. Those are engagements, priced on their own. They are never a condition of the app working. |
Support is included. Write to support@faceela.com with your Odoo version and what you were doing, and you will get a human answer.
Published by Faceela FZE LLC · faceela.com · Licence OPL-1
موصِّل MCP
حوِّل قاعدة بيانات أودو لديك إلى خادم Model Context Protocol، ليقرأها المساعد الذكي ويعمل فيها — بالصلاحيات التي تحددها أنت، وباسم مستخدم أودو حقيقي، مع تسجيل كل نداء في سجل تدقيق.
ما الذي يفعله
المساعدون الذين يتحدثون بروتوكول MCP — مثل Claude وغيره — يتصلون بنقطة نهاية واحدة على خادمك أنت. لا تُرسَل أي بيانات إلى أي جهة أخرى، ولا يُنزَّل أي كود أثناء التشغيل.
لا شيء متاح ما لم تُتِحهأنت من يُدرج النماذج التي يصل إليها المساعد، نموذجًا نموذجًا. والقراءة والإنشاء والتعديل والحذف تُمنَح كلٌّ على حدة. والنموذج الذي لم تُدرجه لا يُرى ولا يُوصَف ولا يُمَس. |
يعمل باسم مستخدم حقيقيكل نداء يجري داخل بيئة مستخدم أودو نفسه، فتسري عليه حقوق الوصول وقواعد السجلات وفصل الشركات كما ضبطتها أنت من قبل، دون تغيير. ولا يستطيع الموصِّل توسيعها. |
كل نداء مُثبَتمن نادى، وبأي أداة، وعلى أي نموذج، والمعاملات، ومعرّفات السجلات التي مُسَّت، والمدة، والنتيجة — في سجل يرفض التعديل والحذف، حتى من مسارات الأتمتة. |
الأدوات الثماني
مساحة صغيرة عن قصد. وكل أداة تُرفَض ما لم تكن الصلاحية المقابلة ممنوحة على ذلك النموذج.
| الأداة | ما يستطيعه المساعد | الصلاحية |
|---|---|---|
odoo_list_models | يعرف النماذج التي يصل إليها وما المسموح به على كل منها. | دائمًا |
odoo_describe_model | يقرأ حقول النموذج: أنواعها وتسمياتها وقيمها وعلاقاتها. | قراءة |
odoo_search | يبحث بنطاق أودو ويقرأ الحقول. | قراءة |
odoo_aggregate | يجمِّع ويُحصي كما يفعل عرض المحور، بدل سحب آلاف السجلات. | قراءة |
odoo_create | يُنشئ سجلًا واحدًا. | إنشاء |
odoo_update | يكتب قيمًا على سجلات قائمة. | تعديل |
odoo_delete | يحذف نهائيًا — وبتأكيد صريح confirm فقط. | حذف |
odoo_call_method | يستدعي دالة عمل، كتأكيد أمر بيع. | الدوال التي تسميها |
action_confirm,action_post. وما لم يرد في
قائمتك يُرفَض، ويُسجَّل الرفض.
ربط المساعد
- ثبِّت التطبيق وافتح موصِّل MCP < النماذج المُتاحة. أضف النماذج التي تريد إتاحتها وحدِّد العمليات المسموح بها.
- وجِّه المساعد إلى
https://your-odoo/mcp. - وثِّق الاتصال بإحدى طريقتين:
- مفتاح أودو (API key) — لعميل يعمل عندك أو لسكربت. المفتاح يولّده أودو نفسه من تفضيلات المستخدم، ومنه يُلغى.
- OAuth 2.1 — للمساعد المُستضاف. يسجّل المساعد نفسه، ويرى المستخدم صفحة موافقة تحمل اسمه، وتصدر الموافقة رمزًا مرتبطًا بذلك المستخدم وحده. وPKCE إلزامي، والرموز تُستخدم مرة واحدة، ورموز التجديد تتبدّل.
- راقب موصِّل MCP < سجل النداءات. ورشِّح على غيَّرت البيانات لترى النداءات التي كتبت شيئًا فقط.
مبنيٌّ على طريقة أودو
- يعتمد على
baseوحدها — فيُثبَّت على أي قاعدة أودو 19، سواء وُجدت المبيعات والمحاسبة أم لم توجد. - مجموعة صلاحيات واحدة للمسؤول: هو من يقرر ما يُتاح ويقرأ السجل. وأي مستخدم أودو يستطيع الاتصال، فيصل إلى صلاحياته هو بالضبط، مضيَّقةً بالمصفوفة.
- مترجَم بالكامل إلى العربية، وواجهته مُختبَرة على قاعدة تعمل من اليمين إلى اليسار، لا بالإنجليزية وحدها.
- لا خدمة خارجية، ولا قياسات تُرسَل، ولا تنزيل كود أثناء التشغيل. الموصِّل لا يتحدث إلا مع أودو الخاص بك.
- ثلاثة كتب تُشحَن داخل التطبيق تحت موصِّل MCP < المساعدة: كتاب للمستخدم، وكتاب للمنفِّذ، وكتاب للمسؤول — ومعها شاشة عن التطبيق والدعم تحمل الإصدار المثبَّت وعنواننا، فلا يضطر أحد إلى مغادرة قاعدة البيانات ليعرف بمن يتصل.
مجاني، ومدعوم
السعر صفر ويبقى صفرًا. وهذا ما يشمله وما لا يشمله، بوضوح.
التطبيق كاملًالا خاصية محجوبة، ولا حدّ لعدد السجلات، ولا نسخة تجريبية تنتهي، ولا مفتاح ترخيص. ما تصفه هذه الصفحة هو ما يُثبَّت. |
الدعم مشمولراسلنا في خلل أو سؤال إعداد، فيردّ عليك إنسان، بالعربية أو بالإنجليزية. والأخطاء تُصلَح في التطبيق وتُنشَر للجميع؛ ولا نتقاضى أجرًا عن عيب. |
ما يُسعَّر على حدةخصائص جديدة، أو نماذجك أنت، أو تنفيذ، أو تدريب. تلك ارتباطات تُسعَّر وحدها، وليست شرطًا لعمل التطبيق أبدًا. |
الدعم مشمول. راسلنا على support@faceela.com بإصدار أودو لديك وما كنت تفعله، ويصلك رد من إنسان.
يقدّمه Faceela FZE LLC · faceela.com · الرخصة OPL-1
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 1936 |
| Technical Name |
faceela_mcp_server |
| License | OPL-1 |
| Website | https://faceela.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module