خادم 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» في البطاقة. يُفتح المحرر والخادم جاهز للتثبيت، فأكّد هناك

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

كل مجلدات التصدير، أينما كانت، وكل منها باسم مجلده، مثل notes أو messages. ويُميَّز بين مجلدين بالاسم نفسه باسم المجلد الأب لكل منهما، مثل export (Bear). يقرأ الخادم قائمة مجلداته حين يبدأ، لذا اضغط «إيقاف» ثم «تشغيل» بعد أي تغيير.

الأدوات الست

الأداة	ما تفعله	المعاملات
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 والتذكيرات والمستندات، بجوارها، وتتناوب القائمتان في النتائج. وما دام الفهرس فارغًا، يفحص search ملفات Markdown في كل المصادر.

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

الخصوصية

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

حين لا يعمل

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