نظرة عامة
يوفر Nudgen خادم MCP عند/mcp في نطاق التطبيق. يدعم MCP 2026-07-28 عبر Streamable HTTP ويتطلب OAuth 2.1. سجّل الدخول عبر المتصفح ووافق على الصلاحيات المطلوبة. عند توفر الميزة، اختر مساحة واحدة أو امنح موافقة صريحة للوصول إلى جميع المساحات الحالية والمستقبلية التي تنتمي إليها. التبديل في لوحة التحكم لا يغيّر مساحة MCP الافتراضية.
العمل عبر مساحات متعددة
تبقى الاتصالات الحالية محصورة في مساحتها الأصلية حتى تعيد الاتصال وتوافق على وصول أوسع. مع إذن جميع المساحات، تصبح العضويات الجديدة متاحة تلقائيًا. فقدان العضوية يمنع العمليات اللاحقة في تلك المساحة. تظل الأدوار والاشتراكات والحصص مطبقة لكل مساحة على حدة. استخدمlist_workspaces مع page وpageSize لعرض المعرّفات والأسماء وslug والأدوار والمساحة الافتراضية. يلزم نطاق teams:read. أضف workspaceId إلى استدعاء أداة لاختيار مساحة لهذه العملية فقط. عند حذفه تُستخدم المساحة الافتراضية للاتصال. مرّر معرّف المساحة نفسه صراحة عند مراجعة الحملة وإرسالها.
اختر المساحة الافتراضية أثناء موافقة OAuth. غيّرها من الإعدادات ← مفاتيح API ← تطبيقات MCP المتصلة أو باستدعاء set_default_workspace مع workspaceId ونطاق teams:write. يؤثر التغيير في جميع المحادثات التي تستخدم الاتصال نفسه. اختيار مساحة لاستدعاء واحد لا يغيّر الافتراضي. إذا حُذفت المساحة الافتراضية أو تعذر الوصول إليها، حدّد معرّفًا آخر أو حدّث الإعداد. لا يختار Nudgen بديلًا تلقائيًا.
سبب أهمية ذلك
يمكن للمساعد مراجعة جهات الاتصال والبحث عن الشركات وإنشاء مسودات الحملات. اسمح بالإرسال أو الجدولة في المحادثة لينفذ المساعد الإجراء مباشرة دون رابط موافقة في المتصفح.ربط عميلك
نقطة نهاية الإنتاج هي:
يستخدم خادم التفويض رمز التفويض مع PKCE S256 وربط الموارد وتدوير رمز التحديث. كما يقبل مستندات بيانات معرّف العميل الوصفية والتسجيل الديناميكي للعملاء.
بالنسبة إلى Codex CLI، استخدم:
nudgen مهيأ بالفعل، فحدّث هذا الإدخال باستخدام عنوان URL /mcp.
استخدم
campaigns:read للقراءة وcampaigns:write للمسودات والتعديلات وcampaigns:send لإجراءات البريد التي تسمح بها. تظل موافقة OAuth مطلوبة عند الاتصال.
تصادق رموز الوصول الشخصية على واجهة برمجة تطبيقات المطور، لكنها لا تصادق على
/mcp. يجب على عميل MCP إكمال تسجيل الدخول عبر OAuth.الأدوات المتاحة
يحفظ
create_campaign مسودة حملة (one-time أو drip أو lifetime). ولا يمكنه الإرسال أو الجدولة مباشرةً. يتيح لك get_campaign التحقق من الموضوع والمحتوى والرابط والجمهور والمرسل قبل الإطلاق.
يعرض الخادم أيضًا موارد للقراءة فقط ضمن campaigns:read:
البحث عن عملاء محتملين على الخريطة واستيرادهم
- اطلب من المساعد استدعاء
search_map_leadsمع موقع وكلمات مفتاحية للنشاط التجاري، مثل مدينة وmarketing agency. - المرشحات الاختيارية هي
radiusKm(من 1 إلى 100)، وlatوlng، وemailOnlyللاحتفاظ بالأنشطة التجارية التي تنشر عنوان بريد إلكتروني. - عندما تتضمن النتيجة
nextPageToken، مرّرها بوصفهاpageTokenلتحميل صفحة أخرى. - اطلب من المساعد استدعاء
import_map_leadsباستخدام الموقع والكلمات المفتاحية نفسيهما، بالإضافة إلى كائنات العملاء المحتملين المراد حفظها. يقبل كل استدعاء ما يصل إلى 200 عميل محتمل.
إطلاق مسودة حملة
- راجع اسم الحملة والموضوع والمحتوى والمرسل الفعلي والعدد التقديري للمستلمين والتوقيت باستخدام
get_campaign. - اسمح بالإجراء في المحادثة. يستدعي المساعد
launch_campaignمباشرة مع معرّف الحملة وsendNow: trueللإرسال الآن أوscheduledAtبوقت مستقبلي يتضمن المنطقة الزمنية. لا ترسل خيارات توقيت متعارضة. لا يلزم تأكيد جديد إذا سبق أن سمحت بالإجراء. - راجع الحالة وموعد الإرسال ورابط لوحة التحكم في النتيجة. وضع الرسالة في قائمة الانتظار أو جدولتها لا يعني تسليمها. إذا كانت النتيجة غير مؤكدة فتحقق باستخدام
get_campaignوget_campaign_statsقبل إعادة المحاولة.
إدارة الوصول
افتح الإعدادات ← مفاتيح API ← تطبيقات MCP المتصلة لمراجعة الوصول أو تغيير الافتراضي أو قطع الاتصال. قطع اتصال متعدد المساحات يلغي رموزه وأكواد التفويض المعلقة عبر جميع المساحات دون قطع اتصالات REST المنفصلة. يحتفظ OAuth REST والمساعد داخل التطبيق بحدود المساحات الحالية.حل المشكلات
للنصوص البرمجية التي تستخدم رموز Bearer ونقاط نهاية REST المباشرة، راجع واجهة برمجة تطبيقات المطور.
نطاق البحث وإثراء البيانات
تستخدم API وMCP نطاق 5 كم افتراضيًا وتقبل عددًا صحيحًاradiusKm من 1 إلى 100 دون نافذة تأكيد لوحة التحكم. حافظ على المعلمات عند تمرير nextPageToken باسم pageToken. قد تحتوي صفحة فارغة على صفحة تالية.
يشير enrichmentPending إلى أن البحث في الموقع لم يكتمل. راجع businessSummary وbusinessSources عند توفرهما. يمكن لسياق الشركة المستورد دعم مقدمات حملات مخصصة. قد يكون البريد المفقود قيد البحث.
عند توفر enrichmentRetryToken استدعِ retry_map_leads_enrichment مع token وصلاحية campaigns:read. الرمز مرتبط بمساحة العمل المتصلة وينتهي بعد 15 دقيقة ويستخدم مرة واحدة. ادمج النتائج حسب placeId قبل الاستيراد. يرشح emailOnly الرد الحالي؛ قد تظهر نتائج بعد إعادة المحاولة.
تعديل المسودات ونطاق التغطية
استخدمupdate_campaign لتعديل مسودة موجودة وdelete_campaign لحذف مسودة. تتطلب الأداتان campaigns:write؛ ولا ترسلان البريد أو تجدولانه. تتطلب مجالات المنتج الجديدة أذونات OAuth مستقلة. أعد الاتصال ووافق على هذه الأذونات عند طلبها.
تعرض قائمة الأدوات الأدوات المتاحة ومعاملاتها. الانتقال إلى المتصفح لا ينفذ العملية. استخدم المتصفح للمدفوعات وتفويض المزوّد والدعوات وإنشاء المساحات أو حذفها أو الانضمام إليها وإعدادات الدفعات الحساسة. اختيار هدف MCP أو تغيير الافتراضي لا يبدّل مساحة لوحة التحكم. تُستثنى الإدارة وبيانات الاعتماد وwebhooks واستدعاءات التتبّع والمساعد الداخلي.
استخدم get_api_capabilities لمراجعة تغطية API. بعد السماح في المحادثة، استدعِ send_test_email أو activate_lifetime_campaign أو trigger_lifetime_campaign مباشرة. تُرسل الاختبارات إلى بريد الحساب فقط. يتيح تفعيل lifetime عمليات الإرسال الآلية المستقبلية. لا تحتاج إلى موافقة المتصفح أو معرّف موافقة. عند عدم وضوح النتيجة راجع الحالة أو سجل التنفيذ قبل إعادة المحاولة.