الانتقال إلى المحتوى الرئيسي
يرث وكلاء MCP نطاقات مفتاح API أو منحة OAuth بالضبط، ولا يتجاوزون صلاحيات الشخص أو الحساب خلفها. عامل MCP كوصول إنتاجي للواجهة البرمجية، وليس بيئة معزولة.

نظافة الرموز

يُعرض سر المطوّر ← مفاتيح API مرة واحدة — نفس قواعد المصادقة.

Stdio (بيئة التطوير المحلية)

  • تعيش الرموز في ~/.cursor/mcp.json أو إعداد Claude Desktop على جهازك
  • أي شخص يصل إلى جهازك يمكنه قراءتها — استخدم تشفير القرص الكامل ورموز تطوير منفصلة
  • فضّل مفتاح قراءة فقط مخصصاً أثناء الاستكشاف

المستضاف (/mcp)

  • استدعِ فقط من خوادم موثوقة تتحكم بها
  • أنهِ TLS عند الحافة؛ لا تخفّض إلى HTTP أبدًا
  • مرّر Authorization: Bearer من جهة الخادم؛ لا ترسل المفتاح إلى المتصفحات أو تطبيقات الجوال أبدًا
  • معرّفات الجلسة (mcp-session-id) ليست أسرارًا، لكنها تربط النشاط بخادمك — لا تنشرها

تحديد نطاق الصلاحيات

قبل منح الوكيل أدوات الكتابة (customersAdd، tagsRemove، …):
  1. أنشئ مفتاحاً محدوداً بالنطاقات المطلوبة (وبمجموعة مستخدمين لمفتاح الحساب)
  2. اختبر التعديلات في ساحة التجربة
  3. اختياريًا عيّن KARZOUN_MCP_TOOL_PREFIX لبادئات القراءة فقط أثناء التطوير

سلامة الوكيل

قد تستدعي نماذج اللغة الكبيرة التعديلات بشكل غير متوقع. التخفيفات:
  • أوامر نظام تتطلب تأكيدًا قبل الحذف/الدمج (أنماط الوكلاء)
  • رموز للقراءة فقط لوكلاء التحليلات
  • راجع استخدام التطبيق عبر سجلات كرزون حيث تتوفر

مقارنة مع التكاملات الأخرى

الاستجابة للحوادث

إذا تسرّب رمز:
  1. ألغِ المفتاح من المطوّر ← مفاتيح API
  2. أنشئ مفتاحاً جديداً وحدّث إعداد MCP أو أسرار الخادم
  3. راجع نشاط GraphQL الأخير إذا كانت أدوات التدقيق مفعّلة

ذات صلة

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