التكاملاتربط مساعد ذكاء اصطناعي

ربط مساعد ذكاء اصطناعي

اربط Claude أو Cursor أو أي عميل يدعم MCP بخادم MCP الخاص بنشرة على https://app.nashra.ai/mcp ليدير عنك المشتركين والمنشورات وإرسال البريد: تسجيل الدخول عبر OAuth، والأدوات المتاحة (18 أداة)، ومن يمكن أن تصله الرسائل التجريبية، وما يتطلّبه الإرسال، وكيف يعمل الوصول لأعضاء الفريق.

ما هو MCP

MCP (Model Context Protocol) معيار مفتوح يتيح لمساعدات الذكاء الاصطناعي استدعاء وظائف التطبيق مباشرةً، بدل أن تنسخ البيانات بنفسك ذهاباً وإياباً. وتشغّل نشرة خادم MCP، فيستطيع المساعد المتصل، سواء كان Claude أو Cursor أو أي عميل آخر يدعم MCP، أن يقرأ مساحة عملك ويديرها نيابةً عنك، مستخدماً الإجراءات نفسها التي تقوم عليها لوحة تحكم نشرة.

ربط عميل

أضف الخادم

في عميل MCP لديك، أضف خادماً جديداً يشير إلى https://app.nashra.ai/mcp.

امنح الإذن من متصفحك

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

ابدأ الاستخدام

بعد الاتصال، اطلب من مساعدك أن يعرض المشتركين، أو يكتب مسودة منشور، أو يتفقّد إحدى الشرائح في التصنيفات (Segments). وسيستدعي الأداة المناسبة تلقائياً.

يعرّف الخادم نفسه باسم nashra، الإصدار 1.0.0. والوصول محمي بـ OAuth 2.1 مع PKCE، فلا تحتاج إلى مفتاح API. وتخضع طلبات MCP للحد نفسه المطبّق على REST API، أي 60 طلباً في الدقيقة. راجع حدود الطلبات.

تستطيع هذه الأدوات إنشاء محتوى ومشتركين حقيقيين وتعديلهم ونشرهم وحذفهم، والأداة SendPost ترسل حملة بريدية إلى قائمة مشتركيك الفعلية. فقبل أن تطلب من مساعدك إرسال أي شيء فعلاً، استخدم SendTestPost لمعاينته أولاً.

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

ما يمكنك طلبه

يجمع المساعد بين هذه الأدوات بنفسه، فتتحوّل أغلب الطلبات إلى استدعاء أداة واحدة أو أكثر دون أن تحتاج إلى تسميتها:

  • «اعرض لي المشتركين الذين يحملون الفئة vip وانضموا هذا الشهر» ← ListSubscribers
  • «اكتب مسودة منشور عن إطلاقنا في الربع الثالث، وضعه في تصنيف المنتج» ← CreatePost
  • «أرسل لي نسخة تجريبية من هذا المنشور قبل أن يُرسل» ← SendTestPost
  • «جدول إرسال هذا يوم الخميس الساعة 9 صباحاً إلى شريحة الرسالة البريدية» ← ScheduleSendPost
  • «في أي مساحة عمل أنا؟ انقلني إلى الأخرى» ← ListWorkspaces وSwitchWorkspace

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

الوصول والصلاحيات

يعمل اتصال MCP بصفة حساب نشرة الذي منحه الإذن، في مساحات العمل التي ينتمي إليها ذلك الحساب. استخدم ListWorkspaces وSwitchWorkspace للتنقّل بينها. ولا توجد نطاقات صلاحيات منفصلة تحتاج إلى ضبطها.

لا تقلّص أدوار الفريق قائمة الأدوات حالياً: أي عضو في فريقك يربط مساعداً يحصل على الأدوات كلها (18 أداة) في مساحة العمل تلك، سواء كان مالكاً أو مسؤولاً أو محرّراً. فلا تربط إلا حسابات تأتمنها على مساحة العمل كلها. وحين يغادر أحدهم، فإن إزالته من الفريق تقطع أيضاً وصول مساعده إلى مساحة العمل. راجع الفريق والأدوار لتعرف كيف تعمل الأدوار في لوحة التحكم.

الأدوات

يتيح خادم MCP في نشرة 18 أداة موزّعة على ثلاث مجموعات: المشتركون، والمنشورات، ومساحات العمل.

المشتركون

الأداةما تفعله
ListSubscribersتعرض المشتركين، مع بحث اختياري، وتصفية حسب الحالة (مشترك أو ملغى اشتراكه أو غير مؤكد)، وتقسيم إلى صفحات. للقراءة فقط.
GetSubscriberتجلب مشتركاً واحداً بمعرّف UUID أو بالبريد الإلكتروني. للقراءة فقط.
CreateSubscriberتنشئ مشتركاً ببريده الإلكتروني، مع اسم وفئات وملاحظات وسمات مخصّصة اختيارية.
UpdateSubscriberتحدّث مشتركاً موجوداً بمعرّف UUID أو بالبريد الإلكتروني، ولا يتغيّر إلا ما تقدّمه من حقول.
DeleteSubscriberتحذف مشتركاً بمعرّف UUID أو بالبريد الإلكتروني.
ListTagsتعرض كل الفئات في مساحة العمل الحالية. للقراءة فقط.
ListSegmentsتعرض كل الشرائح في مساحة العمل الحالية، مع عدد المشتركين في كل منها. للقراءة فقط.

المنشورات

الأداةما تفعله
ListPostsتعرض المنشورات، مع بحث اختياري، وتصفية حسب الحالة (مسودة أو منشور أو مجدول أو مُرسل)، وتصفية حسب التصنيف، وتقسيم إلى صفحات. للقراءة فقط.
GetPostتجلب منشوراً واحداً بمعرّف UUID، مع محتواه كاملاً ونسبة الفتح ومعدل النقر. للقراءة فقط.
CreatePostتنشئ مسودة منشور جديدة، ويمكنها أن تحدّد العنوان والمحتوى والتصنيف.
UpdatePostتحدّث عنوان منشور موجود أو محتواه أو مُعرّف الرابط أو التصنيف. ولا يتغيّر إلا ما تقدّمه من حقول.
PublishPostتنشر منشوراً في بيت النشر الخاص بك على مُعرّف رابط تحدّده. وتتحقّق من حدود الباقة قبل النشر.
UnpublishPostتلغي نشر منشور وتعيده إلى المسودات.
SendTestPostترسل نسخة تجريبية من المنشور بالبريد إلى عنوان واحد، هو عنوانك أو عنوان أحد أعضاء فريقك أو أحد عناوين المرسِل لديك، لتعاينه قبل الإرسال الفعلي.
SendPostترسل منشوراً حملةً بريدية إلى المشتركين، إلى الجميع أو إلى شريحة محدّدة، فوراً. وتتطلّب باقة مدفوعة أو طريقة دفع مسجّلة.
ScheduleSendPostتجدول إرسال منشور حملةً بريدية في تاريخ ووقت محدّدين، بحسب المنطقة الزمنية لمساحة العمل. وتتطلّب باقة مدفوعة أو طريقة دفع مسجّلة.

مساحات العمل

الأداةما تفعله
ListWorkspacesتعرض كل مساحات العمل (المنصات التي تنشر منها) التي ينتمي إليها الحساب الذي منح الإذن، وتبيّن أيّها النشطة حالياً.
SwitchWorkspaceتغيّر مساحة العمل النشطة بمعرّف UUID. وتفشل إن لم يكن الحساب ينتمي إلى تلك المساحة.

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