يوضح هذا الدليل طريقة ربط خادم Meftah MCP بمساعدات الذكاء الاصطناعي واستخدامه لإدارة العملاء والمنتجات والضرائب والفواتير. يشمل الدليل الاستخدام العام، ثم طريقة الاستخدام مع Claude و ChatGPT.

ما هو Meftah MCP؟

Meftah MCP هو خادم يعتمد على بروتوكول Model Context Protocol، ويتيح لمساعد الذكاء الاصطناعي تنفيذ أدوات Meftah نيابة عنك. بعد ربط حسابك في Meftah، يستطيع المساعد البحث في البيانات، إنشاء سجلات، تعديل الفواتير، وإرسال الفواتير من خلال Meftah.

نقاط الوصول الحالية هي:

• نقطة MCP: https://mcp.meftah.app/mcp
• بيانات OAuth لخادم التفويض: https://mcp.meftah.app/.well-known/oauth-authorization-server
• بيانات OAuth للمورد المحمي: https://mcp.meftah.app/.well-known/oauth-protected-resource

عند الربط، سيطلب منك Meftah MCP إدخال النطاق الفرعي لحسابك في Meftah، ثم يحولك إلى صفحة تسجيل الدخول في Meftah، وبعدها ينشئ جلسة MCP مؤقتة صالحة لمدة 30 يوما.

الأدوات المتاحة

قواعد مهمة

• اسم المستأجر هو أول جزء من رابط Meftah. إذا كان الرابط https://demo.meftah.app فإن اسم المستأجر هو demo.
• حالات الفاتورة هي 0 مسودة، و 1 معلقة، و 2 مدفوعة، و 3 متأخرة، و 4 ملغاة.
• شروط الدفع هي 0 مستحقة فورا، و 15 صافي 15، و 30 صافي 30، و 45 صافي 45، و 60 صافي 60، و 90 صافي 90.
• عنوان الفاتورة يتم تحديده من Meftah، لذلك لا تطلب من المساعد إرسال عنوان للفاتورة.
• إذا استخدم بند الفاتورة productName فسيبحث الخادم عن المنتج أولا. وإذا لم يجده، يمكنه إنشاء المنتج واستخدام معرفه.
• تعديل محتوى الفاتورة، مثل المبالغ والتواريخ والعملة والبنود، يتطلب أن تكون الفاتورة في حالة مسودة.
• الفواتير المدفوعة والملغاة حالات نهائية.
• الفواتير المرسلة إلى ZATCA تكون مقفلة. لعكسها أو تعديلها، استخدم إشعار دائن أو مدين بدلا من تعديل الفاتورة الأصلية.

الإعداد العام لأي عميل MCP

استخدم هذه الخطوات مع أي تطبيق يدعم MCP.

1. افتح إعدادات MCP في التطبيق.

2. أضف خادم MCP بعيد جديد.

3. استخدم هذا الرابط:

   https://mcp.meftah.app/mcp  
   

4. ابدأ عملية الربط أو التفويض.

5. أدخل النطاق الفرعي لحسابك في Meftah عند الطلب.

6. سجل الدخول إلى Meftah ووافق على الصلاحيات.

7. ارجع إلى المساعد وتأكد من ظهور أدوات Meftah.

بعد الربط، اختبر بطلب قراءة فقط:

اعرض أحدث فواتيري في Meftah.  

أو:

ابحث في عملاء Meftah عن "Acme".  

استخدام Meftah MCP مع Claude

يدعم Claude خوادم MCP البعيدة في العملاء والخطط التي توفر هذه الميزة.

الربط في Claude

1. افتح Claude.

2. انتقل إلى إعدادات الموصلات أو التكاملات أو خوادم MCP.

3. أضف خادم MCP مخصصا.

4. أدخل:

   https://mcp.meftah.app/mcp  
   

5. أكمل عملية التفويض.

6. عندما تظهر صفحة ربط Meftah، أدخل النطاق الفرعي.

7. سجل الدخول إلى Meftah ووافق على الوصول.

8. ارجع إلى Claude وتأكد من تفعيل أدوات Meftah.

أمثلة أوامر في Claude

البحث قبل الإنشاء:

استخدم Meftah للبحث عن عميل باسم Gulf Trading.  
إذا لم يكن العميل موجودا، أنشئه باسم جهة اتصال Ahmed Saleh،  
وبريد [email protected]، ورقم +966500000000.  

إنشاء منتج:

أنشئ منتجا في Meftah باسم Consulting Hour بسعر وحدة 350 ريال سعودي.  
استخدم Hour كوحدة قياس.  

إنشاء فاتورة:

أنشئ فاتورة مسودة في Meftah للعميل رقم 123.  
العملة ريال سعودي. تاريخ الفاتورة 2026-05-30 وتاريخ الاستحقاق 2026-06-14.  
أضف بندا واحدا باسم Consulting Hour، الكمية 3، سعر الوحدة 350.  
الإجمالي قبل الضريبة 1050، الضريبة 157.5، والإجمالي النهائي 1207.5.  

تحديث حالة فاتورة:

غيّر حالة الفاتورة 00000000-0000-0000-0000-000000000000 في Meftah إلى مدفوعة.  

إرسال فاتورة:

أرسل الفاتورة 00000000-0000-0000-0000-000000000000 إلى العميل بالبريد الإلكتروني.  

الإرسال إلى ZATCA:

أرسل الفاتورة 00000000-0000-0000-0000-000000000000 إلى ZATCA.  
قبل الإرسال، أكد معي حالة الفاتورة والمبلغ الإجمالي.  

استخدام Meftah MCP مع ChatGPT

يعتمد دعم ChatGPT على الخطة، وإعدادات مساحة العمل، وتفعيل ChatGPT apps أو custom MCP apps أو developer mode. تستخدم وثائق OpenAI الحالية مصطلح "apps" بدلا من "connectors" في كثير من المواضع. توضح OpenAI أن التطبيقات المخصصة يمكن أن تستخدم MCP، وأن مسؤولي مساحة العمل يستطيعون التحكم في إتاحة التطبيقات والإجراءات، وأن إجراءات الكتابة أو التعديل قد تحتاج إلى مراجعة أو تأكيد إضافي.

مراجع OpenAI مفيدة:

• نظرة عامة على ChatGPT apps: https://help.openai.com/en/articles/11487775-connectors-in-chatgpt
• Developer mode و full MCP apps: https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta
• بناء خوادم MCP لتطبيقات ChatGPT وتكاملات API: https://developers.openai.com/api/docs/mcp

الإعداد كموصل MCP مباشر

استخدم هذه الطريقة عندما يظهر في ChatGPT خيار إضافة custom app أو connector أو MCP app أو خادم MCP بعيد.

1. افتح إعدادات ChatGPT أو إعدادات التطبيقات والموصلات في مساحة العمل.

2. أضف أو استورد custom app أو custom connector أو خادم MCP.

3. أدخل:

   https://mcp.meftah.app/mcp  
   

4. أكمل عملية OAuth.

5. أدخل النطاق الفرعي لحسابك في Meftah.

6. سجل الدخول إلى Meftah ووافق على الوصول.

7. إذا كنت تستخدم مساحة عمل Business أو Enterprise أو Edu، اطلب من المسؤول تفعيل التطبيق أو نشره عند الحاجة.

8. ابدأ محادثة واختر أو اذكر تطبيق Meftah عند طلب استخدامه من ChatGPT.

بديل Custom GPT Actions

استخدم هذه الطريقة إذا كانت واجهة ChatGPT لديك تدعم Custom GPT Actions ولا تدعم MCP البعيد مباشرة.

1. أنشئ API وسيطا صغيرا يعرّف عمليات Meftah المطلوبة كنقاط REST.
2. في منشئ Custom GPT، أضف هذه النقاط كـ Actions باستخدام OpenAPI schema.
3. اضبط OAuth أو bearer token للتفويض.
4. في تعليمات GPT، وضح متى يجب استخدام كل عملية من عمليات Meftah.

نص تعليمات مقترح:

استخدم أدوات Meftah لعمليات العملاء والمنتجات والضرائب والفواتير.  
قبل إنشاء أو تعديل أي سجل مالي، لخص الإجراء المطلوب واطلب التأكيد.  
استخدم أدوات القراءة فقط أولا عندما يطلب المستخدم البحث أو التحقق أو العرض.  
لا ترسل أي فاتورة إلى ZATCA بدون تأكيد صريح.  

أمثلة أوامر في ChatGPT

ابحث عن عملاء Meftah المطابقين لعبارة "Future Systems" واعرض معرفاتهم.  

أنشئ عميلا جديدا في Meftah:  
الشركة: Future Systems LLC  
جهة الاتصال: Sara Khan  
البريد: [email protected]  
الهاتف: +966511111111  
نوع العميل: B2B  

أنشئ فاتورة بالريال السعودي في Meftah للعميل رقم 456.  
التاريخ: 2026-05-30  
تاريخ الاستحقاق: 2026-06-29  
شروط الدفع: صافي 30  
البند: Monthly support، الكمية 1، سعر الوحدة 2000  
الضريبة: 300  
الإجمالي: 2300  
اجعلها مسودة.  

اعرض فواتيري في Meftah وحدد الفواتير التي ما زالت مسودة أو معلقة.  

ممارسات أمان موصى بها

• ابدأ بعمليات البحث والعرض قبل إنشاء أو تعديل السجلات.
• اطلب من المساعد عرض معرف العميل، معرف المنتج، معرف الفاتورة، الإجماليات، الضريبة، وتاريخ الاستحقاق قبل إنشاء الفاتورة.
• اطلب تأكيدا صريحا قبل إرسال الفواتير بالبريد الإلكتروني.
• اطلب تأكيدا صريحا قبل إرسال أي فاتورة إلى ZATCA.
• تأكد من اتساق المبالغ: subtotalAmount + taxAmount - discountAmount = totalAmount.
• استخدم حالة المسودة أثناء مراجعة محتوى الفاتورة.

حل المشكلات