جنتال لأودو: خادم MCP آمن داخل أودو حقك
ثبّت الموديول في أودو، واختار وش ينفتح للوكيل، واربطه. وكيلك يرد على العميل بأسعار ومخزون وفواتير من أودو نفسه، ويسجل العميل المحتمل والملاحظة، وكل طلب يمر على صلاحيات أودو اللي عندك.
نُشر
باختصار
جنتال لأودو موديول مجاني (LGPL-3) تثبته في أودو ١٧ إلى ٢٠، Community أو Enterprise، على سيرفرك أو Odoo.sh. يحول أودو لخادم MCP على رابط https واحد، وأي عميل MCP يتصل فيه: وكيل جنتال، أو Claude، أو ChatGPT. الوكيل يشتغل كمستخدم أودو تختاره، ويشوف بس اللي فتحته له. أودو أونلاين ما يدعم الموديولات الخاصة. حمّله من متجر أودو.
كيف يتصل الوكيل بأودو؟
الموديول يشتغل داخل أودو نفسه، بدون سيرفر وسيط وبدون باكجات بايثون إضافية. بياناتك تبقى في أودو.
أودو حقك
العملاء والمبيعات والفواتير والـ CRM والمخزون ونقاط البيع، وتطبيقاتك الخاصة، مع صلاحيات المستخدمين وقواعد السجلات اللي ضبطتها.
موديول MCP Server for AI Agents
رابط واحد مثل https://odoo.example.com/mcp. يتحقق من الدخول (OAuth أو مفتاح API)، ويمرر الطلب على ثلاثة حواجز، ويسجل كل طلب في صندوق الوارد.
أي عميل MCP
تتصل من جنتال بخادم MCP مخصص، أو من Claude وChatGPT كموصل مخصص، أو من سكربتاتك بمفتاح API.
- جنتال
- Claude
- ChatGPT
- Cursor
- سكربتاتك
ثلاثة حواجز لازم يعديها كل طلب
لو حاجز واحد رفض، الطلب ينرفض ويتسجل كـ «مرفوض» وما يرجع أي بيانات.
اللي فتحته في الموديول
السيرفر شغال، والمجال مفعّل أو الموديل والعملية مسموحة، والحقل مو مخفي. الحقول الثنائية وكلمات المرور والتوكنات ما تطلع أبد.
مين مسموح له يتصل
بس أعضاء مجموعة «Gental MCP: Connect» (أو المجموعات اللي تحددها). والموديول ينصحك بمستخدم مخصص اسمه «Gental Agent».
صلاحيات أودو نفسها
كل طلب يشتغل باسم مستخدم أودو، فصلاحياته وقواعد السجلات حقته هي الحد. ما فيه sudo على بيانات العمل.
دخول وتوكنات
OAuth 2.1 مع PKCE بدخول أودو العادي (والتحقق الثنائي حقه)، ومفاتيح API تنعرض مرة وحدة. كل التوكنات محفوظة مشفرة بالـ hash، وتنلغي على طول.
وش يقدر الوكيل يسوي في كل تطبيق؟
الأدوات الجاهزة تطلع بس لما يكون تطبيقها مثبت ومجاله مفعّل، وتقدر تطفي أي أداة لحالها.
| التطبيق | الأدوات | نوعها |
|---|---|---|
| جهات الاتصال | البحث عن جهة اتصال، وإضافتها أو تحديثها بدون تكرار | قراءة وكتابة |
| المبيعات | البحث في المنتجات بأسعار قائمة الأسعار، ومعاينة عرض السعر، وإنشاؤه وتأكيده أو إلغاؤه، وحالة الطلب وملفه PDF | قراءة وكتابة وإلغاء |
| الفوترة | قائمة الفواتير وتفاصيلها، ورصيد العميل، وملف الفاتورة PDF، وإرسالها بالإيميل | قراءة وكتابة |
| CRM | إنشاء عميل محتمل وتحديثه، وملاحظة على السجل، وجدولة نشاط، وملخص المراحل | قراءة وكتابة |
| المخزون | التوفر لكل مستودع مع المتوقع، وحالة التوصيل، وإيصال التسليم PDF | قراءة |
| نقاط البيع | ملخص مبيعات المحل، والبحث برقم الإيصال | قراءة |
وفيه أدوات «طلباتي» و«فواتيري» و«رصيدي» و«شحناتي» تشتغل بس للعميل اللي يكلم الوكيل، بهوية موقّعة من جنتال.
تطبيقاتك الخاصة، والملفات، والأحداث
أي موديل، عملية بعملية
تفتح أي موديل حتى الخاص فيك: قراءة أو إنشاء أو تعديل أو حذف، مع حقول مخفية ونطاق إضافي مثل شركة وحدة بس.
دوال تختارها بنفسك
تسمح بدوال عامة معينة في موديلاتك، وتحدد لكل وحدة إذا هي قراءة أو كتابة أو حذف. الدوال الداخلية ممنوعة دايمًا.
ملفات PDF برابط ينتهي
الفاتورة وعرض السعر وإيصال التسليم من تقارير أودو نفسها، برابط موقّع ينتهي بعد ٢٤ ساعة (تقدر تغيرها).
Webhooks موقّعة
تشترك بأحداث مثل فاتورة انترحلت أو انسددت، وطلب تأكد، وعميل محتمل تغيرت مرحلته. كل إرسال موقّع بـ HMAC-SHA256 وينعاد لين ثماني محاولات.
لوحة وسجلات بالعربي
لوحة فيها العملاء المتصلين والطلبات والأخطاء واللي يحتاج انتباهك، وصندوق وارد لكل طلب، وصندوق صادر للـ webhooks والملفات.
وش يضيف جنتال فوق أي عميل MCP؟
الموديول يشتغل مع أي عميل MCP. ومع وكيل جنتال على واتساب أو موقعك تاخذ زيادة:
هوية العميل الموثّقة
جنتال يرسل رقم العميل موقّع، والموديول يطابقه مع جهة الاتصال في أودو. لو ما تطابق أو طلع أكثر من واحد، ما يخمن.
تأكيد قبل أي تغيير
الوكيل يعرض الملخص ويسأل العميل قبل ما ينشئ أو يغير شي، والأسعار تجي من أودو بعرض موقّع مو من كلام الوكيل.
بدون تكرار
كل إجراء مؤكد له مفتاح خاص، فلو انقطع الرد وانعاد الطلب، يرجع نفس عرض السعر بدل ما ينشئ ثاني.
واتساب وموقعك
نفس الوكيل يرد على واتساب وواجهة الموقع وقناة API، وروابط ملفات PDF توصل العميل داخل المحادثة.
التركيب في خمس خطوات
التفاصيل كاملة (البروكسي، والمستخدم، والـ webhooks، والمشاكل الشائعة) في دليل ربط أودو.
ثبّت الموديول
من متجر تطبيقات أودو، حدّث قائمة التطبيقات، وثبّت «MCP Server for AI Agents».
حط رابط https العام
من Gental MCP › Configuration › General، وشغّل فحص الوصول عشان تتأكد إن العملاء يوصلون له.
اختار وش ينفتح
فعّل المجالات الجاهزة اللي تبيها، وأضف الموديلات والعمليات والحقول المخفية.
سوّ مستخدم «Gental Agent»
مستخدم داخلي بالمجموعات اللي يحتاجها بس، وضيفه لمجموعة «Gental MCP: Connect».
اربط عميل MCP
في جنتال: خادم MCP مخصص، والصق رابط أودو مع /mcp في آخره، وادخل بمستخدم Gental Agent ووافق. ونفس الشي في Claude أو ChatGPT.
وين يشتغل الموديول؟
| البيئة | الحالة |
|---|---|
| أودو ١٧ و١٨ و١٩ و٢٠ | مدعوم |
| Community وEnterprise | مدعوم |
| على سيرفرك أو Odoo.sh | مدعوم |
| أودو أونلاين (SaaS) | غير مدعوم: ما يسمح بتثبيت موديولات خاصة |
| أودو على شبكة داخلية بس | يحتاج رابط https عام عبر بروكسي |
الموديول يستخدم ORM أودو مباشرة، وما يعتمد على واجهات XML-RPC وJSON-RPC اللي أودو أعلن إيقافها.
المصادر
- صفحة الموديول في متجر تطبيقات أودوبتاريخ نوفمبر ٢٠٢٦
- توثيق أودو: واجهة External RPC وإيقافهابتاريخ نوفمبر ٢٠٢٦
أسئلة تتكرر علينا
هل لازم أستخدم جنتال عشان أستفيد من الموديول؟
لا. أي عميل MCP يتصل فيه، مثل Claude وChatGPT وCursor أو سكربتاتك. جنتال يضيف هوية العميل الموثّقة، والتأكيد قبل أي تغيير، والرد على واتساب وموقعك.
هل يشتغل على أودو أونلاين؟
لا. أودو أونلاين ما يسمح بتثبيت موديولات خاصة. الموديول يشتغل على أودو اللي على سيرفرك أو على Odoo.sh.
أودو حقي على شبكة داخلية، أقدر أربطه؟
تحتاج رابط https عام يوصل لأودو، مثل بروكسي عكسي. جنتال والعملاء السحابية ما يتصلون إلا بعناوين https عامة، وفحص الوصول في الإعدادات يوضح لك النتيجة.
وين تروح بياناتي؟
البيانات تبقى في أودو حقك. العميل يشوف بس نتائج الأدوات اللي فتحتها، وبصلاحيات المستخدم اللي يتصل باسمه، وكل طلب يتسجل في صندوق الوارد.
كم سعر الموديول؟
مجاني ومفتوح المصدر برخصة LGPL-3. وإذا ربطته بوكيل جنتال، تدفع اشتراك جنتال حسب الأسعار.
هل الموديول بالعربي؟
إيه، واجهة الموديول بالعربي والإنجليزي، ونتائج الأدوات تطلع بلغة الطلب.
اقرأ كمان
- دليل ربط أودو بـ MCPتركيب موديول MCP لأودو وربطه بجنتال وClaude وChatGPT وسكربتاتك، بأمان.
- شات بوت واتسابشات بوت واتساب بالذكاء الاصطناعي يجاوب من معرفتك ويحول لفريقك لما يحتاج.
- للمطورين (API)اربط وكيلك بتطبيقك ونظامك عبر REST وبث مباشر وWebhooks موقعة.
- التكاملاتمصادر المعرفة والتطبيقات والقنوات اللي يرتبط بها وكيلك اليوم، واللي جاية.
ابدأ اليوم، وخلّ وكيلك يرد عنك من الليلة.
أضف معلوماتك، واخترله شخصية، وانشره على موقعك. البداية مجانية.
- بدون بطاقة
- بدون برمجة
- بياناتك في السعودية