ربط عليا بوكس بـ Claude أو ChatGPT
دع مساعداً ذكياً يعمل على فواتيرك عبر تسجيل الدخول: اختر المنشأة، والاختبار أو التشغيل الفعلي، وما يُسمح له به، وألغِ الربط متى شئت.
يستطيع Claude وChatGPT وغيرهما من المساعدين استخدام عليا بوكس كموصل: تطلب بكلماتك ("اعرض الفواتير غير المدفوعة لشهر سبتمبر"، "افحص رسالة CargoWise هذه وأخبرني بما يفشل") فيُنفّذ المساعد ذلك عبر خادم MCP في عليا بوكس، بالفحوص نفسها التي يجريها التطبيق.
تحتاج إلى صلاحية إدارة مفاتيح API في المنشأة (يملكها المالكون والمديرون).
أضف الموصل
- في Claude: الإعدادات ← الموصلات ← إضافة موصل مخصص. في ChatGPT: الإعدادات ← الموصلات (وضع المطورين) ← إنشاء.
- أدخل عنوان MCP الظاهر في صفحة API access (الوصول عبر API) في عليا بوكس (ينتهي بـ
/mcp). - يفتح المساعد صفحة تسجيل الدخول في عليا بوكس. سجّل الدخول كالمعتاد، مع العامل الثاني إن كنت تستخدمه.
وافق على الربط
تعرض عليا بوكس التطبيق الذي يطلب الربط والعنوان الذي سيعيدك إليه. تأكد أنه التطبيق الذي أضفته للتو. ثم اختر:
| المنشأة | التي يعمل فيها المساعد. تظهر فقط المنشآت التي يحق لك فيها إدارة مفاتيح API. |
| البيئة | اختبار ينشئ مستندات اختبار فقط ولا يصل شيء إلى الهيئة الاتحادية للضرائب. تشغيل فعلي يعمل على فواتير حقيقية: الإرسال يبلّغ الهيئة بها ولا يمكن التراجع عنه. ابدأ بالاختبار. |
| الصلاحيات | ما يُسمح للمساعد بفعله، من قراءة الفواتير إلى تغيير الإعدادات. استبعد ما لا يحتاجه. |
انقر سماح للعودة إلى المساعد وقد تم الربط؛ ورفض يلغي الطلب.
ما يستطيع المساعد فعله
يفعل ما تسمح به الصلاحيات التي اخترتها فقط: قراءة الفواتير وإنشاؤها، والتحقق منها وإرسالها، وتنزيلها بصيغة PDF أو PINT AE XML، والعمل على فواتير الموردين والعملاء والمنتجات، وفحص رسائل ERP وإرسالها، وقراءة التقارير. لا يستطيع إدارة مفاتيح API أو أعضاء الفريق أو اتصال الفوترة الإلكترونية أو ملف الشركة، ولا اعتماد خريطة رسوم ERP.
عندما تطلب ملف PDF لفاتورة، يحصل المساعد من عليا بوكس على رابط تنزيل صالح لمدة 15 دقيقة. ويستطيع أي شخص لديه الرابط فتح الملف حتى ذلك الحين، فلا تشاركه إلا مع من يحق له الاطلاع على الفاتورة.
الإجراءات التي لا يمكن التراجع عنها (الإرسال إلى الهيئة، والإرسال إلى المشتري، وإعادة فتح إقرار ضريبي) مُعلَّمة ليسألك المساعد قبل تنفيذها. ومع ربط تشغيل فعلي تبقى مسؤولاً عما يرسله.
عرض الروابط وإلغاؤها
يعرض API access ← API keys ← Connected apps (الوصول عبر API ← مفاتيح API ← التطبيقات المرتبطة) كل مساعد مرتبط بالمنشأة: التطبيق، والاختبار أو التشغيل الفعلي، وصلاحياته، ومتى رُبط وآخر استخدام. إلغاء يوقفه فوراً؛ ويجب ربطه من جديد ليتابع. وينتهي الربط تلقائياً إذا لم يُستخدم 60 يوماً.
حل المشكلات
- "لا يمكن استخدام طلب الربط هذا": تغيّر الطلب أو تسجيل التطبيق غير معروف. أزل الموصل من المساعد وأضفه من جديد.
- لا توجد منشأة للاختيار: ليست لديك صلاحية إدارة مفاتيح API. اطلب من مالك أو مدير.
- يقول المساعد إن الوصول أُلغي أو انتهى: أعد ربطه من إعدادات الموصل في المساعد.