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

# ربط مساعدك بـ Nushir

> إعداد MCP ورفع الوسائط وتأكيد الطلبات واستكشاف الأخطاء وإصلاحها.

<Note>
  **حالة النشر — 10 أكتوبر 2026.** نُشر إصدار الخادم الذي خضع للمراجعة في بيئة
  الإنتاج. تحقّقت فحوص التهيئة وعرض قائمة الأدوات للقراءة فقط من **42 أداة**
  متطابقة، تشمل **25 أداة مساعدة مسماة للمزوّدين**، باستخدام مفتاح API لمساحة
  العمل في ترويسة Authorization على `/api/mcp` و`/api/mcp-oauth`. لم تستخدم
  هذه الفحوص رموز OAuth Bearer ولم تستدعِ أي أداة. ما زالت مسارات OAuth وربط
  العملاء ونقل الملفات وأداة الرفع المرئية وPrepare/Commit ونشر المحتوى عبر
  المزوّدين واعتماد دليل التكاملات معلّقة. استخدم فقط الميزات التي يعلن عنها
  الخادم والعميل لديك. لا تثبت هذه الصفحة توفّر تكامل مباشر مع ChatGPT، ولا
  تضمن نجاح النشر.
</Note>

يتيح Nushir MCP لمساعدك الاطلاع على مساحة عملك المتصلة وقنواتك وتقويمك،
واستيراد الوسائط التي تختارها، وإعداد مسودات أو منشورات مجدولة لتأكيدها.
تحتاج إلى حساب Nushir ومساحة عمل مؤهلة والأذونات المناسبة فيها. لا يمنح ربط
المساعد وصولًا إلى مساحات عمل أخرى، ولا يضمن قبول منصة التواصل للمنشور.

## اختيار طريقة الربط

| العميل | عنوان الخادم | المصادقة |
| - | - | - |
| عميل يدعم MCP البعيد مع OAuth، بما في ذلك تكامل ChatGPT المقترح | `https://platform.nushir.com/api/mcp-oauth` | سجّل الدخول إلى Nushir ووافق على مساحة العمل والأذونات المعروضة. |
| عميل موثوق يدعم ترويسات طلبات مخصصة ومحفوظة بأمان | `https://platform.nushir.com/api/mcp` | احفظ مفتاح API الخاص بـ Nushir في حقل بيانات الاعتماد أو الترويسات المحمي لدى العميل. |

اختر Streamable HTTP إذا أتاح العميل اختيار وسيلة النقل. استخدم نقطة النهاية
المناسبة لإعداد العميل: وحدها `/api/mcp-oauth` توفّر اكتشاف المورد المحمي
بـ OAuth وتحدي المصادقة. استخدم `/api/mcp` لإعداد ترويسة Bearer المحمية.
تستطيع ترويستا المسارين التعرّف على رمز OAuth أو رمز شخصي صالح؛ لكن هذا
التداخل لا يغني عن اكتشاف OAuth لدى العميل الذي يحتاج إليه. روابط HTTP/SSE
القديمة التي تحتوي على مفتاح في العنوان هي مسارات توافق، وليست الإعداد
الموصى به. لا تضع مفتاح API في عنوان URL. إذا توقف اتصال قديم، انتقل إلى
إحدى الطريقتين أعلاه بدلًا من تفعيل بيانات الاعتماد داخل العناوين.

صيغة ترويسة مفتاح API الخاصة بـ MCP هي:

```text theme={null}
Authorization: Bearer <NUSHIR_API_KEY>
```

صيغة Bearer هذه خاصة بـ MCP؛ تستخدم [واجهة REST العامة](/ar/public-api/authentication)
صيغة المصادقة الخاصة بها.

`<NUSHIR_API_KEY>` عنصر نائب. احصل على مفتاحك الحقيقي من Nushir عبر
**Settings → Developers → Access → API Key** وأدخله فقط في الحقل المحمي
لدى العميل. لا تلصقه في محادثة أو لقطة شاشة أو إعداد مشترك أو تذكرة دعم.
يفوّض مفتاح API العميل بالوصول إلى مساحة العمل؛ أما OAuth فيوفّر اتصالًا
منفصلًا قابلًا للإلغاء ويرتبط بالعضو الذي منحه الإذن. ينبغي للمنتجات التي
تخدم عدة عملاء استخدام موافقة OAuth الخاصة بكل عميل بدلًا من مشاركة مفتاح
المالك.

## الربط باستخدام OAuth

1. افتح إعدادات الاتصال بخادم MCP بعيد لدى العميل وأدخل عنوان خادم OAuth
   أعلاه. استخدم مسار OAuth الخاص به بدلًا من إدخال مفتاح API.
2. عند الانتقال إلى Nushir، سجّل الدخول وراجع التطبيق ومساحة العمل المختارة
   والأذونات المطلوبة. ألغِ العملية إذا كانت غير متوقعة.
3. بعد الموافقة، عد إلى العميل وحدّث قائمة أدواته.
4. اطلب: «اعرض المنطقة الزمنية لمساحة عملي في Nushir وقنواتي المتصلة. لا
   تغيّر شيئًا». تأكد من أن مساحة العمل والقنوات تخصّك.

ينفّذ الخادم المنشور التسجيل الديناميكي للعميل (DCR) وS256 PKCE. إذا كان
العميل يتطلب تطبيق OAuth سريًا ومسجلًا مسبقًا، فستحتاج إلى تطبيق Nushir
المطابق وحقول العميل المحمية؛ لا تختلق معرّف عميل أو سرًا. يجب أن يطابق
عنوان إعادة التوجيه الفعلي لدى العميل عقد عناوين إعادة التوجيه المسجلة أو
المسموح بها في Nushir. خطأ إعادة التوجيه مشكلة إعداد ينبغي فحصها، وليس سببًا
لتعطيل المصادقة.

تطلب مسودة التقديم أذونات قراءة مساحة العمل والقنوات والمنشورات والوسائط
الحالية، وأذونات كتابة المنشورات والوسائط، و`offline_access` لتجديد الوصول
مع تدوير رموز التحديث. تظل الأذونات ودورك الحالي في مساحة العمل مطبّقة على
كل طلب. إنشاء مسودة لا يعني الإذن بجدولتها أو نشرها. لا تعيد منح القراءة
والكتابة الواسعة القديمة الأدوات التي أُزيلت من القائمة.

## الأدوات المتاحة

تقرأ العمليات الأساسية سياق مساحة العمل والقنوات المتصلة ومجموعات القنوات
وإعدادات المزوّد والمنشورات وإيصالات النشر. تستخدم عمليات إنشاء المنشورات
وتحديث إعداداتها مرحلتين منفصلتين: Prepare وCommit. لا توجد عملية MCP لحذف
المنشورات؛ نفّذ الحذف داخل تطبيق Nushir.

تتيح قائمة الأدوات المنشورة أيضًا 25 أداة مساعدة لإعدادات المزوّدين، لكل منها
اسم مستقل. مثلًا، تستخدم `pinterestListBoards` و`redditGetSubredditRequirements`
و`tiktokGetCreatorInfo` قيمة `integrationId` لقناة متصلة والحقول الواردة في
مخطط الأداة المعلن. يجب أن تنتمي القناة المختارة إلى مزوّد الأداة ومساحة
العمل المتصلة لديك. ما زالت إعدادات المزوّد وأذوناته بحاجة إلى التحقق قبل
إعداد المنشور.

بالنسبة إلى TikTok، اقرأ إعدادات المنشئ الحالية باستخدام `tiktokGetCreatorInfo`.
اختر خصوصية Direct Post صراحةً، دون قيمة محددة مسبقًا، من الخيارات التي يسمح
بها المنشئ والتطبيق حاليًا. التزم بقيود التفاعل ومدة الفيديو، وراجع الإفصاحات
التجارية.
يتطلب كل `DIRECT_POST` موافقة صريحة على [إقرار استخدام الموسيقى](https://www.tiktok.com/legal/page/global/music-usage-confirmation/en)
الخاص بـ TikTok. عندما تكون قيمة `brand_content_toggle` هي true، وافق أيضًا على
[سياسة المحتوى المرتبط بالعلامات التجارية](https://www.tiktok.com/legal/page/global/bc-policy/en).
أما `UPLOAD` فيرسل مسودة إلى صندوق الوارد لتكمل نشرها داخل TikTok. أذِن صراحةً
بنقل المحتوى المحدد وبالطريقة المحددة قبل نقله.
لا تضع قيمة افتراضية لـ `posting_consent`، ولا تعِد استخدامها من منشور آخر،
ولا تعتبر ربط حسابك موافقةً على النشر.

أُزيل محدد الأدوات العام القديم `triggerTool`. حدّث القائمة واستخدم الأداة
المعلنة باسمها بدلًا من إرسال `methodName` أو مخطط مختلق. قد تؤدي قراءة
الإعدادات إلى تحديث مصادقة المزوّد أو وضع علامة على قناة منتهية الصلاحية
بأنها تحتاج إلى إعادة الربط؛ لكنها لا تنشئ منشورًا ولا تنشره.

**لا يولّد MCP الخارجي صورًا أو فيديو أو صوتًا.** تُستبعد أدوات التوليد
وخياراته واختيار الأصوات والمحدد العام `videoFunctionTool` وغلاف `ask_nushir`
من جميع الاتصالات الخارجية، بما فيها OAuth ومفتاح API ووسائل النقل القديمة.
يبقى التوليد المهيّأ متاحًا للذكاء الاصطناعي داخل تطبيق Nushir. يظل رفع
الوسائط التي تختارها أو تولّدها في عميل آخر مدعومًا عندما يعلن الخادم عن
وسيلة النقل المناسبة.

## رفع الوسائط

إذا كانت `mediaIngestCapabilitiesTool` معلنة، فاطلبها قبل اختيار طريقة النقل.
أداة الإمكانات وجسر الملفات والجلسات وأداة الرفع المرئية اختيارية؛ غيابها
لا يثبت أن الاستيراد من عنوان URL غير متاح. تظل `uploadFromUrlTool` ضمن
الأدوات الأساسية. اتّبع الأدوات المعلنة فعلًا وأنواع MIME وحدود الحجم
المدعومة.

الحد الأعلى الافتراضي لجسر MCP هو **64 MiB**، ويمكن أن يختلف حسب الإعداد.
قد تكون حدود النوع والجلسة الفعلية أصغر: حد الصور هو **10 MiB**، أو الحد
المهيّأ للجسر إذا كان أقل. تكون قيمة `maxBytes` في جلسة الرفع المعادة هي
الأقل بين حد الجسر المهيّأ وحد نوع الملف. استخدم قيم الإمكانات والجلسة
الحالية؛ وجود حد أكبر في واجهة Nushir أخرى لا يزيد حد MCP.

* تستورد `uploadFromUrlTool` صورة أو فيديو من عنوان HTTPS عام وافقت عليه.
  يجب أن يكون المصدر متاحًا وأن يجتاز فحوص الشبكة ونوع الملف والحجم في
  Nushir. استخدم وسائط تملك إذنًا برفعها؛ صفحة الويب أو مسار الملف المحلي
  ليسا رابط تنزيل للصورة.
* تعمل `uploadMediaFileTool` عندما يوفّر العميل ملفًا مأذونًا به مع رابط
  تنزيل مؤقت. معرّف مرفق خاص بعميل واحد لا يكفي وحده للعمل مع العملاء الآخرين.
* يستطيع العميل المناسب استخدام `createMediaUploadSessionTool` وإرسال
  بايتات الملف في طلب **POST** متعدد الأجزاء إلى `uploadUrl` المعاد، باستخدام
  حقل اسمه `file` وترويسة **Authorization** بقيمة `authorization` المعادة.
  يحتوي العنوان على معرّف جلسة؛ أما قيمة Authorization المنفصلة فهي بيانات
  اعتماد الرفع القصيرة العمر والمخصصة لاستخدام واحد. الرفع باستخدام العنوان
  وحده غير مأذون به. أبقِ بيانات الاعتماد وتفاصيل جلسة الرفع خارج المواد المشتركة.
* في عميل متوافق مع MCP Apps، تستطيع `uploadWidgetTool` فتح أداة Nushir
  المرئية لرفع ملفات الجهاز عندما يعلن الخادم المهيّأ عنها. استخدم
  `uploadWidgetStatusTool` مع معرّف الجلسة لقراءة إيصالات الرفع الجاهزة.

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

احتفظ بمعرّف الوسائط ومسارها اللذين يعيدهما Nushir. الرفع يخزّن الوسائط؛
ولا ينشئ منشورًا أو يجدوله أو ينشره.

## الإعداد والتأكيد والتنفيذ

1. اطلب سياق مساحة العمل واختر القناة المتصلة المقصودة بالضبط.
2. قدّم النص والوسائط المختارة وإعدادات المزوّد. للمنشور المجدول، حدّد تاريخًا
   ووقتًا دقيقين في المنطقة الزمنية لمساحة العمل؛ كلمة «غدًا» وحدها لا تكفي.
   ابدأ بمسودة إذا أردت المراجعة داخل Nushir.
3. يستدعي المساعد `prepareSchedulePostTool` ويعرض الحساب وأجزاء النص
   والتعليقات والوسائط وإعدادات الخصوصية والتوقيت المحلي وتوقيت UTC كما
   أُعدّت بالضبط. تخزّن مرحلة الإعداد طلبًا مؤقتًا؛ ولم تنشئ منشورًا بعد.
4. راجع المعاينة وأكّد الطلب المحدد صراحةً في رسالة جديدة. إذا تغيّر أي شيء
   أو انتهت صلاحية الطلب، فأعِد الإعداد والتأكيد.
5. يستدعي المساعد `commitSchedulePostTool` برمز التأكيد الخاص بذلك الطلب.
   احتفظ بمعرّفات منشورات Nushir والإيصال المعاد. تستخدم تغييرات إعدادات
   المنشور بالطريقة نفسها `preparePostSettingsTool` و`commitPostSettingsTool`.

للفحص الأول، اطلب: «أعدّ مسودة على قناتي المختارة. اعرض معاينتها الدقيقة
وانتظر تأكيدي». ثم أكّد بعد مراجعتها فقط. لا تطلب من المساعد تجاوز المعاينة
أو التأكيد.

يعيد تكرار Commit للطلب المنفذ نفسه إيصالَه الأصلي دون إنشاء منشور آخر
في قاعدة البيانات. احتفظ بهوية الطلب نفسها عند فحص نتيجة انقطعت أثناء
التنفيذ. إنشاء طلب جديد عملية مختلفة وقد ينشئ منشورًا آخر.

تعني `COMMITTED` أن Nushir حفظ الطلب المعدّ. تبقى المسودة مسودة؛ وما زال
الطلب المجدول يحتاج إلى سير عمل النشر وقبول المزوّد. لا يضمن Commit أو
رابط المعاينة وصول المنشور أو ظهوره للعامة.

اقرأ `postStatusTool` لكل معرّف منشور معاد. اعرض حالة Nushir وقيم
`providerReleaseId` و`providerReleaseUrl` و`error` و`providerConfirmed`
بأمانة. تعكس `providerConfirmed` إيصالًا مخزّنًا من المزوّد، وليست تحققًا
بصريًا مستقلًا من وصول المنشور للعامة. رابط الملف الشخصي أو منشور TikTok
الخاص أو إيصال صندوق وارد TikTok ليس دليلًا على منشور ظاهر للعامة. إذا
كانت الحالة غير مؤكدة، فافحصها للقراءة فقط؛ لا تنشئ منشورًا آخر «لإعادة
المحاولة».

## إعادة الربط أو إلغاء الوصول

إذا احتاجت قناة اجتماعية إلى إعادة الربط، فأعد ربطها داخل Nushir واقرأ
إعداداتها الحالية مجددًا قبل إعداد طلب آخر. تغيير اتصال المساعد وحده لا
يصلح بيانات اعتماد المزوّد.

لإلغاء وصول OAuth، افتح **Settings → Approved Apps** في Nushir وألغِ
التفويض المعني. افصل الاتصال لدى العميل أيضًا. لا تعتبر إزالة الاتصال من
العميل وحدها دليلًا على إلغاء التفويض في Nushir. يحتاج الاتصال اللاحق إلى
موافقة جديدة، وتظل متطلبات العضوية والدور الحالي مطبّقة.

لاتصال مفتاح API، احذف المفتاح المحفوظ لدى العميل. إذا انكشف المفتاح أو
احتجت إلى إبطال وصول العملاء الحاليين، فاستخدم **Rotate Key** في Nushir
وحدّث المفتاح لدى كل عميل شرعي كان يستخدم مفتاح مساحة العمل القديم.
لا ترسل أيًا من المفتاحين إلى الدعم.

## استكشاف الأخطاء وإصلاحها

| العَرَض | ما الذي ينبغي فحصه |
| - | - |
| فشل المصادقة أو HTTP 401 | نقطة النهاية والطريقة الصحيحتان، وصيغة الترويسة المحمية، وصلاحية المفتاح أو اتصال OAuth، والعضوية النشطة في مساحة العمل. أعد التفويض عند الحاجة. |
| خطأ إعادة توجيه OAuth أو PKCE أو التسجيل | عنوان إعادة التوجيه الدقيق وإعداد العميل. احتفظ بالخطأ المبلغ عنه واطلب مراجعته دون مشاركة الأكواد أو الرموز أو الأسرار. |
| رفض الإذن | النطاقات المطلوبة ودورك الحالي في مساحة العمل والعملية المطلوبة. إعادة الربط لا تتجاوز قيود الدور. |
| أداة مفقودة | حدّث القائمة. أُزيلت أدوات التوليد والمحددات والغلاف عمدًا. تتطلب أدوات الرفع المرئية إمكانات خادم مهيّأة وعميلًا متوافقًا. |
| رفض أداة مساعدة مسماة للقناة أو للمدخلات | اختر قناة تخص ذلك المزوّد من مساحة عملك واتّبع المخطط المعلن للأداة. تُرفض الحقول غير المعروفة. |
| قناة تحتاج إلى إعادة الربط | أعد ربط المزوّد داخل Nushir، ثم اقرأ إعداداته مجددًا. ربما حاولت الأداة بالفعل تحديث بيانات الاعتماد مرة واحدة ضمن حد مقرر. |
| فشل استيراد الوسائط | رابط تنزيل HTTPS مباشر متاح، وصلاحية الرابط، وحدود MIME والحجم المعلنة، وطريقة نقل مدعومة فعلًا. تغيير اسم الملف لا يحوّل صيغته. |
| أداة الرفع المرئية معلّقة أو لا تعرض ملفات جاهزة | افتح جلسة جديدة بدلًا من الجلسة المنتهية، وافحص حالة الرفع، واستخدم طريقة أخرى معلنة إذا لم يدعم العميل الأداة المرئية. |
| رفض Prepare للمنطقة الزمنية أو إرجاع Commit حالة `EXPIRED` | اقرأ سياق مساحة العمل مجددًا، وأعد إعداد الطلب المحدد، واحصل على تأكيد جديد. |
| إرجاع Commit حالة `PROCESSING` أو غموض الحالة أو انتهاء مهلة المزوّد | احتفظ بمعرّفات الطلب والمنشورات؛ افحص الحالة والإيصالات دون إنشاء طلب جديد. صعّد النتيجة غير المحسومة بدلًا من إنشاء نسخ مكررة بلا فحص. |

عند طلب [الدعم](/ar/general/support)، أرفق اسم العميل والوقت التقريبي والأداة
التي فشلت والخطأ بعد تنقيحه ومعرّف منشور Nushir المعني. لا ترفق كلمات المرور
أو مفاتيح API أو أسرار العميل أو أكواد التفويض أو رموز التأكيد أو روابط التنزيل
والرفع والروابط الموقّعة.

## التحقق الذي ما زال معلقًا

تم التحقق من نشر الخادم في بيئة الإنتاج ومن قائمة الأدوات الـ42 في 10 أكتوبر
2026 باستخدام مفتاح API لمساحة العمل في الترويسة على نقطتَي النهاية. تشمل
القائمة 25 أداة مساعدة مسماة للمزوّدين، وتستبعد التوليد الخارجي والمحددات
العامة وغلاف المساعد؛ يبقى الذكاء الاصطناعي المهيّأ داخل التطبيق متاحًا.
اقتصر الفحص على التهيئة واكتشاف الأدوات، دون استدعاء أي أداة.

ما زالت مصادقة OAuth Bearer وإعادة التوجيه وDCR وPKCE والموافقة والتحديث
وإلغاء الوصول، ووسائل النقل القديمة، والربط بكل عميل، ونقل الملفات والجلسات
وأداة الرفع المرئية، ومسارات Prepare وCommit والإيصالات الفعلية ونشر المحتوى عبر المزوّدين تحتاج
إلى فحوص قبول. يبقى اعتماد دليل التكاملات معلّقًا، وهو منفصل عن مراجعة المصدر
والاختبارات المحلية واكتشاف قائمة الأدوات.

لا تثبت العروض التاريخية قبول هذا الإصدار المنشور. لم يثبت فحص قائمة الأدوات
في 10 أكتوبر قبول OAuth أو الربط بعميل بعينه. لم يستدعِ أي أداة
أو يرفع وسائط أو ينشئ منشورًا أو ينشر محتوى. حدّث ملاحظات الحالة هذه بعد
فحوص القبول المتبقية.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.