كيفية إعداد خادم PushEngage MCP في Claude أو Cursor أو أي نظام توجيه وكيل

لديك بالفعل Claude Desktop أو Claude Code أو Cursor مفتوحًا لساعات أطول في اليوم من لوحة تحكم PushEngage. في كل مرة تحتاج فيها إلى التحقق من معدل النقر أو إرسال إشعار، تنتقل بعيدًا عن النافذة التي يحدث فيها العمل الفعلي. إعداد PushEngage MCP يغلق هذه الفجوة: أمر npx واحد، وتسجيل دخول عبر المتصفح، وأدوات PushEngage موجودة داخل نفس جلسة الدردشة التي تستخدمها بالفعل لكتابة التعليمات البرمجية أو تصحيح سير العمل أو الإجابة على سؤال من فريقك.

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

ما ستتمكن من فعله بمجرد الاتصال

يشحن @pushengage/mcp 27 أداة عبر 10 مجالات، وبمجرد المصادقة على موقع، فإن جميعها تبعد جملة واحدة بدلاً من نقرة على لوحة التحكم. إليك بعض الأمثلة لما يبدو عليه الأمر بمجرد الانتهاء من الإعداد:

• إرسال إشعار دفع الآن، أو جدولته لوقت محدد، أو إعداد إرسال متكرر - في المنطقة الزمنية المحلية لكل مشترك إذا طلبت ذلك.
• تشغيل اختبار A/B بين عنوانين والسماح للمساعد بالإبلاغ عن معدل النقر بمجرد ظهور النتائج.
• إنشاء شريحة أو مجموعة جمهور من وصف باللغة العادية بدلاً من واجهة مستخدم للقواعد.
• سحب التحليلات كملخص مدى الحياة أو كسلسلة زمنية يومية.
• سرد حملات التنقيط وحملات التشغيل وسير العمل للتحقق مما يتم تشغيله بالفعل.
• قراءة إعدادات موقعك وتكوين عامل الخدمة وإعداد أداة الدردشة.

لا يتطلب أي من ذلك أن يمتلك المساعد كلمة مرور PushEngage الخاصة بك، ولا يتطلب منك مغادرة المحرر أو الطرفية. يدير PushEngage هذا التكامل لقاعدة حساب تضم أكثر من 25000 صاحب عمل في أكثر من 150 دولة، ويرسل 15.2 مليار إشعار في آخر 30 يومًا. يتحدث خادم MCP إلى نفس واجهة برمجة التطبيقات الإنتاجية التي تعمل عليها هذه الحجم، وليس عرضًا توضيحيًا معزولًا.

قبل أن تبدأ: ما تحتاجه

ثلاثة أشياء، ومن المحتمل أن يكون لديك اثنان منها بالفعل على الأقل:

1. حساب PushEngage - مجاني أو مدفوع، مع إضافة موقع واحد على الأقل. لا يقوم خادم MCP بإنشاء موقع لك؛ فهو يعمل على المواقع التي قمت بإعدادها بالفعل في لوحة تحكم PushEngage الخاصة بك.
2. Node.js 18 أو أحدث - يقوم المساعد بتشغيل الخادم عبر npx، والذي يأتي مع Node. تحقق باستخدام node -v في الطرفية.
3. عميل يدعم بروتوكول MCP — Claude Desktop، و Claude Code، و Cursor، أو أي عميل آخر يتواصل ببروتوكول MCP عبر الإدخال/الإخراج القياسي (stdio).

هناك شيء واحد يستحق ذكره بوضوح قبل البدء في تعديل ملفات التكوين: @pushengage/mcp يعمل محليًا على جهازك عبر stdio. لا يوجد خادم بعيد للإشارة إليه ولا عنوان URL موصل مستضاف. يقوم العميل بتشغيل العملية، وتتحدث العملية إلى واجهة برمجة تطبيقات PushEngage نيابة عنك. إذا كان دليل الإعداد لأداة مختلفة يخبرك بلصق نقطة نهاية بعيدة، فهذا نوع مختلف من خادم MCP عن هذا.

إعداد الخادم في Claude Desktop و Claude Code و Cursor

لا يوجد تثبيت عام. يقوم npx بجلب @pushengage/mcp عند الطلب في المرة الأولى التي يقوم فيها عميلك بتشغيله، باستخدام الأمر الدقيق npx -y @pushengage/mcp. تضيف هذا الأمر إلى تكوين MCP الخاص بعميلك، وتعيد تشغيل العميل، ويظهر الخادم في قائمة أدواتك.

يحتفظ كل عميل بتكوينه في مكان مختلف.

Claude Desktop

قم بتحرير ~/Library/Application Support/Claude/claude_desktop_config.json على macOS (أو المسار المكافئ على نظامك الأساسي):

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

أعد تشغيل Claude Desktop. يجب أن يظهر خادم “pushengage” في قائمة أدواتك.

Cursor

قم بتحرير ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Claude Code

يتواصل Claude Code ببروتوكول MCP عبر stdio بنفس الطريقة التي يتواصل بها Claude Desktop و Cursor، لذا فإن نفس شكل command/args يعمل إذا قمت بتحرير ملف تكوين MCP الخاص به مباشرة. إذا كنت تفضل عدم تحرير JSON يدويًا، فإن Claude Code يقبل أيضًا الخوادم من خلال أمر CLI الخاص به claude mcp add، وهو سلوك عام لـ Claude Code وليس شيئًا خاصًا بـ PushEngage. تحقق من وثائق Claude Code الخاصة بك للحصول على صيغة العلامة الدقيقة إذا اخترت هذا المسار.

أي عميل MCP آخر

إذا لم يكن عميلك أحد الثلاثة المذكورين أعلاه، فإن المتطلب الأساسي هو نفسه في كل مكان: قم بتكوينه لتشغيل npx -y @pushengage/mcp كخادم stdio. هذه هي خطوة التثبيت بأكملها، بغض النظر عن العميل الذي يقرأ التكوين.

تسمية الاتصال وعزل الرموز: PE_MCP_CLIENT_NAME و PE_MCP_CONFIG_PATH

لا يلزم وجود تكوين يتجاوز خطوة التثبيت. يتحدث الخادم إلى واجهة برمجة تطبيقات PushEngage الإنتاجية افتراضيًا؛ توجد متغيران بيئيان لإعدادات أقل شيوعًا:

متغير بيئي	افتراضي	الغرض
PE_MCP_CLIENT_NAME	مساعد الذكاء الاصطناعي	التسمية المعروضة على شاشة تفويض PushEngage كتطبيق يطلب الوصول. قم بتعيينها إذا كنت تريد شيئًا أكثر تحديدًا، مثل "Claude Desktop".
PE_MCP_CONFIG_PATH	~/.pushengage/mcp.json	حيث يتم تخزين رمز الوصول. قم بتعيين هذا لتشغيل أكثر من حساب PushEngage جنبًا إلى جنب. يجب أن يكون مسارًا مطلقًا — لا يوجد توسيع لـ ~.

معظم إعدادات الحساب الفردي لا تحتاج أبدًا إلى لمس أي من المتغيرين. PE_MCP_CLIENT_NAME هو راحة تجميلية، مفيد إذا كنت تريد أن تقول شاشة التفويض شيئًا أكثر قابلية للقراءة من “مساعد الذكاء الاصطناعي” عندما تكون أنت من ينقر على تفويض. PE_MCP_CONFIG_PATH مهم في اللحظة التي تحتاج فيها إلى ملف رمز ثانٍ ومنفصل، وهذا هو بالضبط الحالة التي سيتم تناولها تاليًا.

التشغيل الأول: تسجيل الدخول واختيار موقع

المصادقة تستند إلى المتصفح، لذا لا يرى المساعد كلمة مرور PushEngage الخاصة بك أبدًا. التدفق يتكون من ثلاث خطوات، ومن المفيد استعراض ما تستدعيه كل خطوة فعليًا في الخلفية:

1. اطلب من المساعد تسجيل الدخول. باللغة العادية: "سجلني في PushEngage". هذا يستدعي pushengage_auth_login، الذي يفتح علامة تبويب في المتصفح إلى صفحة تفويض PushEngage.
2. انقر فوق تفويض. يرسل لوحة التحكم الرمز إلى الخادم كطلب POST - لا يظهر أبدًا في عنوان URL أو سجل المتصفح أو سجل الوصول. يتم حفظ الرمز محليًا بأذونات 0600، ولا يمكن قراءته إلا بواسطة المستخدم الخاص بك.
3. اطلب من المساعد عرض مواقعك، ثم اختر واحدًا. "عرض مواقع PushEngage الخاصة بي" يستدعي pushengage_list_sites؛ "استخدام الموقع 12345" يستدعي pushengage_select_site. يتم تذكر الاختيار عبر عمليات إعادة التشغيل، وكل أداة خاصة بالموقع تعمل عليه ما لم تمرر صراحةً site_id مختلفًا.

الأدوات المعنية، بالاسم:

أداة	الغرض
pushengage_auth_login	يفتح المتصفح إلى PushEngage ويخزن الرمز عند النجاح.
pushengage_auth_status	يعرض ما إذا كنت مصادقًا وما هو الموقع المحدد حاليًا.
pushengage_list_sites	يسرد مواقع PushEngage التي يمكن لحسابك الوصول إليها.
pushengage_select_site	يضبط الموقع الحالي الذي ستعمل عليه الأدوات الأخرى.

بمجرد اختيار موقع، قم بتشغيل pushengage_auth_status (يكفي أن تسأل "ما هي حالة مصادقة PushEngage الخاصة بي") وتأكد من أنه يبلغ عن جلسة مصادق عليها وموقع محدد قبل محاولة أي شيء آخر. هذا هو خط النهاية الفعلي للإعداد، وليس اللحظة التي يعرض فيها العميل لأول مرة أن الخادم متصل.

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

معظم مشاكل الاتصال تعود إلى أحد ثلاثة أسباب محددة. قم بالتشخيص بهذا الترتيب.

لن يتصل الخادم على الإطلاق، ويظهر عميلك "تم إغلاق الاتصال". هذه دائمًا مشكلة PATH تقريبًا، وليست خطأ في الخادم. يقوم Claude Desktop و Cursor والعملاء المشابهون بالتشغيل من Dock أو Finder، وليس من طرفية، لذا فهم لا يقومون أبدًا بتحميل ملفات بدء تشغيل shell الخاصة بك. إذا تم تثبيت Node عبر مدير إصدارات (nvm، fnm، volta)، فلا يمكن للعميل العثور على 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]. أنت مصادق عليه، ولكن لم يتم اختيار موقع بعد. قم باستدعاء pushengage_list_sites، ثم اطلب استخدام أحد المواقع التي تم إرجاعها، قبل محاولة استخدام أي أداة خاصة بالموقع مرة أخرى.

هناك حالة أخرى جديرة بالمعرفة على الرغم من أنها ليست خطأ: إذا لم يفتح المتصفح تلقائيًا، فمن المحتمل أن تكون في جلسة بدون واجهة رسومية أو جلسة بعيدة (SSH، حاوية). سيتم طباعة عنوان URL للمصادقة في الطرفية التي تشغل الخادم. افتحه يدويًا.

تشغيل أكثر من حساب أو عميل PushEngage واحد

إذا كنت تدير PushEngage لأكثر من علامة تجارية واحدة، أو كنت وكالة تدير MCP ضد حسابات عملاء متعددة، فإن الحل هو PE_MCP_CONFIG_PATH من قبل: قم بتسجيل الخادم تحت اسمين مختلفين، كل منهما بمساره الخاص حتى لا تتصادم الرموز.

{
  "mcpServers": {
    "pushengage-client-a": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-a.json",
        "PE_MCP_CLIENT_NAME": "Claude Desktop (Client A)"
      }
    },
    "pushengage-client-b": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-b.json",
        "PE_MCP_CLIENT_NAME": "Claude Desktop (Client B)"
      }
    }
  }
}

قم بتسجيل الدخول تحت كل اسم خادم على حدة، وقم بالمصادقة على أي حساب PushEngage تختاره في المتصفح في كل مرة. يحتفظ كل إدخال خادم بملف الرمز الخاص به، لذا فإن التبديل بين حسابات العملاء هو مسألة اسم الأداة التي تستدعيها، وليس تسجيل دخول جديد في كل مرة. إذا كان هذا هو حالة الاستخدام الفعلية الخاصة بك، فإن السلسلة تحتوي على شرح كامل لـ تشغيل حسابات عملاء PushEngage متعددة من مساعد ذكاء اصطناعي واحد.

ماذا تفعل بمجرد الاتصال

مع اكتمال المصادقة واختيار موقع، تنقسم الأدوات الـ 27 إلى مجموعات عملية قليلة جديرة بالمعرفة بالاسم، وليس فقط بالعدد.

للعمل اليومي لإدارة الحملات، تغطي السلسلة كيفية إرسال وجدولة إشعارات الدفع من مساعد الذكاء الاصطناعي الخاص بك بدلاً من لوحة التحكم، وكيفية اختبار A/B لإشعارات الدفع والسماح للذكاء الاصطناعي باختيار الفائز حسب نسبة النقر. لبناء قائمتك، هناك دليل كامل لـ بناء شرائح المشتركين باللغة الإنجليزية البسيطة.

للتحليل، قراءة تحليلات إشعارات الدفع من خلال مساعد الذكاء الاصطناعي الخاص بك تشرح الملخصات مدى الحياة وسلاسل الوقت يومًا بيوم. هذه هي نفس أدوات التحليل التي تجعل نتيجة اختبار A/B أو إرسال حملة جديرة بالإبلاغ عنها، وليس مجرد تشغيلها. تغطي السلسلة أيضًا تدقيق حملات التنقيط وسير العمل للتحقق مما هو نشط بالفعل، وإدارة أداة الدردشة التي تعرض WhatsApp والقنوات الأخرى على الموقع.

لأعمال على مستوى الموقع، تغيير إعدادات موقع PushEngage من مساعد ذكاء اصطناعي تغطي المنطقة الزمنية، والموقع الجغرافي، وتكوين عامل الخدمة. وإذا كنت تقوم بإعداد هذا لأكثر من حساب PushEngage واحد، فإن المنشور المخصص للوكالات حول تشغيل حسابات عملاء PushEngage متعددة من مساعد ذكاء اصطناعي واحد (مرتبط أعلاه) يتعمق أكثر من مثال التكوين في هذا الدليل.

إذا كنت تقوم بإعداد هذا لشخص أقل تقنية (مؤسس يريد مساعد الذكاء الاصطناعي التعامل مع PushEngage يوميًا دون لمس ملف تكوين بنفسه)، فإن الأسبوع الأول لمؤسس غير تقني مع PushEngage MCP هو النسخة السردية لنفس الإعداد هذا، مكتوبة لهذا القارئ.

يعمل الإعداد نفسه بنفس الطريقة بغض النظر عن خطة PushEngage الخاصة بك. تدعم كل خطة من خطط PushEngage، بما في ذلك الخطة المجانية، خادم MCP. إذا كنت تقرر أي خطة تناسبك قبل توصيل أي شيء، فإن صفحة التسعير الخاصة بـ PushEngage تحتوي على المستويات الحالية.