Claude يقرأ أودو مباشرة

هذه البوابة على سيرفرنا متصلة بأودو الشركة بمفتاح محفوظ على السيرفر فقط. تضيفها في Claude مرة واحدة كـموصل مخصص (Custom connector)، وبعدها تسأله عن القيود والفواتير والأرصدة وكشوف الحسابات بالعربي، ويجيب من بيانات أودو الحية.

1أضف البوابة في Claude

1. افتح claude.ai (أو تطبيق Claude) ← Settings ← Connectors.
2. اضغط Add custom connector. الاسم: «أودو 10 Events» — الرابط: الرابط اللي فوق. ثم Add.
3. اضغط Connect عند الموصل. تنفتح صفحة البوابة: ادخل باسم دخولك وكلمة مرورك في منصة العهد واضغط «دخول وموافقة».
4. في أي محادثة: زر + ← Connectors وتأكد أن «أودو 10 Events» مفعّل.

الإضافة مرة وحدة من المتصفح، وتشتغل بعدها تلقائياً في تطبيق Claude على الجوال والكمبيوتر. لو كان حساب Claude ضمن خطة Team/Enterprise، مالك الحساب يضيف الموصل أولاً من إعدادات المنظمة.

2جرّب هذه الأسئلة

Claude يحسب المجاميع من أودو نفسه (مو من عيّنة)، ويقدر يرتّبها لك جدول أو ملف Excel.

3تعلّم: إنشاء مفتاح API في أودو

مفتاح الـAPI يقوم مقام كلمة المرور للبرامج اللي تتصل بأودو (مثل هذه البوابة أو سكربت Python أو Excel). المفتاح يأخذ نفس صلاحيات المستخدم اللي أنشأه.

1. ادخل أودو ← اضغط صورتك أعلى الشاشة ← التفضيلات / My Preferences.
2. افتح تبويب أمان الحساب / Account Security.
3. اضغط مفتاح API جديد / New API Key وأكّد كلمة مرورك.
4. اكتب وصفاً واضحاً يبيّن وين بتستعمله (مثلاً: «Excel التقارير») واختر مدة الصلاحية، ثم Generate Key.
5. انسخ المفتاح فوراً واحفظه في مكان آمن — أودو يعرضه مرة واحدة فقط.

تحتاج 4 معلومات للاتصال: رابط أودو (مثل https://شركتك.odoo.com)، اسم قاعدة البيانات (يظهر في صفحة قواعد البيانات في حساب odoo.com أو اطلبه من المدير)، بريد الدخول، والمفتاح.

مثال Python (يقرأ آخر 5 فواتير عملاء مرحّلة):

import xmlrpc.client

URL  = "https://YOUR-COMPANY.odoo.com"
DB   = "YOUR-DATABASE-NAME"
USER = "you@company.sa"
KEY  = "PASTE-API-KEY"          # بدل كلمة المرور

common = xmlrpc.client.ServerProxy(f"{URL}/xmlrpc/2/common")
uid = common.authenticate(DB, USER, KEY, {})

models = xmlrpc.client.ServerProxy(f"{URL}/xmlrpc/2/object")
rows = models.execute_kw(DB, uid, KEY, "account.move", "search_read",
    [[["move_type", "=", "out_invoice"], ["state", "=", "posted"]]],
    {"fields": ["name", "partner_id", "invoice_date", "amount_total"],
     "order": "invoice_date desc", "limit": 5})
for r in rows:
    print(r["name"], r["partner_id"][1], r["amount_total"])

نفس الشيء بـ JSON-RPC (من أي لغة أو أداة مثل Postman):

POST https://YOUR-COMPANY.odoo.com/jsonrpc
{"jsonrpc": "2.0", "method": "call", "id": 1,
 "params": {"service": "object", "method": "execute_kw",
  "args": ["YOUR-DATABASE-NAME", UID, "PASTE-API-KEY",
           "account.move", "search_count",
           [[["move_type", "=", "in_invoice"], ["state", "=", "draft"]]]]}}

قواعد الأمان: لا تلصق المفتاح في محادثة أو واتساب أو ملف مشترك. مفتاح مستقل لكل استعمال حتى تقدر تلغيه لوحده. للإلغاء: نفس الشاشة ← أمان الحساب ← حذف المفتاح. ومع هذه البوابة ما تحتاج مفتاحاً خاصاً بك — المفتاح على السيرفر وما يطلع منه.

4كيف تحمي البوابة البيانات

• مفتاح أودو محفوظ على السيرفر فقط؛ Claude ولا المستخدم ما يشوفونه.
• البوابة تقرأ فقط: لا إنشاء ولا تعديل ولا حذف ولا ترحيل في أودو.
• إعدادات النظام والأسرار (كلمات المرور، المفاتيح، إعدادات البريد والدفع) محجوبة.
• الدخول بحساب منصة العهد؛ لو انوقف الحساب أو تغيّر دوره تنقطع البوابة عنه خلال دقائق.
• كل سؤال يسأله Claude مسجّل باسم صاحبه ووقته.