ملخص
وكيل الذكاء الاصطناعي يجب أن يختار أي ملف يُحوَّل وإلى أي تنسيق يُحوَّل، بينما يجب على محرك التحويل القيام بعملية التحويل نفسها. باستخدام خادم GroupDocs.Conversion.Mcp، يمكن لـ Claude أو Cursor أو GitHub Copilot استدعاء هذا المحرك محليًا على جهازك من جملة واحدة:

تحويل contract.docx إلى PDF

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: How to convert documents with AI agents using MCP. يوضح هذا المنشور لماذا يُهم الفصل بين الوكيل والمحرك وأين يجب أن يبقى الوكيل بعيدًا عن التنفيذ.

ما الخطأ الذي يحدث عندما يحول الوكيل ملفًا بنفسه؟

نموذج اللغة الذي “يحوِّل” ملف PDF إلى Word لا يقوم بالتحويل فعليًا. هو يقرأ المحتوى المُعطى له ويكتب محتوى جديدًا بالتنسيق المستهدف. ما لم يره النموذج لا يستطيع إعادة إنتاجه: الخط الدقيق، هندسة الأعمدة، الفاصل الصفحي قبل جدول، أسماء الأنماط التي يعتمد عليها قالب Word. ما يُعاد يبدو كتحويل لكنه في الواقع إعادة كتابة.

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

ما الذي يجب أن يقرره الوكيل، وما الذي يجب أن يفعله المحرك؟

قسم المهمة على خط الفاصل بين الحكم والتنفيذ.

السؤال يقرر الوكيل يقوم المحرك بـ
ما الملفات التي تقع ضمن النطاق؟ يقرأ طلبك ومجلد التخزين لا شيء
ما التنسيق المستهدف؟ يطابق “اجعلها قابلة للتحرير” إلى DOCX، “احفظها كأرشيف” إلى PDF لا شيء
هل الملف قابل للتحويل أصلاً؟ يستدعي get_supported_formats ويقرأ الجواب يُبلغ عن صيغ الهدف الصالحة
ما حجم الملف؟ يستدعي get_document_info ويقرأ عدد الصفحات يقرأ النوع، عدد الصفحات، الخصائص
عملية التحويل نفسها يستدعي convert يُنشئ المخرجات باستخدام محرك GroupDocs.Conversion
ماذا يفعل عند الفشل؟ يعيد المحاولة، يسألك، أو يتخطى الملف يُعيد السبب كنص

الوكيل لا يلمس بايتات مستندك أبدًا. هو يمرّر اسم الملف والتنسيق، والمحرك يُعيد ملفًا.

كيف تُوصِّل الوكيل بالمحرك محليًا؟

سجِّل الخادم مرة واحدة في عميلك. يستخدم Claude Desktop ملف claude_desktop_config.json، ويستخدم Claude Code الأمر claude mcp add، ويستخدم VS Code مع GitHub Copilot ملف mcp.json، ويستخدم Cursor ملف ~/.cursor/mcp.json. يدعم الخادم أيضًا Visual Studio 2022، Windsurf، Cline، Codex CLI و JetBrains Rider. مثال على إدخال Claude Desktop:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

يحتاج dnx إلى .NET 10 SDK. إذا كنت تفضّل Docker، فإن الصورة المستقلة هي ghcr.io/groupdocs-conversion/conversion-net-mcp:latest، شغّلها بـ docker run --rm -i -v $(pwd)/documents:/data. يتواصل العميل مع الخادم عبر stdio: المسار هو الوكيل → الخادم المحلي → نظام الملفات المحلي. أعد تشغيل العميل بعد التسجيل.

أي أداة تُستدعى لكل طلب؟

يُظهر الخادم أربع أدوات. أسماؤها حرفية؛ يبحث الوكلاء عنها عندما يحدث عطل.

  • convert يحوِّل مستندًا إلى تنسيق آخر ويحفظ النتيجة في مجلد التخزين أو مجلد الإخراج. يأخذ المتغيّرات file، format (مثل pdf، docx، xlsx، pptx، html، png، jpg، csv، txt، rtf، md) وpassword اختياريًا.
  • get_supported_formats يسرد صيغ الهدف التي يمكن للملف المصدر أن يتحول إليها.
  • get_document_info يُعيد نوع الملف، عدد الصفحات والخصائص الأساسية دون تحويل.
  • get_license_status يُبلغ ما إذا كان الخادم يعمل في وضع التقييم، أو بملف ترخيص، أو بنظام الفوترة.

تعمل المطالبات المفتوحة لأن الوكيل يُسلسِلها:

ما الصيغ التي يمكنني تحويل ملف Visio هذا إليها؟ ثم حوِّله إلى PDF.

تحقق أولاً من عدد صفحات whitepaper.pdf، ثم حوِّله إلى DOCX.

لا تُستبدل الملفات الموجودة أبدًا. التحويل الثاني لنفس الملف يحصل على اسم مميز، مثل report (1).pdf.

جلسة مثال

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

أنت:    حوِّل contract-draft.pdf إلى DOCX حتى أتمكن من تحريره.
الوكيل: [ينفّذ convert مع file.filePath = "contract-draft.pdf", format = "docx"]
الوكيل: تم. تم حفظ الملف المحوَّل كـ contract-draft.docx في مجلد الإخراج الخاص بك.

للحصول على الحلقة الكاملة، يُظهر دليل n8n نفس المحرك مدفوعًا بسير عمل بدلاً من محادثة، وتغطي الإعلان الخادم بشكل عام.

ما هي الحدود؟

  • وضع التقييم. بدون ترخيص يضيف الخادم علامة مائية للتقييم إلى المخرجات المحوَّلة ويحد كل عملية خادم إلى 15 مستندًا مفتوحًا؛ إعادة تشغيل الخادم تُعيد العد. اسأل وكيلك “ما حالة ترخيص خادم التحويل؟” أولًا؛ get_license_status يجيب دون معالجة مستند.
  • لا يوجد OCR. يحوِّل الخادم المستندات التي تحتوي على طبقة نصية. المسح الضوئي المحفوظ كملف PDF صورة‑فقط لن يُنتج نصًا قابلاً للتحرير.
  • تحويل، ليس استخراجًا. هذا الخادم يُحوِّل المستندات بالكامل. لاستخراج البيانات على مستوى الحقول، فإن خادم GroupDocs.Parser.Mcp المرافق (متوفر كصورة Docker فقط) هو الأنسب، وتستخدم العديد من خطوط الأنابيب كليهما.

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

هل يستطيع Claude تحويل ملف docx إلى pdf؟
نعم، مع خادم تحويل مرفق. يستدعي Claude convert مع format: "pdf"، ويُنتج محرك GroupDocs الملف على جهازك.

هل تُرفع ملفاتي عندما يحولها الوكيل؟
ليس مع هذا الخادم. فهو يعمل محليًا عبر stdio، وتبقى المستندات في مجلد التخزين الخاص بك. يُقرأ ملف الترخيص أيضًا من القرص المحلي.

ما الصيغ التي يستطيع الخادم تحويلها؟
أكثر من 100 صيغة من مستندات، جداول بيانات، عروض تقديمية، صور، بريد إلكتروني، CAD وويب، نفس مجموعة مكتبة GroupDocs.Conversion لـ .NET. اسأل get_supported_formats للحصول على القائمة الدقيقة لملف معين.

تعمّق أكثر