تخطَّ إلى المحتوى

استخدام Mail Merge مع وكلاء AI (MCP)

Mail Merge يوفر خادم MCP عام، لذا يمكن لأي وكيل AI تستخدمه بالفعل قراءة جداول Google Sheets الخاصة بك وكتابة القوالب وإدارة جهات الاتصال وإرسال الحملات من خلال حسابك في Mail Merge. تتحدث مع الوكيل باللغة الطبيعية، والوكيل يستدعي Mail Merge، وكل بريد إلكتروني يُرسل من حسابك في Gmail الخاص بك بنفس الحصص والتتبع وعمود الحالة كما لو بدأت الحملة يدويًا.

الخادم يعرض نفس الميزات الموجودة في تطبيق الويب، مجمعة كأدوات يمكن للوكيل استدعاؤها: الحساب والخطة وGoogle Sheets والقوالب وجهات الاتصال والحملات والتحليلات والإحماء والإعدادات. الوكيل يرى فقط الحساب الذي تسجل الدخول به، وفقط حتى تلغي وصوله. كل وكيل متصل يحصل على رمز وصول خاص به، مدرج ضمن الإعدادات → وكلاء AI في تطبيق الويب.

https://merge.email/mcp

الخادم يستخدم نقل HTTP قابل للبث و OAuth 2.1. عندما يتصل مساعدك للمرة الأولى، تفتح نافذة متصفح: سجل الدخول باستخدام حساب Google الذي تستخدمه مع Mail Merge، اقرأ صفحة الموافقة التي تسمي الوكيل، وأقرّ.

Claude (claude.ai)

  1. افتح الإعدادات → الموصلات.
  2. انقر على إضافة موصل مخصص.
  3. الصق https://merge.email/mcp كعنوان URL وانقر على الاتصال.
  4. سجل الدخول باستخدام Google في النافذة التي تفتح وأقرّ الوكيل.

Claude Desktop يستخدم نفس المسار: الإعدادات → الموصلات → إضافة موصل مخصص.

Claude Code

claude mcp add --transport http mailmerge https://merge.email/mcp

ثم اكتب /mcp في جلسة عمل، اختر mailmerge واتبع رابط تسجيل الدخول.

  1. افتح الإعدادات → الموصلات.
  2. اختر إنشاء (في بعض الإصدارات يكون تحت متقدم → وضع المطور).
  3. أدخل اسمًا، الصق https://merge.email/mcp كعنوان URL للخادم، اختر OAuth واحفظ.
  4. سجل الدخول باستخدام Google عند الطلب وأقرّ الوكيل.

أضف الخادم إلى .cursor/mcp.json في مشروعك (أو إلى الملف العام من إعدادات Cursor → MCP):

{
"mcpServers": {
"mailmerge": {
"url": "https://merge.email/mcp"
}
}
}

قائمة MCP ستظهر mailmerge مع رابط يحتاج تسجيل دخول. انقر عليه، سجل الدخول باستخدام Google وأقرّ الوكيل.

أي عميل MCP يدعم الخوادم البعيدة عبر HTTP قابل للبث مع OAuth يعمل بنفس الطريقة: وجّهه إلى https://merge.email/mcp. العملاء الذين يبحثون عن بيانات وصف الخادم يجدونها على:

https://merge.email/.well-known/oauth-protected-resource/mcp

التسجيل الديناميكي للعميل و PKCE مدعومان، لذا لا يلزم تكوين معرّف عميل أو سر مسبقًا.

الحساب

الأداة ما تفعله
get_account خطتك وحصتك اليومية والميزات التي تتضمنها خطتك (features، مع openTracking و clickTracking و scheduling وغيرها محددة حسب الخطة) وحدود مكتبتك (templates و contactLists؛ null تعني غير محدود).

الفواتير وتغييرات الاشتراك ومقاعد الفريق تُدار من قبلك في تطبيق الويب فقط: لا توجد أداة تقرأ الأسعار أو تفتح الدفع أو تنقل المقاعد.

Google Sheets

الأداة ما تفعله
list_spreadsheets جداول البيانات في Google Drive الخاص بك.
list_sheets علامات تبويب جدول البيانات.
read_sheet رؤوس وصفوف الورقة، البيانات التي تدمجها الحملة.

القوالب

الأداة ما تفعله
list_templates قوالبك المحفوظة، أو مع scope: "team" تلك المشاركة من أشخاص في اشتراك فريقك.
get_template موضوع القالب والنص؛ مع owner، قالب زميل مشترك.
create_template يحفظ قالبًا جديدًا. في خطة Free، حتى 3 قوالب محفوظة؛ بعد ذلك يجيب premium_required.
update_template يغيّر اسم القالب أو الموضوع أو النص.
delete_template يحذف قالبًا.
duplicate_template ينسخ قالبًا.
generate_template يكتب قالبًا باستخدام AI من موجز، مع مطابقة أعمدة ورقة عينة اختيارية.
import_google_doc يحول مستند Google إلى قالب.

جهات الاتصال

الأداة ما تفعله
list_contacts جهات اتصالك، مع مرشحات لمن ألغوا الاشتراك والقائمة السوداء.
get_contact_segments كيف ينقسم دفتر جهات اتصالك حسب الصناعة، مصنفة بواسطة AI في الخلفية من عنوان كل جهة اتصال وحقول الدمج: عدد لكل صناعة وكم لا يزال قيد الانتظار. في Professional، يمكن بعد ذلك تصفية list_contacts حسب industry؛ في الخطط الأخرى الأعداد إعلامية والتسميات لكل جهة اتصال لا تُعرض. انظر جهات الاتصال.
add_contact يضيف جهة اتصال واحدة.
import_contacts يضيف عديد جهات اتصال في وقت واحد.
delete_contacts يزيل جهات اتصال.
block_contacts يضع عناوين في القائمة السوداء حتى لا ترسل الحملات لهم رسائل بريد إلكتروني.
unblock_contacts يزيل عناوين من القائمة السوداء.
list_contact_lists قوائم جهات اتصالك.
create_contact_list ينشئ قائمة.
rename_contact_list يعيد تسمية قائمة.
delete_contact_list يحذف قائمة (جهات الاتصال تبقى).
add_contacts_to_list يضيف جهات اتصال إلى قائمة.
remove_contacts_from_list يزيل جهات اتصال من قائمة.

الحملات

الأداة ما تفعله
list_campaigns حملاتك النشطة والمجدولة والمكتملة.
get_campaign حملة واحدة مع تقدمها وإعداداتها.
get_campaign_recipients حالات المستقبلين لكل حملة.
get_sequence_stats كيف تؤدي سلسلة المتابعة: لكل خطوة، مرسل وفتح وانقر ورد وتخطي، شرط الخطوة، ونتائج اختبار الموضوع A/B للبريد الأول عند تشغيله.
check_quota كم بريدًا إلكترونيًا يمكنك إرساله اليوم وما إذا كانت الحملة تناسب.
send_test_email يرسل اختبارًا معروضًا إلى عنوانك الخاص.
send_campaign يبدأ حملة من ورقة أو قائمة جهات اتصال أو قائمة مستقبلين مكتوبة: الآن أو مجدولة (scheduleAt، الخطط المدفوعة)، أو كـ Autopilot (Professional)، مع trackClicks لتشغيل تتبع النقرات أو إيقافه (Personal وما فوق؛ إذا تم حذفه، ينطبق الافتراضي للخطة) ومتابعة اختيارية (followUp.condition: always أو notOpened أو notClicked أو opened أو clicked) أو اختبار موضوع A/B (abTest.subjects، سطرين أو ثلاثة مواضيع، مع autoWinner في حملات التنقيط). يدعم skipInvalidRecipients لاستبعاد العناوين التي وجدتها verify_recipients غير صحيحة. كل مستقبل مضمن يمكن أن يحمل fields - قيم الدمج مفتاحها اسم الوسم، وهذا أيضًا كيف تنتقل قيم generate_ai_field.
pause_campaign يوقف حملة جارية مؤقتًا.
resume_campaign يستأنف واحدة موقوفة.
stop_campaign يوقف حملة نهائيًا.
reschedule_campaign يغيّر تاريخ إرسال حملة مجدولة (الخطط المدفوعة).
update_autopilot يغيّر الحجم اليومي ونافذة حملة Autopilot.
delete_scheduled_campaign يحذف حملة مجدولة قبل بدئها.

التحليلات

الأداة ما تفعله
get_analytics الإرسالات والفتح والنقرات عبر الوقت، مع معدلات والروابط الأعلى؛ مع scope: "team"، الفريق بأكمله (Professional، مالك الاشتراك).
get_activity من فتح وانقر وألغى الاشتراك، مستقبل تلو الآخر.
get_account_events سجل كل ما حدث على حسابك.

الإحماء

الأداة ما تفعله
get_warmup حالة واتجاه سمعة الإحماء الخاص بك. الإحماء نفسه يُفعّل من قبلك في تطبيق الويب، حيث يتم إدخال بيانات اعتماد صندوق البريد: لا توجد أداة تطلبها.
pause_warmup يوقف الإحماء مؤقتًا.
resume_warmup يستأنفه.
stop_warmup يوقفه.
update_warmup_settings يغيّر الحجم اليومي والزيادة التدريجية.
check_email_reputation يشغّل فحص السمعة المجاني على عنوان أو نطاق.

الإعدادات

الأداة ما تفعله
set_throttle يعيّن سرعة الإرسال: بأسرع ما يمكن أو تأخير ثابت أو تأخير عشوائي بين الرسائل.

القابلية للتسليم

الأداة ما تفعله
verify_recipients يتحقق من قائمة عناوين قبل الإرسال (Professional): صحيح أو محفوف بالمخاطر أو غير صحيح مع سبب، دون إرسال بريد لأحد. انظر القابلية للتسليم.
get_domain_compliance حكم Google الخاص على نطاق الإرسال الخاص بك من Gmail Postmaster Tools (Professional): حالة امتثال متطلبات المرسل ومعدل البريد العشوائي وسجل المصادقة وأخطاء التسليم لآخر 30 يوم. يجب تسجيل النطاق والتحقق منه في Postmaster Tools؛ الاستدعاء الأول يطلب إذنًا إضافيًا. انظر القابلية للتسليم.
list_postmaster_domains النطاقات المسجلة في Postmaster Tools تحت حساب Google الخاص بك، مُتحقق منها أم لا.
add_postmaster_domain يسجل نطاقًا تملكه في Postmaster Tools ويعيد سجل DNS الذي يثبت الملكية. أضفه عند مزود DNS الخاص بك، ثم تحقق.
verify_postmaster_domain يطلب من Google التحقق من سجل DNS. إذا لم تتمكن Google من رؤيته حتى الآن، انتظر بضع دقائق وحاول مرة أخرى.

تخصيص AI

الأداة ما تفعله
generate_ai_field يكتب سطرًا قصيرًا مخصصًا واحدًا لكل صف باستخدام AI (Professional)، من أعمدة الصف الخاصة به. لا يتم إرسال أو حفظ أي شيء: يحصل الوكيل على القيم (100 صف لكل استدعاء، 2000 صف يوميًا) ويمررها من خلال send_campaign’s في كل مستقبل fields، تحت اسم الحقل، مع {{Field}} في الموضوع أو النص. انظر حقول AI.

بمجرد الاتصال، اسأل الوكيل بالطريقة التي تسأل بها زميلاً:

  • “اقرأ علامة التبويب Leads من جدول البيانات Q4 outreach الخاص بي، اكتب بريدًا إلكترونيًا قصيرًا للمتابعة يستخدم عمود الاسم الأول والشركة، وأرسل لي اختبارًا.”
  • “كم بريدًا إلكترونيًا يمكنني إرساله اليوم؟ إذا كان قالب Webinar invite مناسبًا، جدوله لقائمة جهات الاتصال Webinar غدًا الساعة 9 صباحًا.”
  • “أي حملة من الشهر الماضي كان لها أفضل معدل فتح، ومن انقر على رابط التسعير؟”
  • “أوقف حملة Partners وحظر كل من رد يطلب الإزالة.”

الوكيل له بالضبط أذونات خطتك. لا شيء يُفتح بمجرد توصيل واحد.

Free Personal Professional
رسائل بريد إلكترونية يوميًا 50 250 500 مع عنوان Gmail، 1500 مع Google Workspace
تتبع الفتح نعم نعم نعم
تتبع النقرات (trackClicks) نعم نعم
الجدولة وإعادة الجدولة (scheduleAt و reschedule_campaign) نعم نعم
القوالب المحفوظة وقوائم جهات الاتصال 3 قوالب، قائمة واحدة غير محدود غير محدود
التأخيرات وسجل الحملات نعم نعم
التحليلات والنشاط نعم نعم
Autopilot وسلاسل المتابعة واختبارات موضوع A/B نعم
إحماء البريد الإلكتروني نعم

عندما يستدعي وكيل أداة لا تتضمنها خطتك، الاستدعاء لا يفشل بصمت: الأداة ترد برسالة توضح أي خطة مطلوبة (premium_required لميزة Personal، professional_plan_required لميزة Professional)، والتي يعرضها الوكيل. في خطة Free هذا ما يجيب به send_campaign مع scheduleAt أو trackClicks و reschedule_campaign و create_template و duplicate_template و import_google_doc و generate_template أو create_contact_list بعد حد المكتبة. الحد ينطبق فقط على إنشاء عناصر جديدة: لا شيء محفوظ بالفعل يُزال. get_account يبلغ عن limits حتى يتمكن الوكيل من التحقق قبل المحاولة. تغييرات الخطة تُجرى من قبلك في تطبيق الويب، أبدًا من خلال وكيل. الحصة اليومية تعمل بنفس الطريقة: check_quota يخبر الوكيل بما يناسب اليوم، وحملة لا تناسب يتم تأجيلها أو رفضها تمامًا كما في تطبيق الويب. انظر التسعير والاشتراك و حدود الإرسال اليومية.

  • الوكيل يؤكد قبل الإرسال. قبل send_campaign يُعطى الوكيل تعليمات لإظهار عدد المستقبلين والقالب ووقت الإرسال، والانتظار لموافقتك. اقرأ هذا الملخص بنفس العناية التي تقرأ بها زر الإرسال.
  • فحص الحصة. check_quota يخبرك بكم من حصة اليوم ستستخدمه حملة، حتى لا تفاجئك قائمة كبيرة.
  • عمود الحالة لا يزال هناك. حملة بدأت من Google Sheet بواسطة وكيل تملأ نفس عمود الحالة 📮 كما واحدة بدأت من الإضافة، حتى تتمكن من متابعتها صفًا تلو الآخر في جدول البيانات وفي الحملات.
  • أوقف أو توقف في أي وقت، من الوكيل أو من تطبيق الويب أو من الإضافة.

افتح merge.email/app → الإعدادات → وكلاء AI. البطاقة تسرد كل وكيل متصل مع تاريخ الاتصال وآخر استخدام. انقر على إلغاء بجانب وكيل لقطع وصوله فورًا؛ الاستدعاء التالي الذي يجريه يُرفض ويجب أن يمر بتسجيل الدخول مرة أخرى.

إعدادات وكلاء AI

إلغاء وكيل لا يمس اتصال Google الخاص بك أو وكلاؤك الآخرون. لإزالة وصول Mail Merge الخاص به إلى حساب Google الخاص بك أيضًا، اذهب إلى myaccount.google.com/connections، الذي يوقع كل وكيل في الخروج في الحال ويوقف أيضًا أي حملة جارية (انظر إعادة توصيل حساب Google الخاص بك).

  • OAuth 2.1 مع PKCE. الوكيل لا يرى كلمة مرور Google الخاصة بك أبدًا، وأنت لا تكتب كلمة مرور في الوكيل أبدًا. تسجل الدخول على صفحة Google الخاصة وتوافق على صفحة موافقة Mail Merge التي تسمي الوكيل.
  • رمز لكل وكيل. كل اتصال يحصل على رمزه الخاص مع انتهاء الصلاحية والتحديث الخاص به، حتى يترك إلغاء وكيل واحد الآخرين يعملون.
  • الإلغاء فوري، من الإعدادات → وكلاء AI أو من حساب Google الخاص بك.
  • نفس قواعد البيانات كما في التطبيق. وكيل يقرأ ويكتب بالضبط ما يمكن لتطبيق الويب، لا أكثر، و Mail Merge لا يخزن شيئًا جديدًا نيابة عنه. انظر الأذونات والبيانات.