الانتقال إلى المحتوى الرئيسي

خادم MCP لا يبدأ (stdio)

أعد تشغيل خادم MCP بعد كل تغيير في الإعداد.

قائمة الأدوات فارغة

  • تأكد أن حالة الخادم connected (أخضر) في إعدادات Cursor MCP
  • تحقق من KARZOUN_MCP_TOOL_PREFIX — قد تستبعد بادئة ضيقة جدًا جميع الأدوات
  • حدّث الحزمة: npx -y @karzounchat/mcp-server@latest

الأداة تعيد خطأ صلاحية

  • قد لا تشمل نطاقات المفتاح العملية — عدّله من المطوّر ← مفاتيح API
  • انتهت صلاحية المفتاح أو أُلغي — أنشئ مفتاح API جديداً
  • اختبر نفس العملية في ساحة التجربة

الاستجابة تتجاوز حد الحجم

  • قلّل perPage
  • أضف searchValue أو عوامل تصفية
  • ارفع الحد فقط عند الحاجة: KARZOUN_MCP_MAX_RESPONSE_BYTES=1048576

أخطاء /mcp المستضاف

راجع MCP المستضاف للمصافحة الكاملة.

الوكيل يتجاهل أدوات كرزون

  • اطلب صراحة: “Use Karzoun MCP tools to …”
  • أضف أنماط الوكلاء إلى قواعد المشروع
  • تحقق من ظهور الأدوات في قائمة أدوات MCP في Cursor للجلسة

ما زلت عالقًا؟

  1. تحقق من صحة الخدمة إن كان العطل عاماً (بوابة GraphQL أو MCP المستضاف)
  2. تحقق من GraphQL بـ curl (البداية السريعة)
  3. قارن اسم الأداة في الكتالوج بما استدعاه الوكيل
  4. تواصل مع الدعم بمعرّف المفتاح (وليس المفتاح الخام)، واسم الأداة، ورسالة الخطأ بعد التنقيح
آخر تعديل في ١١ أغسطس ٢٠٢٦