خادم MCP

يوفّر MailInApp خادم MCP كي يتمكن عميل ذكاء اصطناعي خارجي — Claude Desktop، أو Claude Code، أو أي أداة أخرى متوافقة مع MCP — من بناء مشاريع الرسائل في حسابك وتعديلها مباشرة، بالطريقة نفسها التي يفعلها المساعد الذكي داخل الاستوديو. فنواة استخدام الأدوات هي نفسها في الحالتين: عميل MCP ولوحة الاستوديو مجرد بابين أماميين مختلفين إلى مجموعة التعديلات نفسها تمامًا.

تغطي هذه الصفحة مسار المطوّرين: الواجهة الخلفية أو أدوات سطر الأوامر الخاصة بك وهي تصادق بمفتاح API تنشئه بنفسك، وهو بيانات الاعتماد نفسها التي تستخدمها Send API.

نقطة النهاية والمصادقة

https://mailinapp.com/api/mcp

صادِق بترويسة Authorization: Bearer <apiKey> نفسها المستخدمة في Send API — أنشئ مفتاحًا أو أعد استخدام مفتاح من المطوّرون في لوحة التحكم. ولا توجد بيانات اعتماد منفصلة خاصة بـ MCP تحتاج إلى إدارتها في هذا المسار؛ فالمفتاح يمثّل أصلًا «الواجهة الخلفية الخاصة بهذا الحساب»، لذا يُوثق به بالمستوى نفسه هنا، وتكون كل أداة موثّقة أدناه متاحة بغض النظر عن النطاق.

نقطة النهاية عديمة الحالة: فكل طلب استدعاء MCP مكتفٍ بذاته، فلا شيء يحتاج إلى إبقائه حيًّا بين الرسائل ولا توجد خطوة اتصال/قطع اتصال منفصلة سوى الإعداد المعتاد لعميل MCP لديك.

ربط Claude Code

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

يقبل Claude Desktop وعملاء MCP الآخرون الذين يدعمون خادم HTTP بعيدًا الرابطَ والترويسةَ نفسيهما — راجع توثيق عميلك لمعرفة مكان لصقهما.

الأدوات

يُوثق بمفتاح API بمستوى مالك الحساب الكامل، لذا يرى كل الأدوات المتاحة — تصميم المشاريع، وجهات الاتصال وحظر الإرسال، ونتائج الحملات والطلبات، والإرسال (بما في ذلك إرسال حملات حقيقية، لا الاختبارات فقط)، والردود في صندوق البريد والتذاكر، واستهلاك الباقة.

تأخذ أدوات تعديل الشجرة (add_block/update_block/remove_block/move_block/set_theme، وما شابهها) كلها معامل projectId في المقدمة (من list_projects/create_project) — إذ لا يملك عميل MCP علامة تبويب استوديو مفتوحة يستنتجه منها. ويُوصف كل نوع عنصر صالح، والحاويات المقبولة له، وقائمة حقوله للنموذج بوصفها جزءًا من مجموعة الأدوات عبر list_block_types، فتبقى متزامنة مع أنواع العناصر التي يوفّرها الاستوديو حاليًا أيًّا كانت؛ فلا تحتاج إلى إخباره بما هو متاح.

كيف تُطبَّق التعديلات

كل استدعاء لأداة تعديل عملية كتابة ذرية مستقلة مباشرة إلى المشروع — فلا توجد خطوة «تطبيق» كالتي تملكها اللوحة داخل الاستوديو، إذ لا توجد مساحة تصميم مفتوحة يُطبَّق عليها. وإن كان المشروع مفتوحًا لديك في الاستوديو في الوقت الذي يعدّله فيه عميل MCP، فإن الحفظ التلقائي التالي يُظهر شريط التعارض المعتاد «تغيّر في مكان آخر»، تمامًا كما لو كان زميل قد عدّله — أعد التحميل لالتقاط التغيير الذي أجراه MCP، أو احفظ نسخة للاحتفاظ بتعديلاتك الجارية.

ويُسجَّل كل تعديل عبر MCP أيضًا في سلسلة دردشة المساعد الذكي الخاصة بالمشروع (موسومًا بأنه صادر عن MCP، لا عن لوحة الاستوديو)، فيظهر في السجل نفسه الذي تعرضه لوحة المساعد الذكي داخل الاستوديو.

حدود المعدّل وتوفّر الباقات

• لكل مفتاح API: 60 طلبًا/دقيقة، بمعزل عن المفاتيح الأخرى في الحساب نفسه.
• لكل حساب: يستهلك كل استدعاء أداة من عدّاد شهري واحد (plan.connectorCallsMonthly، منفصل عن حصة الأدوار الخاصة بالمساعد الذكي داخل الاستوديو، لأن استدعاء MCP لا يستدعي أبدًا نموذج ذكاء اصطناعي من جهة MailInApp). وهو متاح بحصة حقيقية في كل باقة، بما فيها المجانية — راجع الأسعار للأرقام الدقيقة، أو استدعِ get_plan_usage لقراءة استهلاك حسابك منذ بداية الشهر الحالي.
• إرسال حملات حقيقية عبر هذا المسار يُحتسب بالطريقة نفسها التي يُحتسب بها confirm_send، مع مسار التأكيد نفسه وحدّ الحجم نفسه.