راجع وكلاء الذكاء الاصطناعي و MCP لطريقة الاتصال وكيف تعمل الموافقة.
ما يقدمه لك MCP
بروتوكول سياق النماذج (MCP) معيار مفتوح لربط تطبيقات الذكاء الاصطناعي بالأدوات والبيانات. ومع خادم MCP يستطيع أي مساعد أو إطار وكلاء متوافق العمل مع وندرفاتورة دون شيفرة ربط خاصة.
الأدوات
| المجموعة | الأدوات |
|---|---|
| المنشأة | get_company_profile، get_integration_status |
| العملاء | search_customers، get_customer، create_customer، update_customer |
| المنتجات والخدمات | search_products، get_product، create_product، update_product |
| الفواتير والإشعارات | list_invoices، get_invoice، get_invoice_status، list_invoice_notes، get_note، create_invoice_draft، validate_invoice_draft، create_note_draft |
| الدفعات | record_payment، list_invoice_payments |
| المشاريع | list_projects، get_project_summary، set_invoice_project |
| المستندات | get_document_download_link: رابط PDF صالح لخمس دقائق |
| لا رجعة فيها (معطلة افتراضيًا) | issue_invoice، issue_note، create_credit_note، create_debit_note: كل استدعاء يحتاج موافقة شخص داخل وندرفاتورة |
كيف تعمل الموافقة
- يطلب الوكيل الإصدار، فتتحقق وندرفاتورة من المسودة وتسجل موافقة معلقة مرتبطة بتلك المنشأة والربط والشخص والمستند بعينه.
- يتلقى الوكيل رابطًا ويعرضه على الشخص.
- يسجل الشخص دخوله ويؤكد كلمة مروره، ويرى المستند كما هو محفوظ في وندرفاتورة، فيوافق أو يرفض.
- عندها فقط تصدره محاولة الوكيل التالية، مرة واحدة، وبشرط ألا تكون المسودة قد تغيرت منذ الموافقة.
الاتصال والأمان
- خادم بعيد عبر Streamable HTTP على
https://fatoora.tw.sa/mcp، يتحدث MCP بإصدارات2026-07-28و2025-11-25و2025-06-18دون جلسات. - OAuth 2.1 مع PKCE: تختار المنشأة الصلاحيات التي تمنحها، ويمكنها إلغاؤها.
- الرموز مقيدة بخادم MCP ولا تُمرر إلى أي جهة أخرى.
- نتائج منشأة الاختبار موسومة بذلك دائمًا.
جاهز للبدء؟
الوصول إلى الواجهة البرمجية ضمن باقات: الأعمال والمؤسسات. أنشئ مفتاحًا من الإعدادات ← مفاتيح API وأرسل أول طلب خلال دقائق.