خادم MCP

ما هو خادم MCP الخاص بـ SocialGO؟

يكشف خادم MCP الخاص بـ SocialGO اللوحة كمجموعة من الأدوات لوكلاء الذكاء الاصطناعي عبر Model Context Protocol. بمجرد الاتصال، يمكن للمساعد تصفّح كتالوج الخدمات وإنشاء الطلبات وتتبعها وطلب إعادة التعبئة وإدارة الرصيد. دون أي كود ربط مخصص. إنه طبقة رفيعة للقراءة والتنفيذ فوق نفس الـ API التي تستخدمها لوحة التحكم لديك، لذا يبقى الوكلاء ضمن حدود وأسعار حسابك.

يعمل مع أي عميل يدعم MCP، بما في ذلك Claude Desktop وClaude Code وCursor والوكلاء الخاصون بك المبنيون على MCP SDK.

أضِفه إلى عميلك

يأتي الخادم كحزمة @socialgo/mcp ويعمل عبر stdio من خلال npx، لذا لا حاجة لتثبيت أو استضافة ذاتية. أضِف الإدخال التالي إلى إعدادات عميل MCP لديك:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

مع Claude Code يمكنك تسجيله بأمر واحد من طرفيتك:

claude mcp add socialgo -- npx @socialgo/mcp

بعد إضافته، تذكّر ضبط SOCIALGO_API_KEY في البيئة حتى يتمكن الأمر أعلاه من التقاطه.

المصادقة

يقرأ الخادم متغير بيئة واحدًا، SOCIALGO_API_KEY. أنشئ مفتاحًا من إعدادات حسابك، وأبقِه سريًا ولا تُدرجه أبدًا في نظام التحكم بالمصدر. تتم مصادقة كل استدعاء أداة وتفويضه بهذا المفتاح، وتُحتسَب الطلبات على رصيد الحساب المطابق. دوِّر المفتاح من لوحة التحكم في أي وقت لإلغاء الوصول.

الأدوات الأساسية

يحافظ الخادم على مجموعة صغيرة ومستقرة من الأدوات تغطي دورة حياة الطلب الكاملة:

• search_services — ابحث عن الخدمات حسب المنصة أو النوع أو الكلمة المفتاحية. نقطة الدخول لكل سير عمل.
• get_service — اجلب التفاصيل الكاملة لخدمة واحدة: السعر، والكمية الدنيا/القصوى، والخيارات المدعومة.
• create_order — أنشئ طلبًا لخدمة مقابل رابط أو اسم مستخدم مستهدف.
• order_status — تحقق من الحالة المباشرة والتقدّم والكمية المتبقية لطلب.
• balance — اقرأ رصيد الحساب الحالي والعملة.
• refill — اطلب إعادة تعبئة لطلب مؤهل انخفض دون كميته المُسلَّمة.
• cancel — ألغِ طلبًا ما زال قابلًا للإلغاء واسترجع الأموال المتبقية.
• list_orders — تصفّح الطلبات الأخيرة صفحة بصفحة مع حالتها الحالية.
• add_funds — أنشئ نية شحن لإضافة رصيد إلى الحساب.

تصميم "ابحث ثم نفّذ"

تحمل لوحة SMM النموذجية آلاف الخدمات عبر عشرات المنصات. تسجيل أداة واحدة لكل خدمة سيُغرِق قائمة أدوات الوكيل، ويُفجِّر نافذة السياق، ويجعل النموذج أبطأ وأقل دقة. يتجنّب SocialGO ذلك تمامًا.

بدلًا من ذلك، يعيش الكتالوج خلف أداة اكتشاف واحدة. يستدعي الوكيل أولًا search_services لتضييق آلاف الخيارات إلى حفنة من النتائج ذات الصلة، ويفحص واحدة منها بـ get_service، وبعد ذلك فقط ينفّذ باستخدام create_order. تغطي نفس الأدوات التسع الكتالوج بأكمله مهما نما حجمه. فإضافة خدمات جديدة في الخلفية لا تغيّر أبدًا مجموعة الأدوات التي يراها الوكيل.

يبدو التدفق الكامل هكذا:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

يحافظ هذا على قائمة أدوات صغيرة ويمكن التنبؤ بها، ويتيح للكتالوج التوسّع إلى آلاف الخدمات، ويمنح الوكيل خطوة تأكيد موثوقة قبل الإنفاق في كل مرة.