خادم GroupDocs MCP يتيح لـ Claude Desktop و Claude Code و Cursor و GitHub Copilot وغيرها من عملاء MCP العمل مع مستنداتك محليًا: يبدأ العميل الخادم كعملية فرعية على جهازك الخاص، وتُقرأ الملفات وتُكتب في المجلدات التي تختارها. يتم توثيق الهندسة الكاملة ونموذج الأمان في صفحة كل منتج على الوضع المحلي، على سبيل المثال تشغيل خوادم GroupDocs MCP على الوضع المحلي: الهندسة ونموذج الأمان. تقارن هذه المقالة بين الطرق الثلاث الشائعة لربط وكيل الذكاء الاصطناعي بالمستندات وتوضح ما يخرج وما لا يخرج من الجهاز.

أي بنى يمكنها ربط وكيل الذكاء الاصطناعي بالمستندات؟

هناك ثلاث طرق. تختلف في السؤال الذي يطرحه مراجع الأمان أولاً: إلى أين يذهب المستند؟

رفع إلى السحابة API مستضاف خادم MCP محلي
كيف يعمل المساعد أو الإضافة يرفع الملف إلى خدمة البائع شفرتك أو الوكيل يستدعي API REST للبائع مع الملف عميل الذكاء الاصطناعي يبدأ عملية خادم على جهازك
إلى أين يذهب المستند سحابة طرف ثالث سحابة طرف ثالث أو مستأجرك الخاص لا مكان: يُقرأ ويُكتب في مجلدات محلية
سطح الشبكة خروج إلى البائع خروج إلى البائع stdio فقط؛ لا شيء مع ملف الترخيص، تقارير الاستخدام فقط (بدون محتوى المستند) مع الترخيص القائم على الاستهلاك
المنافذ الواردة غير مطبق غير مطبق لا شيء
الاستخدام في بيئة معزولة غير ممكن عادةً لا؛ يعتمد على خيارات نشر البائع ممكن مع ملف الترخيص
من يديره البائع البائع أنت، كجزء من عميل الذكاء الاصطناعي

العمود الثالث هو ما تنفذه خوادم GroupDocs MCP. يغطي باقي هذه المقالة كيفية عمله وأين حدودها.

كيف يبدو تدفق البيانات في خادم MCP محلي؟

يقوم عميل الذكاء الاصطناعي بإطلاق الخادم كعملية فرعية ويتواصل معه عبر الإدخال والإخراج القياسي باستخدام JSON-RPC. لا يستمع الخادم أبدًا على منفذ شبكة، ومع ملف الترخيص لا يُجري أي اتصالات صادرة أيضًا.

+--------------+          +--------------------+         +------------------+
|  عميل الذكاء |  stdio   | عملية خادم MCP    | يقرأ / | نظام ملفات محلي |
|  الاصطناعي   | <------> | (محرك GroupDocs)  | <-----> | تخزين / إخراج   |
| (Claude,     | JSON-RPC |   عملية فرعية      |  يكتب |   مجلدات        |
|  Cursor, ..) |          |                    |        |                  |
+--------------+          +--------------------+         +------------------+
       |
       | فقط المطالبات والقطعات المقتبسة
       v
+--------------------+
|   مزود النموذج     |  (سحابة، أو نموذج محلي داخل شبكتك)
+--------------------+

يحصل مراجع الأمان على أربع عبارات يمكن التحقق منها:

  • النقل: الإدخال والإخراج القياسي إلى عملية فرعية. لا شيء لتأمينه ولا شيء لتعرضه.
  • المنافذ الواردة: لا شيء.
  • التقارير: لا شيء. يعمل محرك المستند داخل العملية.
  • استخدام الشبكة: فقط عند التثبيت، لسحب الحزمة من nuget.org أو الصورة من ghcr.io. أثناء التشغيل لا يجري الخادم أي مكالمات صادرة، باستثناء استثناء الترخيص الموضح أدناه.

يمكنك التحقق من ذلك بدلاً من الوثوق به: شغّل مهمة وراقب المقابس المستمعة والاتصالات الصادرة.

ما الذي يخرج من الجهاز عندما يعالج وكيل مستندًا؟

المستندات لا تخرج من الجهاز. المطالبات والقطعات المقتبسة هي التي تخرج.

النموذج وراء عميل الذكاء الاصطناعي الخاص بك يرى المحادثة. إذا كان النموذج مستضافًا في السحابة، يصل نص التعليمات إلى مزود النموذج، وكذلك أي شيء يقتبسه الوكيل لك. مثالان:

  • بعد مقارنة، يُبلغ الوكيل أن شرط الدفع تغير من 30 إلى 45 يومًا. هذه الجملة جزء من المحادثة وتنتقل إلى المزود.
  • بعد استخراج، يُبلغ الوكيل عن إجمالي الفاتورة. الملف لم يتحرك، لكن القيمة انتقلت.

عادةً ما يكون من المفيد صياغة المطالبات بحيث يحمل الجواب محتوى أقل، مثل سؤال أي ملفات لديها إجمالي فوق حد معين بدلاً من طلب الإجماليات. بالنسبة للبيانات الحساسة، اجمع الخادم مع نموذج مستضاف محليًا. بذلك يبقى الحلقة كاملة (العميل، النموذج، الخادم، الملفات) داخل شبكتك.

هل يحتاج الخادم المحلي إلى اتصال بالإنترنت؟

ليس للمعالجة. يعتمد ذلك على وضع الترخيص:

  • ملف الترخيص: يُقرأ من القرص المحلي بواسطة العملية المحلية. يعمل بالكامل دون اتصال وهو الخيار المناسب للشبكات المعزولة.
  • قائم على الاستهلاك (دفع حسب الاستخدام): يُرسل الخادم استخدامًا إلى GroupDocs، لذا يحتاج إلى خروج صريح. لا يحتوي التقرير على محتوى المستند، لكن يجب السماح بالاتصال عبر جدار الحماية الخاص بك.

إذا تم تكوين كل من مفاتيح الاستهلاك وملف الترخيص، تُعطى مفاتيح الاستهلاك الأولوية. احتفظ بالمفاتيح في متغيرات البيئة بدلاً من وضعها في تكوين مُلتزم. تصف صفحة الترخيص لكل منتج الإعداد، وتُظهر أداة get_license_status الوضع النشط.

كيف تشغّل الخادم داخل الحدود باستخدام Docker؟

غالبًا ما تكون صورة Docker الخيار الأسهل لفريق المنصة: صورة واحدة مع الاعتمادات الأصلية، لا SDK على المضيف، وحدود محصورة بالمجلدات التي تُركّبها. لكل منتج صورته الخاصة، تُسمى ghcr.io/groupdocs-<product>/<product>-net-mcp. يوضح الأمر أدناه الشكل لمنتج واحد؛ استبدل القيم النائبة.

docker run --rm -i \
  -v /srv/documents:/data \
  -v /srv/licenses:/license:ro \
  -e GROUPDOCS_MCP_STORAGE_PATH=/data \
  -e GROUPDOCS_LICENSE_PATH=/license/GroupDocs.<Product>.lic \
  ghcr.io/groupdocs-<product>/<product>-net-mcp:<tag>
  • ثبّت العلامة. تستخدم أوامر البدء السريع :latest؛ للإنتاج، ثبّت العلامة إلى الإصدار الذي اختبرته حتى لا يغيّر إعادة بناء السلوك أثناء سير العمل الجاري.
  • ركّب عن قصد. الحاوية ترى فقط المجلدات التي تعطيها إياها، وهو حد أقوى من عملية تعمل كمستخدمك.
  • ركّب الترخيص للقراءة فقط.
  • أقسام معزولة: اسحب الصورة مسبقًا، أو خزن حزمة NuGet مؤقتًا، وثبّت الإصدار.

يشغّل عميل الذكاء الاصطناعي هذا الأمر docker run كأمر الخادم في إعداد MCP الخاص به، لذا تكون الحاوية هي العملية الفرعية في المخطط أعلاه. تصف الوثائق الصور بأنها متعددة المعمارية (linux/amd64 و linux/arm64).

هل الخادم المحلي مناسب للصناعات الخاضعة للتنظيم؟

يُزيل السؤال الأكبر في مراجعة الخصوصية، وهو نقل المستندات إلى معالج طرف ثالث. يمكن للفرق في المجالات القانونية والمالية والرعاية الصحية والقطاع العام التي تحظر سياساتهم رفع المستندات استخدامه ككتلة بناء لتدفقات عمل متوافقة مع HIPAA أو GDPR. هذا يصف ملاءمة الهندسة فقط. خوادم GroupDocs MCP غير مُعتمدة لأي تنظيم، ولا تزال التزاماتك تعتمد على النموذج الذي تقترنه، وضع الترخيص، وضوابطك الخاصة.

ما هي حدود هذا النموذج؟

  • خادم واحد يخدم عملية عميل واحدة. يُبدأ خادم stdio بعملية عميل واحدة على جهاز واحد. ليس خدمة متعددة المستخدمين. لخدمة مشتركة، ضع خدمتك الخاصة أمام مكتبة GroupDocs بدلاً من تشغيل العديد من خوادم MCP.
  • الترخيص القائم على الاستهلاك يحتاج خروجًا. تُرسل تقارير الاستخدام، كما هو موضح أعلاه. اختر ملف ترخيص إذا كان يجب إغلاق الشبكة.
  • المطالبات لا تزال تصل إلى مزود النموذج ما لم تستخدم نموذجًا مستضافًا محليًا.
  • وضع التقييم له حدود. بدون ترخيص تعمل الخوادم في وضع التقييم مع قيود خاصة بالمنتج. على سبيل المثال، يُقارن خادم Comparison فقط الصفحتين الأوليين ويضع علامة مائية على النتيجة. استدعِ get_license_status أولًا واقرأ صفحة الترخيص لمنتجك.
  • Parser و Search يُوزّعان كصور Docker فقط. لا توجد حزمة NuGet لـ GroupDocs.Parser.Mcp و GroupDocs.Search.Mcp، لذا فإن مسار Docker أعلاه هو المسار الوحيد لتلك المنتجات. على مضيف Linux، شغّل حاوياتهما مع --user "$(id -u):$(id -g)" حتى يتمكنا من الكتابة في المجلدات التي تركّبها.
  • استثناءات المنصة. عمليتان خاصتان بـ PDF تفشلان حاليًا على Linux، بما في ذلك صورة Docker، لأن معالجة الصور في محرك PDF تعتمد على System.Drawing.Common، الذي يدعمه .NET فقط على Windows: generate_pages_preview في GroupDocs.Annotation.Mcp على ملفات PDF (تُعرض مستندات Word)، وredact_image_area وerase_metadata في GroupDocs.Redaction.Mcp على ملفات PDF (redact_text على PDF، وجميع الثلاثة على مستندات Word، تعمل). شغّلها على Windows باستخدام dnx؛ راجع مشاركات المنتج.

الأسئلة المتكررة

هل MCP آمن للمستندات الحساسة؟
مع خادم GroupDocs MCP تُعالج المستندات داخل العملية على جهازك عبر stdio، دون منافذ مستمعة ولا تقارير. ما يبقى لتقييمه هو النموذج الذي يستخدمه عميل الذكاء الاصطناعي الخاص بك، لأن المطالبات والقطعات المقتبسة تذهب إلى هناك.

هل يمكنني تشغيل أدوات Claude دون إرسال البيانات إلى السحابة؟
المستندات تبقى محلية في كلتا الحالتين. للحفاظ على المطالبات محلية أيضًا، استخدم عميلًا يدعم نموذجًا مستضافًا محليًا، بحيث لا يغادر أي جزء من المحادثة شبكتك.

ما البيانات التي يرسلها خادم MCP؟
أثناء التشغيل لا يرسل خادم GroupDocs MCP أي شيء عبر الشبكة عندما يُستخدم ملف الترخيص. مع الترخيص القائم على الاستهلاك يرسل تقارير الاستخدام إلى GroupDocs، ولا يرسل محتوى المستند.

حسب المنتج: صفحات الوضع المحلي في الوثائق

كل صفحة تغطي نفس الهندسة مع الأوامر الخاصة بذلك المنتج. هذه هي المراجع الرسمية لمراجعة الأمان.

حسب المنتج: من أين تبدأ في المدونة

لكل منتج سلسلة من المشاركات — أربعة لمعظمها، وستة لـ Search. الأولى تشرح النمط؛ والبقية تطبقه.