للمطوّرين · يدعم Claude وCursor

دليل تكامل MCP

استخدم Model Context Protocol ليتمكّن Claude أو Cursor أو وكيل الذكاء الاصطناعي الخاص بك من الاطلاع على بياناتك في DEXUN AdWhiz: الحسابات الإعلانية المرتبطة على المنصات الثلاث، وتوصيات الذكاء الاصطناعي، وأحدث النشاطات. للقراءة فقط.

ما هو MCP؟

MCP (Model Context Protocol) معيار مفتوح أطلقته Anthropic عام 2024، يحدّد كيف تصل تطبيقات الذكاء الاصطناعي بأمان إلى البيانات والأدوات الخارجية. تخيّله كـ«منفذ USB-C للذكاء الاصطناعي» — واجهة موحّدة تتيح لأي عميل MCP (Claude Desktop أو Cursor أو وكيلك الخاص) استدعاء أي خادم MCP (DEXUN AdWhiz أو Notion أو GitHub وغيرها).

يوفّر خادم MCP من DEXUN AdWhiz خمس أدوات للقراءة فقط: حساباتك الإعلانية المرتبطة، وتوصيات الذكاء الاصطناعي المفتوحة، وملخص الوفورات، وأحدث نشاطات الحساب، وحصة API الخاصة بك. ولا يمكنه تغيير أي شيء في حساباتك الإعلانية أو إيقافه مؤقتًا أو إنشاؤه. يُوثَّق كل استدعاء بمفتاح API الخاص بك، ويخضع لحدود المعدل نفسها المرتبطة بخطتك في REST API.

البدء السريع

ثلاث خطوات، وخلال نحو خمس دقائق يمكنك سؤال مساعدك الذكي عن حساباتك الإعلانية.

1

إعداد Claude Desktop

عدّل ملف claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/، Windows: %APPDATA%\Claude\) وأضف ما يلي:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

إعداد Cursor

عبر ملف .cursor/mcp.json على مستوى المشروع أو عبر الإعدادات العامة:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

التحقق

أعد تشغيل Claude أو Cursor، ثم جرّب هذه المطالبة. إذا رأيت الذكاء الاصطناعي يستدعي list_ad_accounts أو list_recommendations ويُعيد بياناتك الحقيقية، فقد تمّ الربط بنجاح.

اسأل Claude:

«اعرض حساباتي الإعلانية المرتبطة ولخّص توصيات الذكاء الاصطناعي المفتوحة: ما الحملات التي يقترح تغييرها، ولماذا؟»

كتالوج الأدوات

يتيح خادم MCP خمس أدوات، جميعها للقراءة فقط. لكل أداة مخطط JSON Schema كامل، لذا يقرّر الذكاء الاصطناعي بنفسه متى يستدعي كل أداة.

list_ad_accounts

للقراءة فقط

حساباتك المرتبطة على Google Ads وMeta Ads وTikTok Ads وحالة ربط كل منها.

list_recommendations

للقراءة فقط

توصيات التحسين المفتوحة من الذكاء الاصطناعي (زيادة الميزانية أو خفضها أو الإيقاف المؤقت)، مع السبب والأثر المتوقع ومستوى الثقة لكل توصية.

get_savings_summary

للقراءة فقط

ملخص الوفورات: يحيلك إلى أرقام الوفورات في لوحة التحكم، مع خطتك الحالية.

get_recent_activity

للقراءة فقط

أحدث نشاطات الحساب: عمليات تسجيل الدخول، وتغييرات مفاتيح API، وربط الحسابات الإعلانية، وتغييرات الاشتراك.

get_quota

للقراءة فقط

حد معدل API الحالي: عدد الطلبات في الدقيقة، والمتبقي منها، وموعد إعادة الضبط.

يعرض عميل الذكاء الاصطناعي الأدوات نفسها مع معلماتها عبر طلب tools/list القياسي في MCP.

جلسة نموذجية

محادثة توضيحية (ببيانات افتراضية) تُظهر شكل الوصول للقراءة فقط:

ما الحسابات الإعلانية التي ربطتها بـ AdWhiz؟

لديك 3 حسابات مرتبطة: حساب واحد على كلٍّ من Google Ads وMeta Ads وTikTok Ads، وجميعها في حالة ربط فعّالة.

list_ad_accounts

ما الذي يوصي به الذكاء الاصطناعي الآن؟

هناك توصيتان مفتوحتان: ① خفض الميزانية اليومية لحملة Meta «Lookalike 1%»، إذ ظلّ عائدها على الإنفاق الإعلاني (ROAS) دون متوسط الحساب طوال الأسبوع الماضي؛ ② زيادة ميزانية إحدى حملات TikTok Spark Ads. تتضمّن كل توصية سببها ومستوى الثقة. إن أردت تطبيقهما فافعل ذلك في منصتك الإعلانية — لا يمكنني تغيير أي شيء من هنا.

list_recommendations

هل تغيّر شيء في حسابي مؤخرًا؟

خلال آخر 7 أيام: عمليتا تسجيل دخول، ومفتاح API جديد واحد، وإعادة ربط حساب TikTok Ads. لا توجد سجلات أخرى.

get_recent_activity

الأمان والأذونات

  • الأدوات الخمس كلها للقراءة فقط: يمكن للذكاء الاصطناعي الاطلاع على بياناتك، لكنه لا يستطيع تغيير الميزانيات أو إيقاف الإعلانات مؤقتًا أو إنشاء حملات
  • يعمل خادم MCP محليًا — لا يغادر مفتاح API الخاص بك (dxk_) جهازك إلى أي جهة خارجية
  • تُوثَّق الاستدعاءات بمفتاح API الخاص بك وتتشارك حدود معدل REST API المرتبطة بخطتك (يمكنك التحقق منها عبر get_quota)
  • تُجري التغييرات على حملاتك بنفسك، وليس عبر MCP
  • ألغِ وصول MCP في أي وقت من لوحة التحكم ← الإعدادات ← API Keys