الموارد · SoCode

تشغيل SocialHub من Claude Code

SoCode هو تكامل SocialHub مع Claude Code (وClaude Desktop / Cursor): مهارة قابلة للتنزيل بالإضافة إلى خادم MCP مُدار. استخدم SocialHub - واسأل عن بياناتك - بلغة بسيطة.

ابدأ الآن لماذا SoCode؟

كلود · سوشيال هب (MCP)

› اسأل بلغة بسيطة

you › إجمالي قيمة المبيعات الأسبوع الماضي حسب المتجر، أفضل 3 متاجر▋

مقياس مُدار · حجم مبيعات السوق · حسب المتجر · last_7d

المتجر 042$128,400

المتجر 017$96,250

المتجر 233$81,900

من الطبقة الدلالية · بدون SQL · مُدقَّق · توضيحي

01 — نظرة عامة

ما هو SoCode؟

SoCode هو الرابط الذي يربط SocialHub بمساعدك الذكي. إنه جزآن يعملان معًا - بحيث يمكن لـ Claude تشغيل SocialHub، بينما يجيب و على أسئلة حول بياناتك، بلغة بسيطة، دون الحاجة إلى مغادرة محرر النصوص.

المهارة

`flash-operations`

مهارة قابلة للتنزيل Claude تُعلّم Claude كيفية استخدام SocialHub بأمان - أي أداة يجب استخدامها، وتأكيد عمليات الكتابة عن طريق اسم العضو/البريد الإلكتروني، والاقتباس فقط من أرقام المقاييس المُدارة.

الخادم

خادم MCP مُدار

نقطة نهاية بروتوكول سياق النموذج (Model Context Protocol) التي تعرض أدوات SocialHub - برامج الولاء، والأعضاء، والقسائم، والحملات، ومقاييسك المُدارة - يتم التحقق من صحتها بواسطة مفتاح المستأجر API، ويتم منح التفويض لكل أداة.

02 - لماذا هو مهم؟

لماذا SoCode؟

بياناتك وعملياتك، يُمكن الوصول إليها من أدوات الذكاء الاصطناعي التي يستخدمها فريقك بالفعل - دون التنازل عن الحوكمة.

لغة طبيعية، بدون لوحات تحكم

اسأل بلغة بسيطة وواضحة؛ Claude يختار الأداة المُدارة المناسبة ويُشغّلها. لا حاجة للتنقل بين الشاشات، ولا لكتابة استعلامات SQL.

مُحكم وآمن بالتصميم

تستمد الأرقام القياسية من الطبقة الدلالية لـ SocialHub (لا يقوم الذكاء الاصطناعي بابتكار الأرقام). تتطلب عمليات الكتابة نطاقًا للكتابة وتجتاز حماية من جانب الخادم. كل مفتاح مُحدد النطاق لفريقك؛ ويتم تدقيق كل استدعاء.

يعمل في بيئة عملك الحالية

Claude Code، Claude Desktop، Cursor — أي عميل MCP. اتصل مرة واحدة بأمر واحد، وقم بتشغيل SocialHub دون الحاجة إلى مغادرة مساعدك.

بدء وضع القراءة فقط

ابدأ بالإعداد المسبق metrics:read (الأكثر أمانًا للذكاء الاصطناعي). أضف نطاقات الكتابة فقط عند الحاجة إلى منح نقاط أو إصدار قسائم - أنت تتحكم بالكامل.

ما لم يكن ممكنًا قبل SoCode

كان كلٌّ من هذه يتطلب محللًا أو مهندسًا أو لوحة تحكم غير متوفرة لديك، لذا نادرًا ما كان الشخص الذي يطرح السؤال يحصل على الإجابة في الوقت المناسب. إنّ وجود وكيل مُدار من قِبل داخل أداة الذكاء الاصطناعي الخاصة بك هو ما يُتيح ذلك: إجابات وإجراءات على مستوى الأعمال، خدمة ذاتية، دون التخلي عن السيطرة على بياناتك. هذا هو الحل الأمثل - ليس مجرد لوحة تحكم أسرع أو نموذج تشغيل مختلف.

★ مسؤول تسويق الاحتفاظ بالعملاء · الحلقة الأساسية

"ابحث عن الأعضاء المُعرضين لخطر التخلي عن الخدمة، وأطلق حملة لاستعادة العملاء، واستمر في تحسينها بما يتماشى مع هدفي." ابحث عن الأعضاء الذين يتجهون نحو إلغاء الاشتراك، وأطلق حملة لاستعادة العملاء، واستمر في ضبطها لتحقيق هدفي.

قبلثلاثة فرق وثلاث أدوات على مدار أسابيع: محلل يستخرج البيانات، مسوق يبني الحملة، شخص ما يتحقق من النتائج الشهر المقبل - بحلول ذلك الوقت يكون الوقت قد فات ولا تكتمل الحلقة فعليًا.

مع SoCodeحلقة واحدة تعمل على تحليل ← تنفيذ ← تحسين: تقرأ المقاييس المُدارة، وتُطلق المسار الذي تُقره، وتقيس التحسن، وتُعيد الضبط باستمرار، وفقًا للأهداف والضوابط التي تحددها.

مسؤول النمو/التحليلات

"إجمالي قيمة المبيعات الأسبوع الماضي حسب المتجر - ولماذا انخفضت عمليات الاسترداد هذا الشهر؟"

قبلقدّم طلبًا وانتظر محللًا، أو اجمع البيانات من لوحات المعلومات المختلفة - ستصلك الإجابة بعد اتخاذ القرار.

مع SoCodeإجابة موثوقة ومُحكمة في ثوانٍ - يُبنى القرار على البيانات، لا على الحدس.

مهندس الذكاء الاصطناعي/التعلم الآلي

اعرض مقاييس SocialHub المُدارة لمساعدك الشخصي أو لسير عمل Cursor عبر MCP.

قبلتكامل مخصص، واستعلامات مكتوبة يدويًا، ونظام حوكمة مُعاد تنفيذه من الصفر - شهور من العمل، ومكان جديد لتغير الأرقام.

مع SoCodeباستخدام مفتاح نطاق واحد، يمكن استدعاء الطبقة المُدارة من نظامك. التكامل الذي كان مشروعًا سابقًا أصبح سطرًا في ملف الإعدادات.

مدير التسويق

"هل انخفض عدد الأعضاء النشطين مقارنةً بالشهر الماضي؟ حلل ذلك حسب الفئة."

قبلستلاحظ ذلك في المراجعة الشهرية - بعد فوات الأوان.

مع SoCodeتشخيص ذاتي متعدد الخطوات في اللحظة التي تشك فيها — اكتشف الثغرة بينما لا يزال بإمكانك اتخاذ إجراء بشأنها.

03 — الإعداد في 3 خطوات

كيف يعمل SoCode

ثلاث خطوات: تنزيل المهارة، تثبيت الخادم MCP، واستخدام باللغة الطبيعية.

1. حمّل SoCode (المهارة)

تُعلّم مهارة SoCode (flash-operations) المستخدم Claude كيفية استخدام SocialHub بأمان. وهي تتصل بخادم SocialHub MCP الذي ستضيفه في الخطوة 2.

احصل على مجلد المهارات

# Pull just the SoCode skill into Claude Code
npx degit huangchunbo2025/flash/skills/flash-operations \
  ~/.claude/skills/flash-operations

أو تصفحه/نزّله من GitHub → skills/flash-operations. انسخ المجلد إلى ~/.claude/skills/ (الشخصي) أو إلى .claude/skills/ الخاص بمشروعك.

المهارة اختيارية ولكن يُنصح بها - يعمل خادم MCP بدونها؛ مهارة SoCode تُحسِّن استخدام Claude لها.

2. تثبيت خادم MCP

أ) إنشاء مفتاح API

في SocialHub، انتقل إلى الإعدادات ← APIالمفاتيح ← إنشاء مفتاح واختر الإعداد المسبق "للقراءة فقط" (يتضمن metrics:read - وهو الأكثر أمانًا للاستخدام مع الذكاء الاصطناعي؛ أضف نطاقات الكتابة فقط عند الحاجة إلى منح نقاط أو إصدار قسائم). يظهر المفتاح مرة واحدة - انسخه.

انتقل إلى API المفاتيح

ب) إضافة الخادم إلى Claude Code

قم بتصدير المفتاح كمتغير بيئي أولًا، حتى لا يتم تضمين المفتاح كنص عادي في سجل الأوامر أو ملف الإعدادات.

export FLASH_API_KEY="fl_live_your_key_here"

claude mcp add --transport http flash \
  https://flash.socialhub.ai/api/mcp \
  --header "Authorization: Bearer ${FLASH_API_KEY}"

هل تفضل إعدادات معينة؟ أضف ملف .mcp.json خاصًا بالمشروع في جذر مستودعك — استخدم متغير البيئة كمرجع، ولا تلصق مفتاحًا نصيًا عاديًا أبدًا:

{
  "mcpServers": {
    "flash": {
      "type": "http",
      "url": "https://flash.socialhub.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FLASH_API_KEY}"
      }
    }
  }
}

ج) التحقق

تشغيل claude mcp list — يجب أن يظهر flash متصلاً.
اطلب من Claude أن "list available SocialHub tools" — سترى فقط الأدوات التي تسمح بها نطاقات مفتاحك.
يجب أن يكون اسم الخادم flash بالضبط، ويجب تصدير FLASH_API_KEY في واجهة سطر الأوامر التي تُشغّل Claude Code. يظهر المفتاح غير الصالح على أنه فشل في الاتصال.

3. الاستخدام

ما عليك سوى سؤال Claude بلغة بسيطة. على سبيل المثال:

استعلام عن بياناتك

"أدرج المقاييس التي يمكنني الاستعلام عنها."
"إجمالي قيمة المبيعات الأسبوع الماضي حسب المتجر."
"لماذا انخفضت عمليات الاسترداد هذا الشهر؟"

تشغيل العمليات

"منح 200 نقطة لأليس (alice@…)."
"عرض مجموعات القسائم النشطة." "عرض مجموعات القسائم النشطة."
"أصدر رمز سفير لهذا العضو."

تحكّم في بياناتك

يتم تأكيد عمليات الكتابة قبل التشغيل.
تمنع القيود المفروضة على جانب الخادم عمليات الكتابة ذات الأحجام الكبيرة.
اطلع على جميع المكالمات ضمن API المفاتيح ← آخر MCP النشاط.

آمن بالتصميم. تأتي الأرقام المترية من الطبقة الدلالية المُدارة في SocialHub (لا يكتب الذكاء الاصطناعي أبدًا استعلامات SQL أو يُنشئ أرقامًا). تتطلب عمليات الكتابة نطاق كتابة و، حيث يتم تجاوز حماية من جانب الخادم (حد أقصى لقيمة كل استدعاء + حد أقصى للمعدل) - تأكيد المحادثة هو من باب المجاملة، والخادم هو الحد الفاصل. كل مفتاح مخصص لفريقك فقط.

MCP دليل (مرجع كامل)REST API مرجع إدارة مفاتيح API العودة إلى الموارد