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 قواعد الواجهة البرمجية نفسها: إلغاء الاشتراك دائمًا؛ وساعات الهدوء وحد عدد الرسائل لقوالب التسويق (قوالب الخدمة لا تخضع لهما)؛ ووضع المراجعة، والرصيد.
- كل ما يرسله المساعد يظهر في موجود كأي حملة أخرى، والردود تذهب إلى الموجود الخاص بك وإلى صندوق الوارد.
- خصص للمساعد مفتاحًا خاصًا به، لتستطيع إلغاءه وحده.