خادم MCP لا يبدأ (stdio)
أعد تشغيل خادم MCP بعد كل تغيير في الإعداد.
قائمة الأدوات فارغة
- تأكد أن حالة الخادم connected (أخضر) في إعدادات Cursor MCP
- تحقق من
KARZOUN_MCP_TOOL_PREFIX— قد تستبعد بادئة ضيقة جدًا جميع الأدوات - حدّث الحزمة:
npx -y @karzounchat/mcp-server@latest
الأداة تعيد خطأ صلاحية
- قد لا تتضمن مجموعة مستخدمي التطبيق العملية — عدّل النطاقات في المطوّر ← التطبيقات
- انتهت صلاحية الرمز أو أُلغي — أنشئ رمز تطبيق جديد
- اختبر نفس العملية في ساحة التجربة
الاستجابة تتجاوز حد الحجم
- قلّل
perPage - أضف
searchValueأو عوامل تصفية - ارفع الحد فقط عند الحاجة:
KARZOUN_MCP_MAX_RESPONSE_BYTES=1048576
أخطاء /mcp المستضاف
راجع MCP المستضاف للمصافحة الكاملة.
الوكيل يتجاهل أدوات كرزون
- اطلب صراحة: “Use Karzoun MCP tools to …”
- أضف أنماط الوكلاء إلى قواعد المشروع
- تحقق من ظهور الأدوات في قائمة أدوات MCP في Cursor للجلسة
ما زلت عالقًا؟
- تحقق من GraphQL بـ curl (البداية السريعة)
- قارن اسم الأداة في الكتالوج بما استدعاه الوكيل
- تواصل مع الدعم بمعرّف التطبيق (وليس الرمز الخام)، واسم الأداة، ورسالة الخطأ بعد التنقيح