خادم MCP

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

شغّله

1. صدّر تطبيقًا واحدًا على الأقل بصيغة Markdown (البدء). لا يقرأ الخادم إلا ملفات Markdown.
2. في بطاقة خادم MCP، اضغط «تشغيل». تعرض البطاقة بعدها localhost:8744 وصف «توصيل».

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

ربط Claude Code

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 فقط، أو ظهر بعد بدء الخادم، أو تجاوز الحصة المجانية