استخدم خادم MCP

يتيح خادم MCP الخاص بـ Caputchin لوكيل ذكاء اصطناعي (Claude، أو Cursor، أو أي عميل Model Context Protocol) أن يدير حسابك بنداء API الإدارة نفسه الذي تستخدمه لوحة التحكّم. الخادم غلاف نقل ومصادقة رفيع: يكشف أداة MCP واحدة لكل عملية إدارة ويوكّل كل نداء إلى الـ API. فيستطيع الوكيل فعل كل ما تستطيعه، ما عدا الفوترة، بلغة طبيعية.

اسكك رمز وصول

يصادق الخادم برمز وصول من متغيّر البيئة CAPUTCHIN_TOKEN. كلا النوعين يعمل (انظر مصادقة الـ API):

• رمز وصول شخصي للتحكّم بالحساب الكامل، أو
• رمز وصول فريق لحصر الوكيل بفرق بعينها بالامتياز الأدنى، وهو الافتراضي الأأمن عند تسليم الوصول لوكيل مستقلّ.

انسخ الرمز عند الإنشاء؛ يُعرَض مرة واحدة.

طريقتان للاتّصال

هناك ناقلان، ويكشفان الأدوات نفسها مدعومةً بـ API الإدارة نفسه. اختر بحسب كيف يتّصل عميلك:

محلّي: خادم npx‏ (stdio)

يُنشَر الخادم كـ @caputchin/mcp على npm. عادةً لا تشغّله يدويًّا؛ تربطه في إعداد عميل MCP خاصتك فيُولَّد عبر stdio، بالرمز في بيئته:

{
  "mcpServers": {
    "caputchin": {
      "command": "npx",
      "args": ["-y", "@caputchin/mcp"],
      "env": { "CAPUTCHIN_TOKEN": "cpt_pat_..." }
    }
  }
}

للتحقّق من أنه يعمل، أطلقه مباشرةً؛ يتكلّم MCP عبر stdio ويخرج بخطأ إن كان الرمز مفقودًا:

CAPUTCHIN_TOKEN=cpt_pat_... npx -y @caputchin/mcp

مُستضاف: نقطة وصول HTTP

للعملاء الذين يتّصلون بخادم MCP بعيد بدل توليد محلّي، يستضيف Caputchin الخادم نفسه عند:

https://caputchin.com/api/mcp

يصادق برمزك كترويسة Bearer على الاتّصال (الاعتماد نفسه، ممرَّرًا عبر HTTP بدل البيئة فقط):

{
  "mcpServers": {
    "caputchin": {
      "url": "https://caputchin.com/api/mcp",
      "headers": { "Authorization": "Bearer cpt_pat_..." }
    }
  }
}

يعتمد شكل الإعداد الدقيق على عميل MCP خاصتك؛ ما يهمّ هو الرابط وترويسة Authorization: Bearer. لا شيء لتثبيته، ولا عملية محلّية؛ المقايضة أن الرمز يسافر إلى نقطة الوصول المُستضافة لكل طلب بدل البقاء في بيئة عملية محلّية.

الأدوات

كل أداة مسمّاة caputchin_<verb>_<noun> وتقابل عملية إدارة واحدة، مثلًا caputchin_list_troops، وcaputchin_create_site، وcaputchin_rotate_site_secret، وcaputchin_add_troop_member، وcaputchin_site_stats. يكتشف الوكيل المجموعة الكاملة ومعاملات كل أداة تلقائيًّا عبر MCP، فتصف الهدف ويختار الوكيل الأدوات.

مثال مشروح

مع الخادم مربوطًا في عميلك، تستطيع أن تطلب من الوكيل بلغة عادية:

"أنشئ مفتاح موقع اسمه shop-frontend في فريقي shop-team، ثم شغّل بوّابة اللعبة له."

يحلّ الوكيل ذلك إلى سلسلة نداءات أدوات: caputchin_list_troops لإيجاد معرّف الفريق، وcaputchin_create_site بذلك troop_id، ثم caputchin_update_site_security لاشتراط لعبة. كل نداء يصيب API الإدارة تحت رمزك، وعلى Apex يحطّ كلٌّ في سجلّ تدقيقك منسوبًا إلى الرمز، فتكون أفعال الوكيل قابلة للتتبّع كأفعال شخص.

ولأن الوكيل يعمل بكامل امتداد رمزك، آثِر رمز فريق محصورًا متى أمكن، وألغِه لحظة انتهاء المهمّة.

المرجع الكامل

للقائمة الكاملة للأدوات، لكلٍّ وصف بسطر واحد والصلاحية التي يجب أن يحملها رمزها، انظر مرجع أدوات MCP. تعكس الأدوات API الإدارة واحدةً بواحدة، فـمرجع الـ API التفاعلي هو الوصف الموثوق لمعاملات كل عملية واستجابتها: اقرأ وصف MCP لأداة للملخّص المواجِه للوكيل، ومرجع الـ API للمخطّط الدقيق.

انظر أيضًا

• مرجع أدوات MCP: كل أداة، ووصفها، والصلاحية التي تحتاجها.
• أدِر Caputchin من الـ API: API عبر HTTP الذي تناديه كل أداة.
• استخدم Terraform أو OpenTofu: سطح البنية التحتية ككود.
• رمز الوصول الشخصي ورموز الفرق: الاعتمادات التي يستخدمها الخادم.