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

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

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

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

https://merge.email/mcp

يستخدم الخادم نقل Streamable 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 يدعم الخوادم البعيدة عبر Streamable HTTP مع OAuth يعمل بنفس الطريقة: وجهه إلى https://merge.email/mcp. العملاء الذين يبحثون عن بيانات وصفية للخادم يجدونها على:

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

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

الحساب

الأداةما تفعله
get_accountخطتك وحصة اليوم والميزات التي تتضمنها خطتك.
get_pricingالخطط والأسعار الحالية.
get_subscriptionحالة اشتراكك وفترة الفواتير وتاريخ التجديد.
get_billing_portal_linkرابط إلى بوابة الفواتير (الفواتير وطريقة الدفع وتغييرات الخطة).
get_team_seatsمقاعد اشتراك فريقك ومن يشغلها.
assign_team_seatيعطي مقعدًا لزميل.
unassign_team_seatيسترجع المقعد.

Google Sheets

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

القوالب

الأداةما تفعله
list_templatesقوالبك المحفوظة.
get_templateموضوع القالب والنص.
create_templateيحفظ قالبًا جديدًا.
update_templateيغير اسم القالب أو الموضوع أو النص.
delete_templateيحذف قالبًا.
duplicate_templateينسخ قالبًا.
generate_templateيكتب قالبًا باستخدام AI من موجز، مع مطابقة أعمدة ورقة عينة اختيارية.
import_google_docيحول مستند Google إلى قالب.

جهات الاتصال

الأداةما تفعله
list_contactsجهات اتصالك، مع مرشحات لملغي الاشتراك وقائمة الحظر.
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كيفية أداء تسلسل المتابعة.
check_quotaعدد رسائل البريد الإلكترونية التي يمكنك إرسالها اليوم وما إذا كانت الحملة مناسبة.
send_test_emailيرسل اختبارًا معروضًا إلى عنوانك الخاص.
send_campaignيبدأ حملة من ورقة أو قائمة جهات اتصال أو قائمة مكتوبة من المستقبلين: الآن أو مجدولة أو كـ Autopilot، مع متابعة اختيارية. يدعم تشغيل جاف يبلغ عما سيتم إرساله دون إرسال.
pause_campaignيوقف حملة قيد التشغيل.
resume_campaignيستأنف واحدة موقوفة.
stop_campaignيوقف حملة نهائيًا.
reschedule_campaignيغير تاريخ إرسال حملة مجدولة.
update_autopilotيغير الحجم اليومي ونافذة حملة Autopilot.
delete_scheduled_campaignيحذف حملة مجدولة قبل بدئها.

التحليلات

الأداةما تفعله
get_analyticsالإرسالات والفتح والنقرات بمرور الوقت، مع المعدلات والروابط الأفضل.
get_activityمن فتح ونقر وملغى الاشتراك، المستقبل تلو الآخر.
get_account_eventsسجل كل ما حدث في حسابك.

الإحماء

الأداةما تفعله
get_warmupحالة واتجاه سمعة الإحماء الخاص بك.
enable_warmupيبدأ إحماء صندوق بريدك.
pause_warmupيوقف الإحماء.
resume_warmupيستأنفه.
stop_warmupيوقفه.
update_warmup_settingsيغير الحجم اليومي والتصعيد.
check_email_reputationيشغل فحص السمعة المجاني على عنوان أو نطاق.

الإعدادات

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

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

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

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

مجانيشخصياحترافي
رسائل بريد إلكترونية يوميًا50250500 مع عنوان Gmail، 1500 مع Google Workspace
الجدولة والتأخيرات وسجل الحملاتنعمنعم
التحليلات والنشاطنعمنعم
Autopilot وتسلسلات المتابعةنعم
إحماء البريد الإلكترونينعم

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

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

افتح 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 لا يخزن شيئًا جديدًا نيابة عنه. انظر الأذونات والبيانات.