الفصل بيستخدم Claude Desktop كمثال، والمفاهيم تنطبق على أي كلاينت بيدعم البروتوكول. في الآخر التطبيق يقدر يتعامل مع ملفاتك، وكل أكشن بموافقتك الصريحة.
المتطلبات
Claude Desktop متاح لـ macOS و Windows. اتأكد إن النسخة آخر إصدار من قائمة Check for Updates. سيرفر الملفات محتاج Node.js. اتأكد بـ node —version، ولو مش موجود نزّل نسخة LTS من الموقع الرسمي.
السيرفر بيعمل إيه؟
سيرفرات لوكال برامج على جهازك بتدي قدرات للتطبيق. سيرفر الملفات بيقرأ الملفات وهيكل الفولدرات، وينشئ، وينقل، ويعيد تسمية، ويبحث بالاسم أو المحتوى. كل أكشن محتاج موافقة قبل التنفيذ.
الإعداد
الفكرة: ملف JSON يقول للتطبيق يشغّل أنهي سيرفرات وإزاي، كل ما تفتحه.
١. افتح Settings من قائمة Claude في شريط النظام، مش إعدادات الحساب جوه النافذة. ٢. من Developer اضغط Edit Config. الملف:
- على macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- على Windows: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop", "/Users/username/Downloads" ] } }}filesystem اسم ودود بيظهر في التطبيق. npx يشغّل الباكدج، و -y يوافق على التثبيت. باقي الحجج الفولدرات المسموح يوصلها. غيّر المسارات لمساراتك، وخليها مطلقة مش نسبية. على ويندوز اكتب المسار بشرطات مائلة مزدوجة.
٣. اقفل التطبيق خالص وافتحه تاني عشان يقرا الإعداد. بعدين من قائمة الإضافة اختار السيرفر وتشوف أدواته.
جرّب
«اكتب قصيدة واحفظها على الديسكتوب». «إيه ملفات الشغل في التحميلات؟». «نظم الصور في فولدر اسمه Images». راجع كل طلب موافقة، وتقدر ترفض دايمًا.
لو السيرفر مش ظاهر
اعمل إعادة تشغيل كاملة، راجع صياغة الملف، اتأكد المسارات مطلقة، وبص في اللوجات. تشغّله بإيدك من التيرمنال عشان تشوف الخطأ. اللوجات العامة في mcp.log، و stderr بتاع السيرفر في mcp-server-SERVERNAME.log. على ماك المسار تحت ~/Library/Logs/Claude، وعلى ويندوز تحت %APPDATA%\Claude\logs.
سيرفرات stdio ممكن تحط كل لوجاتها في stderr، فمش كل سطر هناك خطأ. لو النداء بيفشل بصمت: شوف اللوج، اتأكد السيرفر يبني ويشتغل، واعمل إعادة تشغيل. لو ولا حاجة نافعة، فصل التصحيح.
على ويندوز، لو المسار محتاج قيمة %APPDATA% المفرودة، حطها في env جوه إعداد السيرفر. ولو npx لسه بيفشل، ممكن npm مش متثبت بشكل عام. راجع الدوكس قبل ما تعتمد على أمر التثبيت.