انتقل إلى المحتوى
مستندات المطورينتجريبي

MCP لمساعدي الذكاء الاصطناعي

دع Claude وCursor وChatGPT وغيرها من مساعدي الذكاء الاصطناعي ترسل حملات واتساب عبر موجود، بعد معاينة توافق عليها أولًا.

يشغّل موجود خادم MCP بعيدًا (Model Context Protocol، بنقل Streamable HTTP). اربط مساعد الذكاء الاصطناعي الخاص بك به، ثم اطلب بكلام عادي: «أرسل قالب order_shipped للعملاء في هذا الملف» أو «كيف كانت نتيجة حملة العيد أمس؟».

https://api.mawgood.ai/v1/mcp

يستخدم مفتاح الـ API نفسه وفي الترويسة نفسها: Authorization: Bearer mwg_sk_live_… (مفتاح سري؛ المفاتيح العامة مرفوضة). المفتاح الناقص أو الخاطئ يُرد عليه بـ 401 مع WWW-Authenticate: Bearer. أما تسجيل الدخول عبر OAuth فيأتي لاحقًا.

الخادم بلا جلسات (stateless): أرسل JSON-RPC بـ POST، وGET وDELETE يُرد عليهما بـ 405. يعرّف نفسه باسم mawgood بالإصدار 1.0.0، ويعطي المساعد تعليمات قصيرة (المعاينة أولًا، القوالب المعتمدة فقط، وعدم اختراع قيم المتغيرات أبدًا).

الأدوات

الأداةماذا تفعلالصلاحية
list_numbersأرقام واتساب التي يمكنك الإرسال منها.numbers:read
list_templatesقوالبك (المعتمدة افتراضيًا) وفئاتها ومتغيراتها، بفلاتر الاسم واللغة والفئة.templates:read
preview_campaignتفحص الإرسال دون أن ترسل: المستلمون، وتكلفة الرصيد، والمدة، والعوائق، ورمز تأكيد.campaigns:send
send_campaignترسل حملة تمت معاينتها، وتحتاج رمز التأكيد من preview_campaign.campaigns:send
get_campaign_statusحالة الحملة وأعدادها.campaigns:read
list_recipientsحالة كل رقم، وسبب فشل الرسالة أو تخطيها (فلتر بالحالة، ومؤشر للصفحات، حتى 500 في الصفحة).campaigns:read
cancel_campaignتوقف الحملة.campaigns:send

تأخذ preview_campaign وsend_campaign مدخلات POST /campaigns نفسها (بدون Idempotency-Key). كل نتيجة فيها ملخص نصي قصير، وفي structuredContent الـ JSON نفسه الذي تعيده الواجهة البرمجية. والخطأ يعود كخطأ أداة بكود الواجهة البرمجية ورسالتها (missing_variables، template_not_approved، insufficient_scope…)، ليصحح المساعد المدخلات ويحاول مجددًا. والمورد mawgood://templates يعرض القوالب المعتمدة أيضًا.

المعاينة ثم الإرسال

لا يستطيع المساعد الإرسال بخطوة واحدة. عليه أن يستدعي preview_campaign أولًا، فتعيد كل ما يحتاجه الشخص ليقرر (كم عميلًا سيستلم، وكم سيتم تخطيه ولماذا، وتكلفة الرصيد، والمدة، وأي شيء يمنع الإرسال) ومعها رمز تأكيد. ولا تقبل send_campaign إلا هذا الرمز، فيُرسل بالضبط ما تمت معاينته.

  • الرمز صالح 15 دقيقة، للمفتاح الذي عاين وللمدخلات نفسها بالضبط. غيّر أي شيء (مستلمًا، أو قيمة، أو الاسم) فترد send_campaign بـ confirm_token_mismatch: عاين من جديد.
  • إعادة محاولة send_campaign لا ترسل مرتين أبدًا: مفتاح منع التكرار فيها بصمة للمدخلات (الأرقام بصيغة E.164، والمستلمون بترتيبهم)، فالمدخلات نفسها خلال 24 ساعة تعيد الحملة الأولى (replayed: true). ولإرسال الشيء نفسه مرة أخرى عن قصد، أعطه name مختلفًا.
  • مفاتيح الاختبار (mwg_sk_test_…) تعاين كل شيء، لكن send_campaign ترد بـ test_key_cannot_send.

اجعل القرار لشخص

اجعل مساعدك يستأذنك قبل تشغيل send_campaign، ولا تضفها إلى قائمة «السماح دائمًا». اقرأ المعاينة ثم وافق.

الإعداد

export MAWGOOD_API_KEY=mwg_sk_live_...
claude mcp add --transport http mawgood https://api.mawgood.ai/v1/mcp \
  --header "Authorization: Bearer $MAWGOOD_API_KEY"

ثم شغّل /mcp داخل Claude Code لتتأكد أن mawgood متصل.

معلومات مفيدة

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

في هذه الصفحة