الانتقال إلى المحتوى الرئيسي
لكل مشروع خادم MCP خاص به، بحيث يستطيع عميل ذكاء اصطناعي على حاسوبك قراءة المشروع وتحريره وتجميعه والرد على تعليقاته. يسجّل العميل الدخول باستخدام رمز مصادقة Git.
إذا لم تظهر لك بطاقة MCP server، فوجّه المسؤول إلى صفحة خادم MCP.

الجديد في v6.3.3

بدءًا من v6.3.3، يستطيع العميل أيضًا العمل مع سجل المشروع: عرض التغييرات، والمقارنة بين نسختين، وقراءة ملف كما كان، وحفظ النسخ وحذفها، واستعادة ملف أو المشروع بأكمله. ويمكنه عرض التغييرات المتتبَّعة وقبولها أو رفضها، وجعل تعديلاته تغييرات متتبَّعة عندما تطلب منه ذلك. ويمكنه التعليق على جزء من النص وتحرير رسائل التعليقات أو حذفها، وقراءة الرسائل وإرسالها في دردشة المشروع، ونقل الملفات والمجلدات وإعادة تسميتها، وإنشاء المجلدات، وتغيير لغة التدقيق الإملائي. يخضع من يحق له فعل ماذا لدورك في المشروع، كما في المحرر، لأن العميل يعمل برمزك: راجع من يحق له فعل ماذا. قُدّم خادم MCP في v6.3.1. تحتوي v6.3.1 وv6.3.2 على الأدوات الـ 17 نفسها، بينما تحتوي v6.3.3 على 33 أداة.

توصيل عميل

1

افتح مربع الحوار

افتح المشروع. في الشريط الأيسر، انقر على Integrations ثم على MCP server.
لوحة Integrations مع بطاقة MCP server

لوحة Integrations

يعرض مربع الحوار عنوان خادم هذا المشروع وعلامة تبويب لكل عميل: Claude Code وCodex وCursor وVS Code وGemini CLI.
مربع الحوار MCP server مع العنوان وعلامة تبويب لكل عميل والأمر الخاص بـ Claude Code

مربع الحوار MCP server

2

أنشئ رمزًا

انقر على Go to settings. تُفتح إعدادات حسابك في علامة تبويب جديدة. تحت Git integration، انقر على Generate token، أو على Add another token إذا كان لديك رمز بالفعل. انقر على Copy واحتفظ بالرمز في مكان آمن، لأنك لن تراه إلا مرة واحدة. ثم انقر على Close.
مربع الحوار Git authentication token مع زر Copy

رمزك الجديد

يعمل أيضًا رمز تستخدمه بالفعل لـ تكامل Git، كما يمكن استخدام رمز واحد لجميع مشاريعك.
3

أضف الخادم إلى عميلك

عُد إلى مربع الحوار، وانقر على علامة تبويب عميلك ثم على Copy بجوار الإعدادات.العنوان خاص بمشروع واحد. لتوصيل مشروع آخر، أضفه باسم آخر، لأن الاسم overleaf مستخدم بالفعل. في Claude Code مثلًا، غيّر overleaf في الأمر إلى overleaf-lab.

التحقق من الاتصال

باستخدام Claude Code

يظهر الخادم على أنه متصل:

باستخدام curl

تعمل هذه الطريقة مهما كان عميلك. استبدل العنوان والرمز، وأرسل طلب initialize الخاص ببروتوكول MCP:
تذكر الاستجابة اسم الخادم، تليه تعليماته للعملاء:
لرؤية الأدوات، أرسل tools/list بالأمر نفسه. تعرض الاستجابة 33 أداة، أو 31 إذا كانت دردشة المشروع معطّلة في موقعك. قبل v6.3.3 تعرض 17.
لاستدعاء أداة، أرسل tools/call:

في إعدادات حسابك

تحت Git integration، يعرض Last used التاريخ الخاص برمز تلقّاه الخادم.
قائمة الرموز، مع تاريخ تحت Last used للرمز الأول وN/A للرمز الثاني

تم استخدام الرمز الأول

إذا لم يتصل

ما تراه عندما يعمل العميل

تظهر التعديلات في المحرر المفتوح أثناء قيام العميل بها، مثل تعديلات أي متعاون، دون إعادة تحميل. تظهر الملفات والمجلدات الجديدة وعمليات النقل وإعادة التسمية في شجرة الملفات.
المحرر يعرض سطرًا أضافه edit_file، دون مربع حوار ودون إعادة تحميل

سطر أضافه edit_file

لا يغيّر edit_file إلا نصًا يظهر مرة واحدة بالضبط. وإلا يتلقى العميل خطأً، مثل oldString not found in main.tex, read_file again أو oldString appears 2 times in main.tex, add context، ولا يتغيّر شيء. بدءًا من v6.3.3، ينقل move_file ملفًا أو مجلدًا أو يعيد تسميته، وينشئ مجلدات المسار الجديد عند الحاجة، وينشئ create_folder مجلدًا. إذا لم يُعثر على الملف أو كان المسار الجديد موجودًا بالفعل، يتلقى العميل خطأً ولا يتغيّر شيء. يمكن لـ update_settings أيضًا تغيير لغة التدقيق الإملائي، مثل de، أو إيقاف التدقيق الإملائي. تظهر الردود على التعليقات في لوحة المراجعة باسمك، لأن الرمز رمزك. يختفي التعليق الذي حُلّ عبر الخادم من اللوحة، وإعادة فتحه تعيده.
تعليق في لوحة المراجعة مع رد أرسله reply_to_comment

رد أرسله reply_to_comment

بدءًا من v6.3.3، يعلّق add_comment على جزء من النص. يجب أن يظهر النص في الملف مرة واحدة بالضبط؛ وعندما يظهر أكثر من مرة، يقدّم العميل أيضًا جزءًا أطول يحيط به ويظهر مرة واحدة، ولا يُعلَّق إلا على النص نفسه. يظهر التعليق في لوحة المراجعة باسمك ويبقى مرتبطًا بنصه عند تغيّر الملف. يغيّر edit_comment_message إحدى رسائلك. ويحذف delete_comment_message رسالة، وحذف الرسالة الأولى يحذف التعليق كله، كما في لوحة المراجعة. يجمّع compile المشروع ويعيد قائمة ملفات الإخراج. ثم يعطي get_output_file_link رابطًا لتنزيل ملف PDF أو ملف إخراج آخر. لا يحتاج الرابط إلى رمز ويتوقف عن العمل بعد 5 دقائق. للاطلاع على القائمة الكاملة للأدوات، راجع Tools.

التغييرات المتتبَّعة

بدءًا من v6.3.3، يمكنك أن تطلب من العميل جعل تعديلاته تغييرات متتبَّعة، مثل Rewrite the abstract as a tracked change. عندها يجعل edit_file وwrite_file التغيير على ملف موجود تغييرًا متتبَّعًا باسمك، حتى عندما يكون تتبّع التغييرات معطّلًا في المشروع، وتقبله أنت أو ترفضه في لوحة المراجعة. لا يكون الملف الجديد تغييرًا متتبَّعًا أبدًا. إذا لم تطلب ذلك، تتبع التعديلات إعداد تتبّع التغييرات في المشروع، مثل تعديلاتك في المحرر: تُتتبَّع عندما يكون التتبّع مفعّلًا لك أو للجميع. إذا لم يكن لدى حساب مالك المشروع ميزة تتبّع التغييرات، يتلقى العميل Track changes is off for this project ولا يتغيّر شيء. لمراجعة كل تعديل يجريه العميل، فعّل تتبّع التغييرات لنفسك. ولتمييز تعديلاته عن تعديلاتك في لوحة المراجعة، أعطِ العميل رمز حساب آخر تشاركه المشروع. يعرض list_tracked_changes التغييرات المتتبَّعة مع ملفها والنص المُدرج أو المحذوف والمؤلف والوقت. يأخذ accept_tracked_changes وreject_tracked_changes معرّفات التغييرات ويعملان مثل لوحة المراجعة: يبقى التغيير المقبول في النص، ويُزال الإدراج المرفوض، ويعود الحذف المرفوض. يعرض المحرر المفتوح النتيجة دون إعادة تحميل. توجّه الأدوات العميل إلى قبول أو رفض التغييرات التي تطلبها فقط.

السجل

بدءًا من v6.3.3، يرى العميل سجل المشروع كما تعرضه لوحة السجل. الاستعادة نفسها تغيير جديد، لذا يمكنك التراجع عنها بالطريقة نفسها. توجّه الأدوات العميل إلى الاستعادة فقط عندما تطلب ذلك. إذا لم يكن لدى مالك المشروع سجل المشروع الكامل، لا يرى العميل إلا تغييرات آخر 24 ساعة، أو أحدث تغيير إذا كانت جميعها أقدم، كما في لوحة السجل. ولا يمكنه مقارنة النسخ الأقدم أو قراءتها أو استعادتها.

دردشة المشروع

بدءًا من v6.3.3، يقرأ list_chat_messages دردشة المشروع، الأحدث أولًا، 50 رسالة في كل مرة. ويرسل send_chat_message رسالة باسمك، فتظهر فورًا في الدردشة المفتوحة. إذا كانت دردشة المشروع معطّلة في موقعك، فلا يملك العميل أيًا من الأداتين.

من يحق له فعل ماذا

يمكن للعميل فعل ما يسمح به دورك في المشروع. يُعدّ المحرّرون الذين انضموا عبر رابط محرّرين. لا يستطيع المراجعون تحرير الملفات عبر MCP، ولا حتى كتغييرات متتبَّعة.

فصل عميل

احذف الرمز: راجع حذف رمز. منذ ذلك الحين يردّ الخادم بـ 401 على ذلك الرمز. وإذا كنت تستخدمه أيضًا مع Git، يتوقف Git كذلك عن قبوله.
آخر تعديل في ٢١ نوفمبر ٢٠٢٦