جسر Odoo ↔ Claude (MCP Server)

خادم بسيط يوصل حساب Odoo عندك بـ Claude، بحيث يقدر يقرأ كشوفات حسابات الموردين ويجهز فواتير/دفعات بحالة Draft فقط — أي شي يسويه هذا الخادم ما يتأكد أو يُنشر أو تتحرك بيه فلوس فعليًا. لازم إنسان يفتح السجل داخل Odoo ويأكده بنفسه.

الملفات

• server.py — الخادم نفسه (MCP tools)

• odoo_client.py — الاتصال بـ Odoo عبر XML-RPC

• requirements.txt — المكتبات المطلوبة

• render.yaml — إعداد جاهز للنشر على Render

• .env.example — مثال للمتغيرات المطلوبة (لا تضع فيه أسرار حقيقية)

Related MCP server: Odoo MCP Server

خطوات النشر على Render

1. ادفع هذا المجلد لمستودع GitHub (repo) خاص بك.

2. من Render Dashboard: New > Web Service واختر الـ repo.

3. Render بيقرأ render.yaml تلقائيًا (Blueprint) أو تعبي الحقول يدويًا:

   • Build Command: pip install -r requirements.txt

   • Start Command: python server.py

4. تحت Environment، أضف هذي المتغيرات (القيم الحقيقية، ما تنسخها بالكود):

   • ODOO_URL = https://centrixplus-caf.odoo.com

   • ODOO_DB = centrixplus-caf

   • ODOO_USERNAME = بريدك (a.algahtani@cafcafe.com)

   • ODOO_API_KEY = المفتاح اللي أخذته من Odoo (Account Security > API Keys)

   • MCP_SHARED_SECRET = كلمة سر تخترعها أنت (طويلة وعشوائية) — تحمي الخادم من أي شخص يعرف رابط Render

5. اضغط Create Web Service. بعد النشر، Render بيعطيك رابط مثل: https://odoo-mcp-bridge.onrender.com

6. تأكد الخادم شغال: افتح https://odoo-mcp-bridge.onrender.com/healthz — يفترض يرجع ok.

ربطه بـ Claude

1. Settings > Connectors > Add custom connector

2. Server URL: https://odoo-mcp-bridge.onrender.com/mcp

3. Advanced settings > Headers: أضف هيدر

   • Name: X-API-Key

   • Value: نفس قيمة MCP_SHARED_SECRET اللي وضعتها بـ Render

4. Add، وبعدها فعّله بالمحادثة من زر "+" > Connectors.

5. أي أداة كتابة (create_draft_vendor_bill / create_draft_vendor_payment) تبقى على "Ask each time" — لا تحولها لـ "Always allow".

ملاحظة أمان مهمة

• لا تشارك ODOO_API_KEY أو MCP_SHARED_SECRET بأي محادثة أو شات — تدخل فقط في إعدادات Render مباشرة.

• كل الأدوات اللي "تكتب" بالنظام تستخدم create() فقط — لا تستدعي أي دالة تأكيد/نشر/دفع. راجع server.py وodoo_client.py للتأكد بنفسك.