> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# خادم MCP

> اربط عملاء الذكاء الاصطناعي مثل Claude Code أو Codex بمشروع عبر خادم MCP الخاص به.

يمتلك كل مشروع خادم MCP خاصًا به، بحيث يمكن لعملاء الذكاء الاصطناعي مثل Claude Code و Codex و Cursor و VS Code و Gemini CLI العمل عليه: قراءة ملفاته وتعديلها، وترجمته، وقراءة سجل LaTeX، وتنزيل ملف PDF، والرد على التعليقات.

> [!NOTE]
>
> طُوّرت هذه الميزة بواسطة [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). وهي متاحة بدءًا من الإصدار v6.3.1 وما بعده.

![](https://mintcdn.com/ayakaleaf-pro/75JEUzv4DcYJF7Z-/images/on-premises/8b4eca630b3083da54177b4e7a431571.png?fit=max\&auto=format\&n=75JEUzv4DcYJF7Z-\&q=85\&s=73546d80edf492bf43df53303023ca29)

![](https://mintcdn.com/ayakaleaf-pro/z0f8sws6lnhMSWO4/images/on-premises/img-c48f4f64.png?fit=max\&auto=format\&n=z0f8sws6lnhMSWO4\&q=85\&s=b6f33a465bae9952ce7be3bcb15c57c5)

### الإعداد

يأتي خادم MCP مع التكامل مع Git: فعّل [git-bridge](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md)، وسيصبح خادم MCP متاحًا أيضًا. لا يوجد أي شيء آخر لتكوينه.

### ربط عميل ذكاء اصطناعي

1. في **Account Settings**، أنشئ رمز مصادقة Git (token). يُستخدم الرمز نفسه لخادم MCP ولـ Git.
2. في المحرر، افتح **Integrations** وانقر على **MCP server**. تعرض النافذة عنوان خادم MCP الخاص بالمشروع، `https://<your-overleaf>/project/<project_id>/mcp`، وطريقة إضافته إلى كل عميل ذكاء اصطناعي: انسخ الأمر، واستبدل `<token>` بالرمز الخاص بك.

يُرسَل الرمز في ترويسة HTTP بالصيغة `Authorization: Bearer <token>`. على سبيل المثال، الأمر الخاص بـ Claude Code هو:

```bash theme={null}
claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"
```

### الاستخدام

بمجرد الاتصال، اطلب من عميل الذكاء الاصطناعي ما تريد بكلمات بسيطة. على سبيل المثال:

| ما تطلبه | ما يستخدمه عميل الذكاء الاصطناعي |
| - | - |
| *أصلح الأخطاء الإملائية في المقدمة.* | `read_file` و `edit_file`: تظهر التعديلات مباشرةً في المحرر |
| *ترجم المشروع وأصلح أخطاء LaTeX.* | `compile` و `get_compile_log` و `edit_file` |
| *أجب عن التعليقات المفتوحة، ثم احسمها.* | `list_comments` و `reply_to_comment` و `resolve_comment` |
| *بدّل إلى XeLaTeX ونزّل ملف PDF.* | `update_settings` و `compile` و `get_output_file_link` |

### الأدوات

| المجموعة | الأدوات |
| - | - |
| المشروع | `get_clone_info` و `get_settings` و `update_settings` و `list_versions` |
| الملفات | `list_files` و `read_file` و `edit_file` و `write_file` و `delete_file` |
| الترجمة | `compile` و `get_compile_log` و `get_output_file_link` و `word_count` |
| التعليقات | `list_comments` و `reply_to_comment` و `resolve_comment` و `reopen_comment` |

تظهر التعديلات التي تُجرى باستخدام `edit_file` و `write_file` مباشرةً في المحرر وتُدمج مع تعديلات المتعاونين. وبالنسبة إلى ملفات كثيرة دفعة واحدة، أو الملفات الثنائية، أو عمليات إعادة التسمية، يمكن لعميل الذكاء الاصطناعي أيضًا استنساخ المشروع باستخدام Git ثم الدفع (push).

### الصلاحيات

يتبع خادم MCP إعدادات مشاركة المشروع، تمامًا مثل Git:

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

### أسئلة وأجوبة

> [accordion] لا أرى Integrations أو MCP server في المحرر
>
> **الإجابة:** لا يملك خادم MCP متغير بيئة خاصًا به. يُفعَّل عبر `GIT_BRIDGE_ENABLED=true` في `config/overleaf.rc`، راجع [التكامل مع Git](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md). بعد تغييره، شغّل `bin/up -d`. بدون git-bridge، لا يعرض المحرر تبويب **Integrations** في شريطه الجانبي الأيسر.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.