ما يفعله الوصل
بروتوكول سياق النموذج (MCP) هو معيار مفتوح يستخدم من خلاله مساعد الذكاء الاصطناعي أدوات نظام آخر. يوفر PaperOffice خادم MCP عن بُعد لذلك. بمجرد الاتصال، يمكن لمساعد مثل Claude العمل مع المستندات في مساحات عملك على PaperOffice: البحث، القراءة، التلخيص، استخراج البيانات، الرفع، إعادة التسمية، النقل، طلب التواقيع وبدء سير العمل، دائماً وفقاً لصلاحياتك على PaperOffice.
لا يوجد شيء لتثبيته. يتصل المساعد بعنوان URL، وتسجل الدخول بحسابك على PaperOffice، وتظهر أدوات PaperOffice داخل الدردشة.
المساعدون المدعومون وروابط الوصل
- Claude (claude.ai، Claude Desktop، Claude Code):
https://mcp.paperoffice.ai/claude، تسجيل الدخول عبر OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt، تسجيل الدخول عبر OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok، تسجيل الدخول عبر OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor، باستخدام رمز مستخدم شخصي أو رمز مجموعة.
تشير الملفات الشخصية إلى نفس الخادم وتختلف فقط في نطاق الأدوات.
ما تحتاجه
- حساب على PaperOffice يحتوي على مساحة عمل واحدة على الأقل.
- Credits على الحساب. يتم فوترة استدعاءات الأدوات مثل استدعاءات API.
- خطة مساعد تسمح بالوصلات، على سبيل المثال Claude Pro، Max، Team أو Enterprise. في خطط Team و Enterprise، قد يحتاج المسؤول إلى تمكين الوصل أولاً.
ربط Claude
- في claude.ai، افتح الإعدادات → Connectors.
- اختر إضافة وصل مخصص، وأدخل الاسم PaperOffice والعنوان
https://mcp.paperoffice.ai/claude. اترك معرف العميل والسري فارغين؛ سيبدأ تسجيل الدخول OAuth تلقائياً. - اختر اتصال وسجل الدخول بحسابك على PaperOffice. راجع الوصول المطلوب وأكد عليه.
- في الدردشة، فعّل أدوات PaperOffice للمحادثة.
يستخدم Claude Desktop نفس قائمة الوصلات مثل claude.ai. في Claude Code، أضف الخادم باستخدام claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude وأكمل تسجيل الدخول عبر /mcp.
اختبار أولي: اسأل "أي مساحات عمل PaperOffice يمكنني الوصول إليها؟" يجب أن يسرد لك Claude مساحات عملك.
ربط ChatGPT و Grok
ChatGPT: افتح الإعدادات → Connectors، وأضف موصلًا مخصصًا باسم PaperOffice، وعنوان URL https://mcp.paperoffice.ai/chatgpt، ومصادقة OAuth كطريقة للمصادقة، ثم قم بالاتصال وتسجيل الدخول. اعتمادًا على خطتك، قد يلزم تمكين وضع المطور للموصلات المخصصة. يعد ملف تعريف ChatGPT مجموعة منتقاة بعناية من الأدوات؛ فهو لا يحتوي، على سبيل المثال، على أدوات التوقيع أو سير العمل.
Grok: افتح grok.com/connectors، وأنشئ موصلًا مخصصًا بعنوان URL https://mcp.paperoffice.ai/grok، وسجّل الدخول بحساب PaperOffice الخاص بك عند أول اتصال. يُعد ملف تعريف Grok أيضًا مجموعة منتقاة بعناية من الأدوات.
ربط Cursor برمز
- سجل الدخول إلى تطبيق PaperOffice وافتح حساب → API.
- أنشئ رمز مستخدم أو استخدم رمز مجموعة من مسؤولك. يمكنك عرض رمز النفاذ ونسخه في أي وقت من صفحة واجهة برمجة التطبيقات (API)؛ احفظه بأمان.
- أضف الخادم إلى ملف mcp.json الخاص بـ Cursor بالعنوان
https://mcp.paperoffice.ai/cursorوالرمز كرمز حامل (bearer token) في رأس المصادقة. - أعد تشغيل Cursor أو قم بتحديث خوادم MCP.
لا تقم أبداً بملف mcp.json مع رمز حقيقي إلى مستودع. المفاتيح السرية والمفاتيح القابلة للنشر لـ REST API محظورة لـ MCP.
الصلاحيات: المساعد لا يحصل على أكثر مما لديك
يعمل المساعد بصلاحيات المستخدم الذي سجّل الدخول إلى PaperOffice. تنطبق عضوية مساحة العمل والأدوار والمجلدات المشتركة وقواعد الاحتفاظ (WORM) والاحتجاز القانوني دون تغيير. يبقى المستخدم الذي له صلاحية القراءة فقط في PaperOffice بصلاحية القراءة فقط في المساعد.
تحمل كل أداة عنوانًا وتلميحًا يشير إلى ما إذا كانت تقرأ فقط أم تغير شيئًا. يستخدم المساعد هذه التلميحات لطلب إذنك قبل أن يتصرف. تُصنف عمليات الحذف، وتفريغ سلة المهملات، وإرسال طلبات التوقيع على أنها مدمرة، لذا توقع سؤال تأكيد. تنتقل المستندات المحذوفة أولاً إلى سلة المهملات PaperOffice ويمكن استعادتها في التطبيق.
إعدادات الحساب، الفواتير، إدارة المستخدمين وإنشاء مفاتيح API غير متاحة عبر الوصلة. تبقى في تطبيق PaperOffice.
تدفق البيانات: ما يراه المساعد وما يتلقاه PaperOffice
- تكتب طلباً في المساعد.
- يقرر المساعد أي أداة PaperOffice يجب استدعاؤها ويرسل المعاملات، على سبيل المثال مصطلح بحث أو معرف مستند، إلى خادم MCP PaperOffice.
- يشغل PaperOffice الاستدعاء بصلاحياتك ويعيد النتيجة، على سبيل المثال نص مستند واحد أو قائمة بأسماء الملفات.
- تصبح النتيجة جزءاً من محادثتك مع المساعد وتُعالج بموجب شروط مزود المساعد.
لا يتلقى PaperOffice سجل محادثاتك، مطالباتك أو إجابات المساعد. فقط استدعاء الأداة نفسه يصل إلى الخادم: اسم الأداة، المعاملات، الوقت والمستخدم. لا يقوم PaperOffice برفع المستندات إلى مزود المساعد بشكل مستقل؛ يتلقى المزود فقط ما طلبه المساعد.
يتم تسجيل كل استدعاء أداة مع الوقت والمستخدم وCredits. يرى المسؤولون الاستدعاءات تحت واجهة برمجة التطبيقات والمطورون → استخدام API.
الفواتير
يتم فرض رسوم على كل استدعاء أداة عبر الوصلة في Credits، تماماً مثل استدعاء API المقابل. لا يوجد اشتراك منفصل للوصلة. بعض استعلامات الحالة وفحوصات السلامة غير مفوترة؛ التفاصيل في وثائق API. عندما تنفد Credits، يتم رفض الاستدعاءات برسالة واضحة؛ لا يتم حذف أي شيء. المزيد في دليل الفواتير و Credits: الفواتير و Credits في PaperOffice AI.
إلغاء الوصول
- في المساعد، أزل أو افصل وصلة PaperOffice. يتوقف المساعد عن استخدامها على الفور؛ المحادثات التي تحتوي بالفعل على نتائج PaperOffice تحتفظ بذلك النص.
- في PaperOffice، افتح حساب → API. تظهر اتصالات المساعد في قائمة رموز النفاذ مع شارة MCP. احذف رمز النفاذ الخاص بذلك الاتصال هناك.
- بالنسبة لـ Cursor، قم بتدوير أو حذف رمز النفاذ على نفس الصفحة.
إن سحب الإذن لا يؤدي إلى حذف أي بيانات.
استكشاف الأخطاء وإصلاحها
- نافذة تسجيل الدخول لا تفتح: اسمح بالنوافذ المنبثقة للمساعد وحاول نافذة متصفح خاصة. في خطط الفريق أو Enterprise، اسأل المسؤول عما إذا كانت الوصلة مفعّلة.
- متصل، ولكن لا تظهر أدوات PaperOffice: فعّل الأدوات للمحادثة، أو ابدأ محادثة جديدة.
- "غير مصرح" أثناء استدعاء أداة: تم إلغاء الاتصال أو انتهت صلاحيته. اتصل مرة أخرى. مع رمز، تحقق من أنه رمز مستخدم أو مجموعة.
- المساعد لا يجد أي مستندات: اسأل عن قائمة مساحات العمل أولاً. قد لا يكون للمستخدم المتصل وصولاً إلى مساحة العمل التي تتوقعها. المستندات المرفوعة مؤخراً تحتاج إلى لحظة حتى تنتهي المعالجة.
- رصيد Credits غير كافٍ: أعِد الشحن من تطبيق PaperOffice أو فعّل الشحن التلقائي.
لا تزال عالقة؟ افتح تذكرة دعم مع المساعد والخطة، الرسالة الدقيقة، الوقت مع المنطقة الزمنية وإذا أمكن لقطة شاشة بدون بيانات شخصية.
توصية لفرق تكنولوجيا المعلومات
- النطاقات للسماح: mcp.paperoffice.ai, api.paperoffice.ai و app.paperoffice.ai. كل حركة المرور تستخدم HTTPS؛ لا حاجة لاتصال وارد إلى شبكتك.
- ابدأ بنموذج تجريبي: مساحة عمل واحدة وأدوار للقراءة فقط. فعّل أدوار الكتابة لكل مساحة عمل بعد النموذج التجريبي.
- راجع استخدام API بانتظام خلال الأسابيع الأولى.
الأسئلة الشائعة
- هل يجب عليّ تثبيت أي شيء؟ لا، يتصل المساعد بعنوان URL.
- هل يمكن للمساعد رؤية جميع مستنداتي؟ فقط ما يحق لمستخدم PaperOffice الخاص بك رؤيته.
- هل يقوم PaperOffice بقراءة محادثاتي؟ لا، تصل فقط استدعاءات الأدوات إلى PaperOffice.
- هل هناك اشتراك منفصل للموصل؟ لا، يتم فوترة الاستدعاءات بـ Credits مثل استدعاءات API.
- كيف يمكنني إنهاء الوصول؟ أزل الموصل في المساعد واحذف رمز النفاذ الخاص بالاتصال تحت الحساب → API.