الانتقال إلى المحتوى الرئيسي
استخدم هذه الصفحة عندما يكون تطبيق الذكاء الاصطناعي على الإنترنت لا على جهازك. عنوانك هو:
customer-support هي حزمة الأدوات. احذفها، أو استبدلها بحزمة أخرى من نظرة MCP، عندما تريد قائمة مختلفة. Claude.ai وChatGPT يسجّلان دخولك. الصق العنوان وانتقل إلى القسم أدناه. لا تلصق مفتاح API. Manus وCursor عن بُعد وClaude Code وخادمك يستطيعون ضبط ترويسة. أرسل Authorization: Bearer kz_live_… مع مفتاح API. لا تضع ذلك المفتاح في إضافة متصفح أو محادثة مشتركة. المطوّر ← إعداد MCP (/developer/mcp-setup) يعبّئ العنوان لحسابك. بعد الاتصال، جرّب:
  • “اعرض أحدث 10 عملاء ولخّص وسومهم.”
  • “جد المحادثات المفتوحة التي تحتاج رداً.”
  • “ابحث في قاعدة المعرفة عن سياسة الإرجاع واكتب رداً قصيراً.”
  • “اعرض قوالب واتساب المعتمدة لحسابي.”
  • “جد المحادثة مع alice@example.com ولخّص آخر 5 رسائل.”
اطلب من النموذج أن يقرأ قبل أن يعدّل شيئاً. المزيد من الأوامر: أنماط الوكلاء. أسماء العمليات في كتالوج الأدوات.

Claude.ai

يدعم Claude على الويب موصّلات MCP عن بُعد مخصصة (Settings → Connectors → Add custom connector).
1

أضف الموصّل

  1. افتح Claude Connectors (أو Admin → Connectors على Team/Enterprise).
  2. انقر Add custom connector.
  3. Server URL: https://YOUR_SUBDOMAIN.api.karzoun.chat/mcp/customer-support
  4. يكتشف Claude خادم التفويض في كرزون. سجّل الدخول بحساب كرزون ووافق على النطاقات. لا تلصق مفتاح API في هذا الموصّل.
2

فعّل في المحادثة

استخدم قائمة + في محادثة → Connectors → فعّل كرزون لتلك المحادثة.اختبر: “Using Karzoun tools, run currentUser and list my first 5 tags.”
Claude Desktop للبرمجة المحلية ما زال الأفضل مع stdio. الموصّلات عن بُعد في Claude.ai لجلسات السحابة — لا تضف عنوان HTTPS إلى claude_desktop_config.json؛ استخدم واجهة Connectors بدلًا من ذلك.

Manus

يدعم Manus خوادم MCP مخصصة عبر HTTP — ملاءمة قوية لكرزون المستضاف لأنك تستطيع الإشارة إلى عنوان /mcp عام وتزويد بيانات الاعتماد.
1

افتح Custom MCP

Settings → Integrations → Custom MCP (أو + Add custom MCP → Direct configuration).
2

أدخل تفاصيل الخادم

إذا كان Manus يرسل Authorization: Bearer من حقل مفتاح واحد، الصق مفتاح API الخاص بكرزون. بلا وكيل وسيط.
3

اختبر واستخدم

يتحقق Manus من الخادم ويعرض الأدوات المكتشفة. اذكر كرزون في الأوامر:“Pull my top 10 customers by last updated date and create a Manus doc summarizing their tags.”المرجع الرسمي: وثائق Manus custom MCP.

ChatGPT Apps والموصّلات

تدعم OpenAI MCP عن بُعد عبر Apps / Connectors (وضع المطوّر في إعدادات ChatGPT). يتصل ChatGPT من سحابة OpenAI — stdio المحلي لا يعمل.
1

فعّل وصول المطوّر

في ChatGPT: Settings → Apps & Connectors (أو Connectors → Advanced) → فعّل Developer mode إن كان متاحًا في خطتك.
2

أضف عنوان MCP

أنشئ تطبيقًا/موصّلًا جديدًا والصق:
راجع الأدوات المكتشفة قبل تفعيل التطبيق في المحادثات.
موصّلات ChatGPT تسجّل الدخول عبر OAuth. الصق رابط MCP، ثم سجّل الدخول إلى كرزون ووافق على النطاقات. لا تلصق مفتاح API في هذا المسار.العملاء الذين يعتمدون الترويسات (Manus، Cursor عن بُعد، Claude Code، أو خلفيتك) يرسلون Authorization: Bearer kz_live_… بدل ذلك.

Cursor (عن بُعد)

للفرق التي تفضّل عدم تشغيل npx محليًا، يدعم Cursor MCP عن بُعد عبر url + headers في mcp.json.
صدّر KARZOUN_API_KEY في ملف تعريف الصدفة (تطبيقات سطح المكتب قد لا تحمّل .zshrc — استخدم بيئة النظام أو أنماط الأسرار المدعومة في Cursor). يجب أن يظهر إعدادات Cursor ← MCP بحالة connected مع نحو 75 أداة. فضّل stdio المحلي للتطوير دون اتصال؛ واستخدم المستضاف عندما يكون npx محظورًا أو تريد نقطة نهاية مشتركة واحدة. الوثائق: Cursor MCP — remote servers.

Claude Code

يمكن لـ Claude Code تسجيل خوادم MCP عبر HTTP من سطر الأوامر:
استخدم .mcp.json للمشروع للوصول على مستوى المستودع. ألغِ المفتاح من المطوّر ← مفاتيح API إذا شارك إعداد CLI.

ابنِ وكيلك الخاص

أي مكدس يتحدث Streamable HTTP MCP يمكنه استدعاء كرزون: المضيفات النموذجية: LangGraph، عمال Node/Python مخصصون، أتمتة بأسلوب Zapier، بوتات Slack داخلية.
  1. POST initialize
  2. POST tools/list → اكتشف العمليات
  3. POST tools/call → نفّذ بحجج بشكل GraphQL
MCP المستضاف لا يطلب mcp-session-id بين هذه الطلبات. أمثلة وcurl: MCP المستضاف. تصميم الأوامر: أنماط الوكلاء.

ضيّق نطاق الرموز لوكلاء أكثر أمانًا

قبل ربط عميل قوي: ابدأ بمفتاح للقراءة فقط، تحقّق من الأوامر، ثم أصدر مفتاحاً أوسع عند الحاجة.

استكشاف أخطاء الموصّلات

المزيد: استكشاف الأخطاء.

الخطوات التالية

آخر تعديل في ١١ أغسطس ٢٠٢٦