# خادم MCP

دع Claude والوكلاء الآخرين يبحثون فيما صدّرته.

يشغّل Exporter خادم MCP داخل التطبيق. يقدّم مجلدات التصدير لديك إلى Claude وCursor وVS Code وأي عميل MCP آخر، للقراءة فقط وعلى جهاز Mac وحده. وللاطلاع على المهارات وسطر الأوامر التي يستطيع الوكيل استخدامها أيضًا، راجع [للوكلاء](https://exporter.dev/agents).

## شغّله

1. صدّر تطبيقًا واحدًا على الأقل بصيغة Markdown ([البدء](https://exporter.dev/docs/getting-started)). لا يقرأ الخادم إلا ملفات Markdown.
2. في بطاقة خادم MCP، اضغط «تشغيل». تعرض البطاقة بعدها `localhost:8744` وصف «توصيل».

نقطة الاتصال هي `http://localhost:8744/mcp` (Streamable HTTP)، على منفذ ثابت. يعيش الخادم داخل التطبيق: يجيب ما دام Exporter يعمل، ونافذته مفتوحة أو مغلقة، ويتوقف حين تُنهي التطبيق. وإذا كان يعمل حين أنهيت التطبيق، فإنه يبدأ من جديد مع التطبيق. ويجيب `curl -s http://127.0.0.1:8744/health` بـ `OK` ما دام يعمل.

## ربط Claude Code

```sh
claude mcp add --transport http exporter http://localhost:8744/mcp
```

أضف `--scope user` ليكون متاحًا في كل مشروع. وزر «claude code» في البطاقة ينسخ هذا الأمر.

## Claude Desktop وCursor وVS Code

- Claude Desktop: اضغط «claude desktop» في البطاقة. ينسخ إدخالًا يشغّل `npx -y mcp-remote http://localhost:8744/mcp` (يأتي `npx` مع Node.js). الصقه داخل `mcpServers` في Settings > Developer > Edit Config، واحفظ، ثم أنهِ Claude وافتحه من جديد
- Cursor أو VS Code: اضغط «cursor» أو «vs code» في البطاقة. يُفتح المحرر والخادم جاهز للتثبيت، فأكّد هناك

## المجلدات التي يقدّمها

مجلدات التصدير التي تقع في المجلد الأب نفسه الذي يقع فيه مجلد تصدير ملاحظات Apple (وإن لم يوجد، فأول مجلد تصدير يجده). ومجلد التصدير الموجود في أي مكان آخر لا يراه الوكلاء، وتقول بطاقة خادم MCP أيّها يستطيعون رؤيته.

| مجلدات التصدير | ما يُقدَّم |
| --- | --- |
| `~/Documents/notes`، `~/Documents/messages` | كلاهما |
| `~/Documents/notes`، `~/Dropbox/messages` | notes فقط |

لإدخال مجلد، اضغط «تغيير...» في صف «التصدير إلى» لذلك التطبيق، واختر مجلدًا في المجلد الأب نفسه، ثم «إعادة مزامنة كاملة» في تلك البطاقة. يقرأ الخادم قائمة مجلداته حين يبدأ، لذا اضغط «إيقاف» ثم «تشغيل» بعد أي تغيير. ويحمل كل مصدر اسم مجلده، مثل `notes` أو `messages`.

## الأدوات الست

| الأداة | ما تفعله | المعاملات |
| --- | --- | --- |
| `get_stats` | لكل مصدر: عدد الملفات، وأحدث التواريخ وأقدمها، والحجم. استدعِها أولًا لمعرفة أسماء المصادر | `source` (اختياري) |
| `search` | بحث نصي كامل مرتّب حسب الصلة | `query`، `source` (اختياري)، `limit` (20) |
| `read` | عنصر واحد: نص Markdown والترويسة وتاريخ التعديل والحجم | `source`، `id` (اسم الملف دون `.md`) |
| `list` | عناصر مصدر واحد | `source`، `limit` (50)، `offset` (0) |
| `get_recent` | العناصر التي تغيّرت مؤخرًا | `sources` (مفصولة بفواصل، اختياري)، `limit` (20) |
| `get_metadata` | الأعداد وأوقات آخر مزامنة | `source` (اختياري) |

يرتّب `search` نتائج ملاحظات Apple وجهات الاتصال والرسائل اعتمادًا على فهرس التطبيق: الاسم يجد المحادثة، ونتيجة الملاحظة تحمل رابطًا يفتحها في ملاحظات Apple. وتُقدَّم Bear وLogseq ومدة استخدام الجهاز والمستندات أيضًا، لكن `search` لا يرتّبها ما دام الفهرس يجيب؛ فاصل إليها بـ `list` و`get_recent` و`read`. وما دام الفهرس فارغًا، يفحص `search` ملفات Markdown في كل المصادر.

الإجابات لا تكون أكمل من التصدير نفسه: في الحصة المجانية يعني ذلك أول 100 ملاحظة، و100 جهة اتصال، وأحدث 10 محادثات، و10 أيام، و10 مستندات.

## الخصوصية

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

## حين لا يعمل

- «لم يتم إعداد أي مجلدات تصدير. حدد مجلد تصدير أولاً.»: اختر مجلد تصدير في أي بطاقة
- «لم يتم العثور على ملاحظات مصدَّرة. شغّل عملية تصدير أولاً.»: اضغط «مزامنة الآن» في بطاقة، ثم «تشغيل»
- خطأ من النظام عند «تشغيل»: برنامج آخر يستخدم المنفذ 8744. أنهِه وشغّل الخادم من جديد
- مصدر مفقود: يقع خارج المجلد الأب، أو صُدِّر بصيغة HTML فقط، أو ظهر بعد بدء الخادم، أو تجاوز الحصة المجانية

## Related

- [For agents](https://exporter.dev/agents): Skills, command line and MCP for agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac
- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code

---

human version: https://exporter.dev/ar/docs/mcp
every page: https://exporter.dev/llms.txt