ترجمة PDF داخل Claude Code وCursor عبر خادم MCP: دليل الإعداد خطوة بخطوة

هل يستطيع Claude ترجمة ملف PDF كاملًا نيابةً عنك؟

نعم، إذا ربطته بخادم MCP للترجمة. أضف خادم MCP من Belin Doc إلى Claude Code أو Cursor أو أي عميل MCP آخر باستخدام مفتاح API، ثم اطلب منه: «ترجم ملف PDF هذا إلى اليابانية». سيرفع المساعد الملف ويرسل مهمة الترجمة وينتظر اكتمالها، ثم يعيد إليك رابط تنزيل الملف المترجم مع الحفاظ على تنسيقه الأصلي.

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

يشرح هذا الدليل وظيفة الخادم، وطريقة ربطه، وخطوات الترجمة، والقيود التي ينبغي مراعاتها.

ما الذي يفعله خادم MCP للترجمة فعلًا؟

MCP (اختصار Model Context Protocol) طريقة معيارية تتيح لعميل الذكاء الاصطناعي استدعاء أدوات خارجية. يتصل عميل مثل Claude Code أو Cursor بخادم MCP، ويقرأ قائمة أدواته، ثم يحدد أيها يستدعي لتنفيذ طلبك.

يوفّر خادم MCP من Belin Doc خدمتَي ترجمة المستندات والفيديو المتاحتين على belindoc.com في صورة أدوات. وأهم أدوات المستندات:

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

خادم بعيد أم stdio محلي: أي إعداد تختار؟

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

عن بُعد (Streamable HTTP). يتصل عميلك بالعنوان https://mcp.belindoc.com/api/mcp ويرسل مفتاح API في ترويسة Authorization: Bearer. لا يتطلب هذا الخيار تثبيت شيء على جهازك، ويناسب العملاء الذين يدعمون العناوين البعيدة والترويسات المخصصة، مثل Claude Code وCursor.

محليًا (stdio). يشغّل عميلك الخادم على جهازك عبر uvx belindoc-mcp، ويُضبط المفتاح في متغير بيئة بدلًا من الترويسة. يتطلب ذلك uv، وهو البديل للعملاء الذين يصعب ضبط العناوين البعيدة أو الترويسات في إعداداتهم، ومنهم Claude Desktop.

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

كيف تُعدّ خادم MCP في Claude Code وCursor؟

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

Belin Doc MCP setup guide: let AI translate a whole PDF in 3 steps

الخطوة 1: أنشئ مفتاح API

سجّل الدخول إلى belindoc.com، وافتح قائمة صورة الحساب أعلى اليمين، ثم اختر «مركز المطورين». أنشئ مفتاحًا وانسخه فورًا؛ إذ تظهر قيمته الكاملة مرة واحدة فقط، ولا يُخزَّن بعدها سوى تجزئتها (hash). يمكن للحساب الاحتفاظ بخمسة مفاتيح افتراضيًا، ويمكن تحديد تاريخ انتهاء وقائمة عناوين IP مسموح بها لكل مفتاح.

الخطوة 2: أضف الخادم إلى عميلك

للاتصال عن بُعد، أضف هذه الكتلة إلى ملف إعداد MCP في عميلك (.mcp.json في Claude Code، و.cursor/mcp.json في Cursor)، وضع مفتاحك بعد Bearer:

{
  "mcpServers": {
    "belindoc-mcp": {
      "type": "http",
      "url": "https://mcp.belindoc.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <مفتاح API الخاص بك>"
      }
    }
  }
}

وللإعداد المحلي في Claude Code، شغّل:

claude mcp add belindoc-mcp \
  -e BELINDOC_API_KEY=<مفتاح API الخاص بك> \
  -- uvx belindoc-mcp

تتضمن صفحة MCP أيضًا إعدادات Claude Desktop وCodex وWindsurf وVS Code. تختلف مسارات ملفات الإعداد ومفاتيح المستوى الأعلى فيها من عميل إلى آخر، وقد تتغير مع الوقت. راجع توثيق عميلك إذا لم تُحمَّل الإعدادات.

الخطوة 3: تحقّق من الاتصال

اطرح على المساعد سؤالًا بلا تكلفة، مثل: «كم صفحة تبقّت لي هذا الشهر؟». سيستدعي get_account_status؛ فإذا أعاد حصتك، فهذا يعني أن المفتاح يعمل والخادم متصل.

الخطوة 4: اطلب الترجمة

حدّد للمساعد الملف المطلوب وما تريد فعله: «ترجم contracts/nda.pdf إلى الألمانية». إذا لم تحدد نموذجًا، فسيسألك أيّها يستخدم، ثم يرفع الملف ويرسل المهمة وينتظر اكتمالها ويعيد إليك رابط التنزيل.

ماذا يجري خلف طلب «ترجم ملف PDF هذا»؟

يساعدك فهم تسلسل الخطوات على معرفة أسباب معظم المشكلات.

1. الرفع. تعيد upload_document رابطًا موقّعًا قصير الصلاحية وأمر رفع جاهزًا. ينفّذ المساعد الأمر على جهازك لإرسال الملف؛ ولا يقرأ الخادم ملفات جهازك من تلقاء نفسه.
2. فحص المسح الضوئي. قبل إرسال ملف PDF، يتحقق الخادم مما إذا كان ممسوحًا ضوئيًا. تمر ملفات PDF الممسوحة عبر OCR، وتُخصم صفحاتها من حصة الصفحات المعتادة، مع حدّ شهري إضافي لصفحات OCR في الحسابات المجانية، ويُبلَّغ المساعد بمسار معالجة كل ملف.
3. الإرسال. تبدأ translate_document المهمة باللغات والنموذج الذي اخترته. ويمكنك أيضًا تمرير معرّف مسرد من قاموس المصطلحات في Belin Doc لتحديد كيفية ترجمة الأسماء والمصطلحات.
4. الانتظار. تعيد wait_for_translation تحديثًا كلما تغيّر التقدم، ليتمكن المساعد من إخبارك بما وصلت إليه الترجمة.
5. التنزيل. تعيد get_document_translation_result رابط تنزيل موقّعًا. سلسلة الاستعلام بعد ? هي التوقيع، لذا استخدم الرابط كما هو تمامًا.

لأن المساعد ينفّذ أمرًا في الخطوة 1، يكون سير العمل أكثر سلاسة مع عميل لديه وصول إلى الطرفية، مثل Claude Code أو Codex أو وكيل Cursor. ومن دون هذا الوصول، يمكنك الاطلاع على الحصة وعرض المهام وجلب النتائج، لكن رفع ملف محلي يتطلب تشغيل الأمر في مكان ما.

ما الذي يُحسنه MCP، وما الذي ينبغي التحقق منه؟

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

قبل الاعتماد عليه في المستندات المهمة:

• حدّد النموذج الذي تريده. تتوقف النماذج المتاحة على حسابك. عند ترجمة العقود أو الأدلة التقنية، أخبر المساعد بالنموذج المطلوب بدلًا من تركه يخمّن. يشرح دليل اختيار النموذج النماذج المناسبة لكل نوع من المستندات.
• انتبه إلى ملاحظة OCR في الملفات الممسوحة. تكون نتيجة ترجمة ملف PDF ممسوح دون OCR فارغة، وتُخصم صفحات OCR من حصة الصفحات، مع حدّ شهري إضافي لها في الحسابات المجانية. اقرأ تقرير المساعد لمعرفة مسار معالجة كل ملف.
• راجع الملف المترجم، لا ملخص المحادثة. تؤكد رسالة المساعد اكتمال المهمة فحسب. افتح الملف وراجع عينة من الأسماء والأرقام والجداول، كما تفعل مع أي ترجمة آلية.

الأسئلة الشائعة (FAQ)

ما أنواع الملفات التي يمكنني ترجمتها عبر خادم MCP؟

PDF وDOCX وPPTX وXLSX وTXT وEPUB، إضافة إلى صور PNG وJPG. تُحتسب كل صورة صفحة واحدة، وتمر دائمًا عبر OCR.

هل تُحتسب تكلفة خادم MCP بشكل منفصل عن تطبيق الويب؟

لا. يستخدم MCP الحساب نفسه، وتُخصم الاستدعاءات من حصص الصفحات والفيديو نفسها، وبمعاملات النماذج المعتمدة في تطبيق الويب. لا يوجد تسعير منفصل لـ MCP.

هل يعمل مع Claude Desktop؟

يمكن لـ Claude Desktop الاتصال عبر إعداد stdio المحلي. لكن رفع ملف محلي يتطلب أن ينفّذ المساعد أمر رفع، لذا يكون العميل الذي لديه وصول إلى الطرفية، مثل Claude Code، أكثر موثوقية لترجمة الملفات من جهازك.

ماذا لو تسرّب مفتاح API الخاص بي؟

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

هل يمكنني ترجمة مقاطع الفيديو عبر MCP أيضًا؟

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

أين أجد واجهة API الكاملة بدلًا من MCP؟

لاستدعاء خدمة الترجمة من شيفرتك بدلًا من عميل ذكاء اصطناعي، راجع توثيق API. يغطي التوثيق نقاط نهاية REST التي تستخدم مفاتيح API نفسها.