> ## Documentation Index
> Fetch the complete documentation index at: https://ayrshare.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# إعداد حسابات التواصل الاجتماعي للعملاء

> استخدم خادم MCP لإعداد حسابات التواصل الاجتماعي للعملاء ضمن ملفات فرعية باستخدام رابط ربط JWT.

يمكن للمُدمِجين المشتركين في خطة Business أو Enterprise إعداد حسابات التواصل الاجتماعي لعملائهم ضمن **ملفات فرعية**. باستخدام [خادم MCP](/additional/mcp-action-server)، ينشئ الوكيل ملفًا فرعيًا، ويستهدفه، ثم يُصدر رابط تسجيل دخول أحادي للربط يفتحه العميل لربط حساباته.

## سير العمل

<Steps>
  <Step title="إنشاء ملف فرعي">
    استدعِ `create_profile` (على مستوى الحساب — بدون `profileKey`). يُعيد الاستدعاء **مفتاح ملف شخصي** للملف الفرعي الجديد.
  </Step>

  <Step title="استهداف الملف الفرعي">
    استخدم مفتاح الملف الشخصي المُعاد في الاستدعاءات اللاحقة — إما عبر ترويسة `Profile-Key` على الاتصال أو كوسيط `profileKey` لكل استدعاء. راجع [الاتصال والإعداد](/additional/mcp-action-connect#precedence-argument-wins-over-header) للاطلاع على أولوية الأسبقية.
  </Step>

  <Step title="إصدار رابط ربط حسابات التواصل">
    استدعِ `generate_jwt_social_linking_url` لإصدار رابط تسجيل دخول أحادي للربط. يُشتق مفتاح توقيع JWT ونطاق الإعداد **من جهة الخادم** — لا يُقدم المستدعي **أي** ترويسات `X-Ayrshare-*` ولا أي مفتاح خاص أو نطاق.
  </Step>

  <Step title="يقوم العميل بربط حساباته">
    يفتح العميل الرابط ويُصرّح (OAuth) لحساباته على شبكات التواصل الاجتماعي. تُربط الحسابات المتصلة بالملف الفرعي.
  </Step>
</Steps>

## المتطلبات

<Warning>
  `generate_jwt_social_linking_url` **يتطلب** `profileKey`. إذا لم يُحل أي منها، يُعيد الاستدعاء **400** مع الرسالة **"Profile Key is required…"**.

  يجب **تزويد نطاق ربط حسابات التواصل** لحسابك. هذا متاح ضمن خطتَي **Business** و**Enterprise**.
</Warning>

### حالات الخطأ

| الحالة               | الاستجابة                                                                                                      |
| -------------------- | -------------------------------------------------------------------------------------------------------------- |
| لا يوجد نطاق مُزوَّد | **400** — "No social-linking domain is provisioned for this account (available on Business/Enterprise plans)." |
| لا يوجد مفتاح توقيع  | **400** — "No signing key found for this account's social-linking domain."                                     |

## الخطوات التالية

<CardGroup cols={2}>
  <Card title="الاتصال والإعداد" icon="plug" href="/additional/mcp-action-connect" horizontal>
    المصادقة واستهداف الملف الشخصي.
  </Card>

  <Card title="فهرس الأدوات" icon="list" href="/additional/mcp-action-tools" horizontal>
    الأدوات الـ 27 مُجمَّعة حسب النطاق، مع الغرض والصلاحيات.
  </Card>
</CardGroup>