دليل شامل لتصحيح أخطاء تكامل Model Context Protocol (MCP)#
يعد تصحيح الأخطاء الفعال أمرًا ضروريًا عند تطوير خوادم MCP أو دمجها مع التطبيقات. يغطي هذا الدليل أدوات وأساليب تصحيح الأخطاء المتاحة في نظام MCP البيئي.هذا الدليل مخصص لنظام macOS. الأدلة الخاصة بالأنظمة الأساسية الأخرى قادمة قريبًا.يوفر MCP العديد من الأدوات لتصحيح الأخطاء على مستويات مختلفة:1.
واجهة تصحيح أخطاء تفاعلية
2.
Claude Desktop Developer Tools 1.
انقر فوق رمز 
لعرض:المطالبات والموارد المتاحة
2.
انقر فوق رمز 
لعرض: 1.
قم بإنشاء ملف developer_settings.json مع تعيين allowDevTools على true:
2.
افتح DevTools: Command-Option-Shift-i
قد يكون دليل العمل للخوادم التي تم إطلاقها عبر claude_desktop_config.json غير محدد (مثل / على macOS) نظرًا لأنه يمكن بدء Claude Desktop من أي مكان
ا ستخدم دائمًا مسارات مطلقة في ملفات التكوين و .env لضمان التشغيل الموثوق به
لاختبار الخوادم مباشرةً عبر سطر الأوامر، سيكون دليل العمل هو المكان الذي تقوم فيه بتشغيل الأمر
claude_desktop_config.json، استخدم:{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/data"]
}
./dataترث خوادم MCP فقط مجموعة فرعية من متغيرات البيئة تلقائيًا، مثل USER و HOME و PATH.لتجاوز المتغيرات الافتراضية أو توفير المتغيرات الخاصة بك، يمكنك تحديد مفتاح env في claude_desktop_config.json:{
"myserver": {
"command": "mcp-server-myapp",
"env": {
"MYAPP_API_KEY": "some_key",
}
}
}
1.
مسار الملف التنفيذي للخادم غير صحيح
حاول استخدام مسار مطلق لـ command
1.
تحقق من سجلات Claude Desktop
2.
تحقق من تشغيل عملية الخادم
2.
الاختبار في Claude Desktop
تغييرات التكوين: أعد تشغيل Claude Desktop
تغييرات كود الخادم: استخدم Command-R لإعادة التحميل
التكرار السريع: استخدم Inspector أثناء التطوير Modified at 2025-03-12 10:33:38
