tags تشغّل query tags. customersAdd تشغّل mutation customersAdd. لا توجد واجهة ثانية خلف MCP.
- يختار التطبيق أداة ويمرّر الوسائط. تلك الوسائط هي وسائط GraphQL.
- يبني خادم MCP الاستعلام ويرسله POST إلى عنوان GraphQL مع
Authorization: Bearer. - يُعاد JSON إلى التطبيق كنص.
أظهر للوكيل أدواتاً أقل
الحزمة هي القائمة التي تريدها. اضبطKARZOUN_MCP_PACK محلياً، أو استدعِ /mcp/customer-support عبر HTTP.
KARZOUN_MCP_TOOL_PREFIX يقصّ تلك القائمة أكثر. customers يبقي customers وcustomersAdd وcustomerDetail ويسقط ما عداها. استخدم حزمة أولاً. استخدم البادئة عندما تبقى الحزمة أوسع مما تحتاج.
القراءة والكتابة
الاستعلامات معلَّمة للقراءة فقط. التعديلات معلَّمة للكتابة. هذه علامات للتطبيق. لا تمنع الحذف. نطاقات مفتاح API هي التي تمنعه.عندما يفشل الطلب
تعيد الأداة JSON فيه نصerror. فشل الصلاحية وفشل التحقق والردود الأكبر من 512 كيلوبايت كلها بهذا الشكل. خفّض perPage أو أضف مرشحاً عندما تقول الرسالة إن الرد أكبر من اللازم. انظر ترقيم الصفحات.
MCP لا يبث رسائل الوارد الجديدة. استخدم Webhooks لذلك. وهو لا يثبّت MiniApps.
المحلي والمستضاف
على جهازك تحتفظ عمليةnpx بـ KARZOUN_API_KEY وتستدعي GraphQL بنفسها. MCP المستضاف هو POST https://YOUR_SUBDOMAIN.api.karzoun.chat/mcp. يرسل خادمك Authorization: Bearer في كل طلب، أو يسجّل Claude.ai وChatGPT دخول المستخدم. التفاصيل: MCP عبر HTTP.