استخدم Casii MCP في Cherry Studio

المتطلبات المسبقة

1. تثبيت Cherry Studio وتسجيل الدخول إليه.
2. مفتاح API منشأ من لوحة التحكم؛ عنوان MCP مدرج بالفعل في المرجع السريع أدناه.

فتح API Keys

مرجع سريع للاتصال

المرجع السريع يتضمن عنوان MCP الخاص بك بالفعل؛ استبدل YOUR_API_KEY فقط بمفتاحك ثم أدخِله في Cherry Studio.

{
  "mcpServers": {
    "casii": {
      "type": "streamableHttp",
      "url": "https://api.casii.io/mcp/",
      "name": "Casii MCP",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

المفاتيح في لقطات الشاشة مخفية — استخدم مفتاح API الخاص بك عند الإعداد.

خطوات الإعداد

1. 1

   افتح Cherry Studio وانقر أيقونة الترس في الزاوية السفلية اليسرى لفتح «الإعدادات».

   
2. 2

   في الشريط الجانبي للإعدادات، انقر «MCP» ضمن الأدوات، ثم انقر «+ إضافة» في الزاوية العلوية.

   
3. 3

   اختر «إنشاء سريع» من القائمة.

   
4. 4

   الصق عنوان MCP من المرجع السريع أدناه في حقل «URL» (مع الشرطة المائلة في النهاية). وفي حقل «ترويسات الطلب» أدخل Authorization=Bearer مفتاح_API_الخاص_بك (مسافة واحدة بين Bearer والمفتاح)، ثم انقر «حفظ».

   
5. 5

   مرّر للأعلى وتأكد أن الاسم Casii وأن النوع «HTTP قابل للبث (streamableHttp)». فعّل المفتاح في أعلى الصفحة؛ عندما تظهر «متصل» بجانب الاسم ويعرض تبويب الأدوات عددها فالاتصال ناجح.

   
6. 6

   عُد إلى صفحة المحادثة وتأكد أن Casii يظهر «متصل» في قائمة MCP فوق مربع الإدخال.

   
7. 7

   اكتب طلب التصدير بلغة عادية (يمكنك نسخ المثال أدناه). عند أول استدعاء لأداة من Casii تظهر نافذة تأكيد، فانقر «سماح».

   
8. 8

   انتظر حتى ينتهي الذكاء الاصطناعي. سيتضمن الرد عدد السجلات والرصيد المخصوم ورابط تنزيل CSV؛ انقره للتنزيل. للحصول على ملف Excel غيّر format=csv في نهاية الرابط إلى format=xlsx.

   

التحقق من العمل

اطلب التصدير مباشرة في محادثة Cherry Studio، مثلًا:

عند أول استدعاء سيُطلب إذن الأدوات؛ بعدها يتولى الذكاء الاصطناعي الكشف والتسعير والإنشاء تلقائيًا. يجب أن يحمل الإنشاء والإكمال مفتاح idempotency ثابتًا (idempotency_key بصيغة UUID) يُنشأ مرة واحدة: إعادة المحاولة بالمفتاح نفسه والمعاملات نفسها تُعيد المهام الأصلية دون خصم مزدوج؛ تغيير المعاملات فقط يجعلها عملية جديدة بمفتاح جديد.