مرجع الأدوات

كل أداة يستطيع مساعد مرتبط استدعاءها، مجمّعة بالطريقة نفسها التي يسجّلها بها الخادم. ولا تُعرض الأداة على المساعد إلا إن كان اتصالك يملك النطاق الذي تحتاجه — فلا يوجد شيء اسمه أداة كتابة موجودة لكنها تفشل دائمًا؛ فإن لم تمنح contacts:write، فلن يرى المساعد upsert_contacts إطلاقًا. راجع النطاقات والصلاحيات لمعرفة معنى كل نطاق.

مدمّرة في الجداول أدناه هي وسم MCP نفسه الذي تشترطه عملية المراجعة الخاصة بـ Claude — فهي تَسِم أداة لا يمكن التراجع عن أثرها بسهولة (حذف مشروع، أو الكتابة فوق شجرة، أو إزالة جهة اتصال)، لا «خطيرة» بمعنى أكثر غموضًا. وتظل كل أداة كتابة تأخذ الحقول المتوقعة فقط؛ فلا تقبل أيٌّ منها حمولة خام يستطيع النموذج أن يهرّب عبرها تغييرات عشوائية.

الاكتشاف

الأداة	النطاق	ملاحظات
`search`	أيٌّ من `projects:read` / `templates:read` / `contacts:read`	يبحث في المشاريع والقوالب وقوائم جهات الاتصال بالاسم. ويعيد معرّفات مبهمة لـ `fetch`. وهذه هي الأداة التي يستدعيها تلقائيًا العميل القادر على البحث المعمّق.
`fetch`	نفس نطاق `search`	يحلّ معرّفًا واحدًا من `search` إلى محتواه الكامل.

تصميم الرسائل

الأداة	النطاق	مدمّرة	ملاحظات
`list_projects`	`projects:read`		المعرّف والاسم والغرض لكل مشروع.
`get_email`	`projects:read`		شجرة العناصر والسمة الحاليتان للمشروع.
`preview_email`	`projects:read`		يعرض عبر مسار HTML المرسل الحقيقي — المستند نفسه تمامًا الذي سينتجه الإرسال. مرفقة بأداة مرئية (راجع أدناه).
`list_block_types`	`projects:read`		كتالوج العناصر الـ 44 كاملًا، مولّدًا من السجل الحيّ — محدّث دائمًا، ولا يُصان يدويًا أبدًا.
`list_templates`	`projects:read`		قوالبك المحفوظة، أو معرض المجتمع المعتمد.
`create_project`	`projects:write`		يُملأ اختياريًا من قالب غرض مدمج.
`add_block` / `update_block` / `move_block`	`projects:write`		تعديلات على الشجرة، يُتحقَّق منها عبر `canPlace`/الحقول بالطريقة نفسها التي يُتحقَّق بها من تعديلات المساعد الذكي داخل الاستوديو.
`remove_block`	`projects:write`	✓	يحذف عنصرًا وأبناءه.
`set_theme`	`projects:write`		ألوان العلامة التجارية، والخط، واستدارة زوايا الأزرار.
`rename_project`	`projects:write`
`delete_project`	`projects:write`	✓	نهائي.
`apply_template`	`projects:write`	✓	يكتب فوق شجرة المشروع وسمته بالكامل.
`save_as_template`	`templates:write`		يلتقط المشروع الحالي في قالب قابل لإعادة الاستخدام.
`publish_landing_page`	`projects:write`		ينشر رسالة كصفحة ويب عامة في `/lp/<slug>` ويُرجع عنوانها. وكما في الإرسال، يُطلب من المساعد أن يعرض عليك الرسالة أولًا ويحصل على موافقتك.
`unpublish_landing_page`	`projects:write`		يلغي نشر الصفحة. ويبقى العنوان محجوزًا لك.

الجمهور

الأداة	النطاق	مدمّرة	ملاحظات
`list_data_sources`	`contacts:read`		كل مصدر بيانات، بما في ذلك قوائم جهات الاتصال. ولا تُعاد قيم بيانات الاعتماد أبدًا.
`list_contact_lists`	`contacts:read`		قوائم جهات الاتصال تحديدًا — المعرّف، والاسم، والحقول، وعدد الصفوف.
`get_contact_list_summary`	`contacts:read`		الأعداد وإجماليات حظر الإرسال وتوزيع نتائج التحقق من البريد، مع حالة آخر إعادة فحص — دون بيانات جهات اتصال فردية.
`find_contacts`	`contacts:read`		بحث محدود (≤25 صفًا، مع ترقيم صفحات بالمؤشر). ومع `sortBy: "engagementScore"` يُرجع أكثر جهات الاتصال اهتمامًا في القائمة أولًا، مع درجتها وتغيّرها هذا الأسبوع. ويُكتب كل استدعاء في سجل الوصول إلى البيانات الشخصية، كقراءة جهة اتصال من لوحة التحكم.
`upsert_contacts`	`contacts:write`		إضافة صفوف أو تحديثها؛ ويفرض الحدّ الأقصى لجهات الاتصال في باقتك.
`remove_contact`	`contacts:write`	✓	يزيل صفًّا واحدًا نهائيًا.
`add_suppression` / `remove_suppression`	`contacts:write`		يحظر الإرسال إلى عنوان أو يرفع الحظر عنه على مستوى الحساب، بالأثر نفسه لرابط إلغاء الاشتراك الخاص بالمستلم.

النتائج

الأداة	النطاق	مدمّرة	ملاحظات
`get_campaign_results`	`analytics:read`		مرات الفتح/النقرات/الردود/الإيرادات، ومقارنة نسخ A/B، والخريطة الحرارية للنقرات. ملخّصة فقط — ولا تُعاد أبدًا أحداث خام لكل مستلم. مرفقة بأداة مرئية.
`get_form_responses`	`analytics:read`		ملخّصات إجمالية لكل سؤال؛ والإجابات النصية الحرة عيّنة محدودة ومحاطة بسياج.
`list_orders`	`analytics:read`		طلبات الدفع عبر عنصر المنتج.
`list_campaign_sends`	`analytics:read`		عمليات الإرسال الجماعية السابقة، الأحدث أولًا.
`list_schedules`	`analytics:read`		عمليات الإرسال المتكررة المضبوطة في مشروع.
`mark_order_fulfilled`	`commerce:write`		يضع على طلب مادي علامة «تم الشحن» ويراسل المشتري.
`create_schedule`	`campaigns:send`		يضبط إرسالًا متكررًا جديدًا.
`set_schedule_enabled`	`campaigns:send`	✓	موسومة بأنها مدمّرة لأن تعطيل جدول نشط يوقف عمليات الإرسال المستقبلية بصمت.

الإرسال

الأداة	النطاق	مدمّرة	ملاحظات
`send_test_email`	`campaigns:read`		نسخة واحدة مسبوقة بـ `[Test]` إلى عنوان واحد تحدّده — لا تمسّ جمهورك الحقيقي ولا تحتاج إلى `campaigns:send`.
`prepare_send`	`campaigns:send`		للقراءة فقط بحسب الوسم — تحدّد الجمهور وتعرض معاينة، ولا ترسل شيئًا. وتعيد `confirmationToken`، وعدد جهات الاتصال التي ستُتخطّى بسبب عنوان غير صالح أو غياب الموافقة. مرفقة بأداة مرئية (بطاقة تأكيد الإرسال).
`confirm_send`	`campaigns:send`	✓	تشترط `confirmationToken` نفسه تمامًا الذي أعادته `prepare_send`، دون تغيير، خلال 10 دقائق. راجع الأمان لمعرفة السبب.

صندوق البريد والتذاكر

الأداة	النطاق	ملاحظات
`list_mailbox_threads` / `get_mailbox_thread`	`mailbox:read`	البريد الوارد على نطاقك الموثّق. ونصوص الرسائل محاطة بسياج بوصفها محتوى غير موثوق كتبه المستلمون.
`reply_to_mailbox_thread`	`mailbox:write`	يرسل من عنوان صندوق البريد نفسه تمامًا الذي وصل إليه البريد الأصلي، مربوطًا بسلسلته بشكل صحيح.
`list_tickets` / `get_ticket`	`mailbox:read`	محادثات تذاكر الدعم. مع السياج نفسه للمحتوى غير الموثوق.
`reply_to_ticket`	`mailbox:write`	يضيف رسالة من المالك ويرسل إلى المستلم رابطًا للعودة.

الرحلات والشرائح

الأداة	النطاق	مدمّرة	ملاحظات
`list_journeys`	`journeys:read`		المعرّف والاسم وحالة التشغيل ونوع المشغّل وعدد الخطوات لكل رحلة.
`get_journey`	`journeys:read`		المسار الكامل للرحلة، مع أسماء رسائلك وقوائمك وشرائحك، وكل ما قد يمنع تشغيلها. للرحلة المتوقفة القابلة للتشغيل، تُرجع أيضًا `enableToken`.
`list_segments`	`journeys:read`		الشرائح المحفوظة، مع قائمة جهات الاتصال والقواعد لكل منها.
`create_segment`	`journeys:write`		تحفظ شريحة على قائمة جهات اتصال واحدة. تلتزم بحد الشرائح في باقتك.
`build_journey`	`journeys:write`		تنشئ رحلة جديدة، أو تعدّل رحلة متوقفة، انطلاقًا من طلب بلغة عادية، باستخدام مساعد الذكاء الاصطناعي في منشئ الرحلات. تستهلك دورة واحدة من مساعد الذكاء الاصطناعي. تُحفظ النتيجة دائمًا متوقفة، ولا تُعدَّل أبدًا رحلة قيد التشغيل.
`set_journey_enabled`	`journeys:write` (+ `campaigns:send` للتشغيل)	✓	يتطلب تشغيل الرحلة `enableToken` الذي أرجعته `get_journey`، دون تغيير، خلال 10 دقائق وقبل أي تعديل. الفكرة نفسها ذات الخطوتين في `prepare_send`/`confirm_send`. الإيقاف المؤقت لا يتطلب أيًّا منهما.

الحساب

الأداة	النطاق	ملاحظات
`get_plan_usage`	لا شيء — متاحة دائمًا	الباقة، والحصص، واستهلاك هذا الشهر. للقراءة فقط، وليست بيانات حساب حساسة كالمشاريع/جهات الاتصال/صندوق البريد، لذا فهي متاحة بغض النظر عن النطاقات التي منحتها.

الأدوات المرئية

ثلاث أدوات ترفق أداة مرئية تفاعلية في المضيفات التي تدعم MCP Apps (Claude — أما Gemini فلا يملك طبقة أدوات مرئية ويحصل دائمًا على النتيجة النصية/JSON البسيطة بدلًا من ذلك): preview_email (معاينة حيّة للرسالة على سطح المكتب/الهاتف)، وget_campaign_results (لوحة النتائج)، وprepare_send (بطاقة تأكيد الإرسال، التي يكون زر Confirm & Send الخاص بها هو ما يستدعي confirm_send فعليًا).