جنتال لأودو: خادم MCP آمن داخل أودو حقك

ثبّت الموديول في أودو، واختار وش ينفتح للوكيل، واربطه. وكيلك يرد على العميل بأسعار ومخزون وفواتير من أودو نفسه، ويسجل العميل المحتمل والملاحظة، وكل طلب يمر على صلاحيات أودو اللي عندك.

نُشر

باختصار

جنتال لأودو موديول مجاني (LGPL-3) تثبته في أودو ١٧ إلى ٢٠، Community أو Enterprise، على سيرفرك أو Odoo.sh. يحول أودو لخادم MCP على رابط https واحد، وأي عميل MCP يتصل فيه: وكيل جنتال، أو Claude، أو ChatGPT. الوكيل يشتغل كمستخدم أودو تختاره، ويشوف بس اللي فتحته له. أودو أونلاين ما يدعم الموديولات الخاصة. حمّله من متجر أودو.

كيف يتصل الوكيل بأودو؟

الموديول يشتغل داخل أودو نفسه، بدون سيرفر وسيط وبدون باكجات بايثون إضافية. بياناتك تبقى في أودو.

  1. أودو حقك

    العملاء والمبيعات والفواتير والـ CRM والمخزون ونقاط البيع، وتطبيقاتك الخاصة، مع صلاحيات المستخدمين وقواعد السجلات اللي ضبطتها.

  2. موديول MCP Server for AI Agents

    رابط واحد مثل ⁦https://odoo.example.com/mcp⁩. يتحقق من الدخول (OAuth أو مفتاح API)، ويمرر الطلب على ثلاثة حواجز، ويسجل كل طلب في صندوق الوارد.

  3. أي عميل 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، والمشاكل الشائعة) في دليل ربط أودو.

  1. ثبّت الموديول

    من متجر تطبيقات أودو، حدّث قائمة التطبيقات، وثبّت «⁦MCP Server for AI Agents⁩».

  2. حط رابط https العام

    من ⁦Gental MCP › Configuration › General⁩، وشغّل فحص الوصول عشان تتأكد إن العملاء يوصلون له.

  3. اختار وش ينفتح

    فعّل المجالات الجاهزة اللي تبيها، وأضف الموديلات والعمليات والحقول المخفية.

  4. سوّ مستخدم «⁦Gental Agent⁩»

    مستخدم داخلي بالمجموعات اللي يحتاجها بس، وضيفه لمجموعة «⁦Gental MCP: Connect⁩».

  5. اربط عميل MCP

    في جنتال: خادم MCP مخصص، والصق رابط أودو مع ⁦/mcp⁩ في آخره، وادخل بمستخدم Gental Agent ووافق. ونفس الشي في Claude أو ChatGPT.

وين يشتغل الموديول؟

البيئةالحالة
أودو ١٧ و١٨ و١٩ و٢٠مدعوم
Community وEnterpriseمدعوم
على سيرفرك أو Odoo.shمدعوم
أودو أونلاين (SaaS)غير مدعوم: ما يسمح بتثبيت موديولات خاصة
أودو على شبكة داخلية بسيحتاج رابط https عام عبر بروكسي

الموديول يستخدم ORM أودو مباشرة، وما يعتمد على واجهات XML-RPC وJSON-RPC اللي أودو أعلن إيقافها.

أسئلة تتكرر علينا

هل لازم أستخدم جنتال عشان أستفيد من الموديول؟

لا. أي عميل MCP يتصل فيه، مثل Claude وChatGPT وCursor أو سكربتاتك. جنتال يضيف هوية العميل الموثّقة، والتأكيد قبل أي تغيير، والرد على واتساب وموقعك.

هل يشتغل على أودو أونلاين؟

لا. أودو أونلاين ما يسمح بتثبيت موديولات خاصة. الموديول يشتغل على أودو اللي على سيرفرك أو على Odoo.sh.

أودو حقي على شبكة داخلية، أقدر أربطه؟

تحتاج رابط https عام يوصل لأودو، مثل بروكسي عكسي. جنتال والعملاء السحابية ما يتصلون إلا بعناوين https عامة، وفحص الوصول في الإعدادات يوضح لك النتيجة.

وين تروح بياناتي؟

البيانات تبقى في أودو حقك. العميل يشوف بس نتائج الأدوات اللي فتحتها، وبصلاحيات المستخدم اللي يتصل باسمه، وكل طلب يتسجل في صندوق الوارد.

كم سعر الموديول؟

مجاني ومفتوح المصدر برخصة LGPL-3. وإذا ربطته بوكيل جنتال، تدفع اشتراك جنتال حسب الأسعار.

هل الموديول بالعربي؟

إيه، واجهة الموديول بالعربي والإنجليزي، ونتائج الأدوات تطلع بلغة الطلب.

ابدأ اليوم، وخلّ وكيلك يرد عنك من الليلة.

أضف معلوماتك، واخترله شخصية، وانشره على موقعك. البداية مجانية.

  • بدون بطاقة
  • بدون برمجة
  • بياناتك في السعودية