لماذا يجب أن يبدأ دليل المبتدئين لاستخدام خادم MCP بما تخشاه
لم تقم أبدًا بلصق مفتاح API في نافذة دردشة، ولن تبدأ الآن. هذا هو السبب الحقيقي وراء تأجيلك لربط مساعد الذكاء الاصطناعي بحساب إشعارات الدفع الخاص بك لعدة أشهر. أنت لا تشك في أنه سيعمل؛ أنت فقط لا تثق بنفسك في عدم كسر شيء ما، أو إرسال رسالة خاطئة إلى مشتركين حقيقيين أثناء تعلمك أماكن الأزرار.
هذا دليل للمبتدئين لاستخدام خادم MCP، وتحديدًا PushEngage MCP، خادم بروتوكول سياق النموذج الرسمي لـ PushEngage، مكتوب بالطريقة الوحيدة التي تثبت فعليًا ما إذا كان أحد هذه الأشياء آمنًا لتسليم حسابك إليه: كأسبوع حقيقي، يومًا بيوم، وليس عرضًا مدته خمس دقائق يتوقف بمجرد أن يتحول الاتصال إلى اللون الأخضر. تنتهي معظم أدلة إعداد خادم MCP عند "تم الاتصال". هذا الدليل يستمر، لأن المؤسس الذي يقرر ما إذا كان سيثق بأداة لإرسال حقيقي يحتاج إلى رؤيتها تقوم بأسبوع كامل من العمل العادي، وليس مكالمة اختبار واحدة محفوظة.
يعمل PushEngage MCP بالفعل على نطاق حقيقي قبل أن تلمسه: يرسل أكثر من 25000 صاحب عمل في أكثر من 150 دولة عبر PushEngage، وتم إرسال 15.2 مليار إشعار في آخر 30 يومًا وحدها، عبر 27 أداة تمتد عبر 10 مجالات للحساب. هذه الكمية مهمة لسبب واحد: الأخطاء التي يخشى المستخدم لأول مرة ارتكابها قد تم ارتكابها بالفعل، وتم إصلاحها، من قبل أشخاص ليسوا أنت.
هذا هو الأسبوع. اليوم الأول هو التثبيت وتسجيل الدخول، ولا شيء آخر. اليوم الثاني هو أول إرسال حقيقي. اليوم الثالث هو إرسال مجدول يجب أن يصل في الساعة المناسبة للمشتركين في مناطق زمنية مختلفة. اليوم الخامس هو المرة الأولى التي تطرح فيها سؤالًا بسيطًا حول كيفية أداء أي من ذلك بالفعل. بحلول النهاية، سيكون هناك شيء محدد قد تغير حول كيفية إدارة عملك، وليس فقط حول كيفية استخدام أداة. إشعارات الدفع عبر الويب من PushEngage هي القناة التي يمر بها كل ذلك.
اليوم الأول: تثبيت PushEngage MCP دون كتابة مفتاح API مطلقًا
يستغرق إعداد خادم mcp بالكامل حوالي عشر دقائق، ولا تتضمن أي من هذه الدقائق العشر قيامك بإنشاء أو نسخ أو لصق بيانات اعتماد في أي مكان. هذه الحقيقة الوحيدة هي السبب الكامل وراء أن هذا الأسبوع يستحق المحاولة.
إضافة الخادم إلى مساعدك
يتم شحن PushEngage MCP كحزمة npm، @pushengage/mcp، وأمر التثبيت هو سطر واحد: npx -y @pushengage/mcp. لا يوجد شيء لتنزيله مسبقًا ولا شيء لتحديثه بنفسك. يقوم npx بجلب الإصدار الحالي في اللحظة التي يقوم فيها مساعدك بتشغيله. تحتاج إلى Node.js 18 أو أحدث مثبتًا بالفعل على جهازك وعميل قادر على MCP (Claude Desktop، Claude Code، Cursor، أو أي عميل آخر)، ولكنك لا تحتاج إلى كتابة سطر واحد من التعليمات البرمجية.
إذا كنت تستخدم Claude Desktop، فإن إعدادات خادم claude mcp موجودة في ملف يسمى claude_desktop_config.json (على macOS، تحت ~/Library/Application Support/Claude/). افتحه والصق هذه الكتلة فيه:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}احفظ الملف وأعد تشغيل Claude Desktop. يجب أن يظهر "pushengage" في قائمة الأدوات الخاصة بك.
يعمل Cursor بنفس الطريقة، فقط في ملف مختلف، ~/.cursor/mcp.json، مع لصق الكتلة المتطابقة فيه. لا يطلب منك Claude Code تحرير ملف JSON يدويًا على الإطلاق؛ يمكنك تسجيل نفس خادم claude mcp بأمر طرفي واحد، claude mcp add pushengage -- npx -y @pushengage/mcp، وهو متاح في كل جلسة من تلك النقطة فصاعدًا. أيًا كان العميل الذي تستخدمه، فإن شكل العمل هو نفسه: انسخ كتلة قصيرة، أو اكتب سطرًا واحدًا، وأعد التشغيل. لا أحد يطلب منك كتابة برنامج.
ماذا يحدث عند النقر فوق تفويض
بمجرد ظهور الخادم، اطلب من مساعدك: "سجل دخولي إلى PushEngage". يفتح علامة تبويب المتصفح على صفحة التفويض الخاصة بـ PushEngage، وليس نموذجًا مضمنًا في نافذة الدردشة الخاصة بك: علامة تبويب متصفح فعلية، على نطاق PushEngage الخاص. تنقر فوق تفويض. تؤكد علامة التبويب النجاح، ويتم حفظ رمز الوصول في ملف على جهازك، ~/.pushengage/mcp.json، يمكن قراءته فقط بواسطة حساب المستخدم الخاص بك.
في أي وقت لا يرى مساعدك كلمة مرور PushEngage الخاصة بك. ترسل لوحة المعلومات الرمز إلى الخادم كطلب في الخلفية، لذلك لا يظهر أبدًا في عنوان URL أو سجل المتصفح الخاص بك أو سجل وصول أي شخص. هذا هو الجزء الأكثر أهمية من خادم mcp للمبتدئين: بيانات الاعتماد تعيش مباشرة بين متصفحك و PushEngage، ولا يجلس الذكاء الاصطناعي أبدًا في هذا المسار على الإطلاق.
اختيار الموقع "الحالي"
اطلب "أظهر مواقع PushEngage الخاصة بي"، ثم "استخدم الموقع [أيًا كان ما قصدته]". يظل هذا الاختيار ثابتًا. يستمر عبر عمليات إعادة التشغيل، لذلك لن تعيد اختياره في كل مرة تفتح فيها محادثة جديدة. كل أداة خاصة بالموقع من الآن فصاعدًا تعمل على هذا الموقع الحالي ما لم تسمي موقعًا آخر صراحةً، وهذا مهم في اللحظة التي تشغل فيها أكثر من خاصية واحدة. إذا كان لديك موقع واحد فقط ضمن حسابك، فإن هذه الخطوة تستغرق عشر ثوانٍ ولن تفكر فيها مرة أخرى. إذا كنت تدير واجهتي متجر تحت حساب PushEngage واحد، فهذه هي اللحظة أيضًا لملاحظة أنك سترغب في تحديد أي منهما تقصد في أي طلب يمس المشتركين أو عمليات الإرسال أو التحليلات. المساعد لن يخمن.
عندما لا يسير اليوم الأول بسلاسة: الشيئان اللذان يخطئان بالفعل
تعود معظم مشكلات إعداد خادم mcp إلى مشكلة واحدة، وهي ليست خطأ PushEngage أو خطأك: إنها كيفية تشغيل تطبيقات سطح المكتب. إذا أبلغ Claude Desktop أو Cursor عن أن الخادم غير متصل، أو رأيت شيئًا مثل MCP error -32000: Connection closed، ولكن كتابة npx -y @pushengage/mcp مباشرة في الطرفية الخاصة بك تعمل بشكل جيد، فهذه مشكلة PATH. التطبيقات التي يتم تشغيلها من Dock أو Finder لا تقوم بتحميل ملفات بدء تشغيل shell الخاصة بك، لذلك إذا تم تثبيت Node من خلال مدير إصدارات، فلا يمكن للتطبيق العثور على npx حرفيًا.
الحل هو توجيه العميل الخاص بك إلى المسار المطلق لـ npx بدلاً من الاعتماد عليه للعثور عليه. قم بتشغيل which npx في الطرفية الخاصة بك للحصول على هذا المسار، ثم استخدمه مباشرة:
{
"mcpServers": {
"pushengage": {
"command": "/absolute/path/from/which-npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PATH": "/absolute/folder/containing/that/npx:/usr/bin:/bin:/usr/sbin:/sbin"
}
}
}
}أعد تشغيل العميل بعد التحرير. إذا طبع which npx شيئًا تحت /usr/local/bin أو /opt/homebrew/bin بدلاً من ذلك، فمن المحتمل أن هذه ليست مشكلتك. تحقق من سجلات MCP الخاصة بالعميل للحصول على الخطأ الحقيقي.
هناك ثلاث رسائل أصغر تستحق المعرفة قبل أن تواجهها، لأن أياً منها لا يعني أن هناك شيئًا معطلاً:
AUTH_EXPIRED— انتهت صلاحية الرمز المميز الخاص بك. اطلب من المساعد تسجيل الدخول مرة أخرى.NO_SITE_SELECTED— لقد تخطيت خطوة "استخدام الموقع". قم بإدراج مواقعك واختر واحدًا.- المتصفح لا يفتح — يحدث هذا فقط في الجلسات غير الرسومية أو البعيدة. يتم طباعة رابط التفويض في الطرفية بدلاً من ذلك؛ افتحه يدويًا.
كل خطأ آخر يعيده الخادم يبدأ بعلامة [CODE] وشرح باللغة العادية، وهي التفاصيل التي تستحق التذكر عندما يبدو شيء ما مخيفًا في الساعة 11 مساءً يوم الثلاثاء: إنه ليس صامتًا، وليس غامضًا عن قصد.
اليوم الثاني: أول طلب "أرسل هذا الآن"
بحلول اليوم الثاني، يكون التثبيت قد تم نسيانه. هذا هو المكان الذي تتوقف فيه إشعارات الدفع الخاصة بالمساعد الذكي عن كونها فكرة وتصبح رسالة واحدة محددة، يتم إرسالها إلى مجموعة واحدة محددة من الأشخاص، الآن.
تسأل: "أرسل إشعارًا إلى المتخلى عن عرباتهم بعنوان 'هل ما زلت تفكر في الأمر؟'، ورسالة 'عربتك تنتظر - أكملها اليوم'، مع رابط إلى صفحة عربتي."
لا يقوم مساعدك بتشغيل ذلك على الفور. إنه يعيد صياغة ما سيرسله بالضبط: العنوان، والرسالة، والرابط، ومجموعة الجمهور التي يستهدفها، ثم ينتظر تأكيدك قبل أن يقوم pushengage_send_notification بإرساله. إذا قمت بتسمية مجموعة جمهور يمتلكها PushEngage بالفعل (المتخلى عن عرباتهم، في هذا المثال)، فسيتم الإرسال فقط إلى هذا الجزء؛ إذا لم تحدد واحدًا، فسيتم إرساله إلى كل مشترك، وهو أمر يستحق الملاحظة قبل الموافقة على أي شيء.
لا يتم إرسال أي شيء لم تره أولاً. هذا هو الهدف الكامل من إرسال وجدولة إشعارات الدفع من مساعدك الذكي بدلاً من لوحة التحكم: خطوة التأكيد مدمجة في المحادثة نفسها، وليست شاشة منفصلة عليك أن تتذكر التحقق منها.
اليوم الثالث: إرسال مجدول يصل في الساعة 9 صباحًا في المنطقة الزمنية الخاصة بكل مشترك
اليوم الثالث هو المكان الذي يظهر فيه التردد الحقيقي للمؤسس بشأن الأتمتة: ماذا يحدث إذا تم تشغيل هذا أثناء عدم مراقبتي، وهل سيتم تشغيله في الوقت المناسب لشخص ليس في منطقتي الزمنية؟
يحتوي pushengage_send_notification على وضع مجدول مدمج لهذا الغرض بالضبط. تطلب إرسالًا لمرة واحدة موقوتًا لـ "9 صباحًا في المنطقة الزمنية المحلية لكل مشترك"، وتقوم الأداة بجدولة التسليم بحيث يتلقاه مشترك في لشبونة ومشترك في مانيلا في الساعة 9 صباحًا الخاصة بهما، وليس في وقتك. لا يزال الإرسال بحاجة إلى موافقتك قبل جدولته، تمامًا مثل اليوم الثاني؛ التوقيت فقط هو الذي يتغير.
توجد أيضًا عمليات إرسال متكررة (يمكنك إعداد ملخص أسبوعي بنفس الطريقة)، لكن اليوم الثالث هو فقط الإصدار لمرة واحدة عن قصد. لا تحتاج إلى الوثوق بالأداة بوظيفة متكررة دائمة قبل أن تشاهد إرسالًا مجدولًا واحدًا يتم تسليمه بشكل صحيح.
يستحق التسليم حسب المنطقة الزمنية لكل مشترك التفكير فيه، لأنه من السهل افتراض أن "الإرسال المجدول" يعني ببساطة "الإرسال لاحقًا" وتفويت ما هو مختلف بالفعل هنا. إذا كان ربع المشتركين لديك ليسوا قريبين من منطقتك الزمنية، فإن وقت إرسال ثابت واحد يعني أن معظمهم إما يتلقونه أثناء النوم أو بعد ساعات من اللحظة التي كان من المفترض أن تكون مهمة. يعني تقسيم التسليم حسب الوقت المحلي لكل مشترك أن إرسال الساعة 9 صباحًا هو إرسال الساعة 9 صباحًا في كل مكان يصل إليه، وهذا هو الفرق بين إشعار يراه شخص ما على الإفطار وآخر مدفون بحلول وقت الغداء.
اليوم الخامس: السؤال "كيف كان أداء ذلك؟" بدلاً من فتح لوحة تحكم
بحلول اليوم الخامس، تكون قد أرسلت شيئًا وجدولت شيئًا. السؤال التالي الذي يطرحه المؤسس فعليًا ليس عن الأداة. إنه عن العمل: هل كان أي من ذلك يستحق القيام به.
تسأل: "كم عدد المشتركين لدي، وما هو معدل النقر الخاص بي على هذا الإرسال الذي تم التخلي عن سلة التسوق؟" pushengage_get_analytics_summary و pushengage_get_analytics_timeseries يجيبان مباشرة، في الدردشة، بأرقام حقيقية: عدد المشتركين، عمليات الإرسال، المشاهدات، النقرات، ومعدل النقر للفترة التي سألت عنها.
لنفترض أن إرسال سلة التسوق المهجورة من اليوم الثاني عاد بمعدل نقر أعلى بشكل ملحوظ من عمليات الإرسال العادية لموقعك بالكامل. هذا ليس مجرد رقم أكبر للشعور بالرضا. توضيحيًا، إذا اكتملت حتى نسبة متواضعة من تلك النقرات الإضافية بعملية شراء، فهذه إيرادات سلة تسوق مستردة كنت ستتخلى عنها بخلاف ذلك، وليس مجرد إحصائية تفاعل. هذا هو يوم القرار الفعلي الذي يليه اليوم الخامس: ليس "هل فتحه الناس؟"، بل "هل يستحق القيام بذلك مرة أخرى، ولأي شريحة؟". للحصول على رؤية أطول عبر عمليات إرسال متعددة، فإن تقارير أداء الدفع أسبوعًا بعد أسبوع و تحليلات الإشعارات الفورية مشروحة بلغة بسيطة تتعمق أكثر مما يمكن لسؤال اليوم الخامس وحده.
ما تغير فعليًا بنهاية الأسبوع
لم يتغير شيء بخصوص الإشعارات الفورية هذا الأسبوع. ما تغير هو مكان حدوث العمل.
لم تفتح علامة تبويب منفصلة في لوحة التحكم للتحقق من أعداد المشتركين. لم ترسل رسالة إلى مطور تطلب منه "تغيير وقت الإرسال" في الإشعار المجدول. لم تقم بتبديل السياق بين إدارة العمل وتشغيل أداة الإشعارات. تم الطلب والتأكيد والنتيجة كلها في نفس المحادثة التي كنت تجريها بالفعل.
هذا تحول أصغر مما يبدو، وأكبر منه أيضًا. أصغر، لأن شيئًا لم يتغير في القناة الأساسية. لا تزال إشعارات الويب تعمل بالطريقة التي كانت تعمل بها دائمًا، والإشعارات التي تم إرسالها هذا الأسبوع لا يمكن تمييزها عن تلك المرسلة عبر لوحة التحكم. أكبر، لأن علامة التبويب التي لم تفتحها هي علامة التبويب التي كانت سببًا في دفع هذا الأمر باستمرار إلى "لاحقًا". المهمة التي تتطلب تبديل التطبيقات، وتذكر تسجيل الدخول، والعثور على الشاشة الصحيحة تتنافس مع كل شيء آخر في قائمة المؤسس وعادة ما تخسر. المهمة التي تحدث داخل محادثة كنت تجريها بالفعل لا تتنافس مع أي شيء. إنها تتم ببساطة.
هذا هو الأهم لأنه لم يتطلب أيًا من ذلك قرارًا بالميزانية أولاً. يعمل PushEngage MCP مع جميع خطط PushEngage، بما في ذلك الخطة المجانية. لم تكن تختبر معاينة مصغرة للتجربة هذا الأسبوع؛ كنت تستخدم نفس الأدوات التي يستخدمها حساب مدفوع، على وصول عادي. إذا كانت الأرقام من اليوم الخامس تدعم القيام بالمزيد من هذا، فإن صفحة تسعير PushEngage هي المحطة التالية، وهي تتوسع مع المشتركين النشطين بدلاً من طلب التزام قبل أن تثبت أي شيء لنفسك.
ما لم يغطيه دليل المبتدئين هذا، وأين تتعمق أكثر
يجدر أن نكون مباشرين بشأن ما لم تتناوله هذه الأسبوع، لأن الدليل الذي يخبرك فقط بما تفعله الأداة ولا يخبرك أبدًا بما لا تفعله هو نوع الدليل الذي يوقعك في مشكلة لاحقًا.
يمكن لـ PushEngage MCP سرد وقراءة حملات التنقيط الخاصة بك، والحملات المشغلة، وسير العمل. لا يمكنه بنائها لك. إذا كنت تريد أتمتة جديدة، فلا يزال يتعين عليك بناؤها في لوحة التحكم؛ يمكن للمساعد فقط إخبارك بما يتم تشغيله بالفعل وكيفية أدائه. لا يرسل رسائل WhatsApp، ولا يوجد إصدار عن بعد أو مستضاف للاتصال به من متصفح في مكان آخر. هذا خادم محلي، يعمل عبر npx، ويتحدث إلى حسابك عبر اتصال بروتوكول قياسي، لا أكثر.
لا شيء من ذلك يحد من الأسبوع الذي قضيته للتو. إذا كنت تريد الإصدار المرجعي الكامل لكل شيء في اليوم الأول (كل خيار تكوين، وكل عميل، وكل حالة استكشاف الأخطاء وإصلاحها)، فإن دليل إعداد PushEngage MCP الكامل يغطيه كتوثيق بدلاً من سرد.
هذا هو الشكل الصادق لدليل المبتدئين لاستخدام خادم MCP: خمسة أيام حقيقية، طلب واحد بلغة واضحة في كل مرة، وأنت تنهي الأسبوع تقوم بنفس العمل في أماكن أقل مما بدأت به.
