هل تستطيع أن تسأل مساعد الذكاء الاصطناعي: «أين زاد الإنفاق، وأي حملة جلبت حجوزات حضرت فعليًا؟» نعم، لكن الإجابة الموثوقة تحتاج شيئين: صلاحية آمنة لقراءة بيانات الحساب، وتعريف واضح للنتيجة التي تريد قياسها. هذا دليل عملي لتوصيل الحسابات التي تديرها، وبناء تقرير أولي قبل التفكير في أي أتمتة للإنفاق.
حالة التوثيق: 22 نوفمبر 2026. توفر الموصلات يختلف حسب المنصة وبلد الحساب ونوعه وعميل الذكاء الاصطناعي. راجع الروابط الرسمية قبل تنفيذ الربط، خصوصًا في النسخ التجريبية.
1. افصل بين API وMCP وعميل الذكاء الاصطناعي

تصميم توضيحي أصلي. وصول العميل إلى خادم MCP وإذن الوصول للحساب الإعلاني قد يكونان منفصلين. أرسل تقارير مجمعة فقط، وليس سجلات المرضى.
واجهة Ads API هي الطريق الذي توفره منصة الإعلان لقراءة بياناتها أو تعديلها وفق الصلاحيات. خادم MCP يعرّف أدوات يستطيع المساعد اكتشافها واستدعاءها؛ مثالها «اقرأ أداء الحملات لهذا الحساب خلال هذه الفترة». أما العميل فهو التطبيق الذي تستخدمه، مثل Codex أو عميل يدعم MCP. المسار المعتاد: الميديا باير ← عميل الذكاء الاصطناعي ← أداة MCP ← منصة الإعلان.
ابدأ بموصل المنصة الرسمي عند توفره للعميل والحساب. قد يكون عنوانًا تستضيفه المنصة، أو برنامجًا رسميًا تشغّله بنفسك مثل Google Ads. إن لم تجد موصل حساب مناسبًا، يمكن لمطوّر بناء محوّل صغير فوق الـAPI أو استخدام مزود موثوق بعد مراجعة ما يجمعه ويخزّنه. الموصل الذي يقرأ التوثيق ليس موصلًا لحسابات الإعلان، وبيانات إدارة الحساب ليست مكتبة لإعلانات المنافسين.
2. اربط حسابًا واحدًا بصلاحيات قراءة فقط
- حدّد الحساب، العملة، المنطقة الزمنية ومن يملك إذن الوصول. للوكالة، اعزل العملاء عن بعضهم؛ لا تعطِ خادمًا واحدًا صلاحية شاملة لمجرد سهولة الإعداد.
- سجِّل الدخول في صفحة الموافقة الرسمية للمنصة عبر OAuth حيث يلزم. تحقّق من نطاق الصلاحية ودور الحساب. مفتاح OpenAI مختلف عن رمز Facebook أو LinkedIn أو X؛ لا تلصق أيًا منها في الشات أو الكود أو ملفات Git.
- اسمح بأدوات القراءة المحددة فقط، واعطل الكتابة من الخادم نفسه أو من صلاحيات الرمز إن أمكن. عبارة «لا تعدّل» في البرومبت وحدها ليست حماية. وحتى أدوات القراءة قد تكشف بيانات تجارية حساسة.
- اختبر حسابًا واحدًا وفترة مكتملة. قارن صفًا واحدًا من التكلفة والنقرات مع مدير الإعلانات، ثم وسّع الاختبار. اسم الأداة قد يتغير حسب النسخة؛ راجع قائمة الأدوات في عميلك قبل إعداد قائمة السماح.
3. اطلب تحليلًا يمكن التحقق منه
جرّب: «اعرض الإنفاق والظهور والنقرات والتحويلات المبلّغ عنها لكل حملة في آخر سبعة أيام مكتملة. اذكر الحساب والعملة والمنطقة الزمنية ونافذة الإسناد. لا تجمع عملات مختلفة ولا تعدّل الحساب. علّم الأرقام غير المتاحة بدل اعتبارها صفرًا.»
احسب CTR من النقرات ÷ الظهور، وCPC من الإنفاق ÷ النقرات. عند دمج صفوف أو أيام أعد الحساب من المجاميع بدل أخذ متوسط نسب الصفوف. ولا تقارن CPA بين منصتين قبل توحيد تعريف التحويل والنافذة والفترة؛ تحويل المنصة ليس بالضرورة حجزًا مؤكدًا، ولا الحجز زيارة مكتملة. في التسويق الطبي اعرض أعدادًا مجمّعة مثل عدد الحجوزات المؤكدة والزيارات المكتملة لكل حملة، داخل بيئة مصرح بها. لا ترسل أسماء أو أرقام مرضى أو تشخيصات أو سجلات فردية للمساعد أو مزود الموصل.
4. من التجربة إلى الربط الفعلي
ابدأ من مجلد `code` بتجربة محلية ببيانات اصطناعية. لا تحتاج مفتاح إعلان أو OpenAI لتشغيل اختبار MCP. بعدها استخدم ملف إعداد Codex لربط الخادم المحلي، أو اتبع خطوات الموصل الرسمي في الملحق. محوّل LinkedIn الاختياري يقرأ حملة عبر صلاحية `r_ads_reporting` وحساب موجود في قائمة السماح؛ يحتاج وصول API فعليًا. مثال OpenAI المنفصل يوضح الاتصال بخادم X البعيد بأداة قراءة واحدة وموافقة بشرية. لا تنقل إعداد `stdio` المحلي إلى حقل عنوان HTTPS؛ هما طريقتان مختلفتان للاتصال.
الربط حسب المنصة
Google Ads
تشغيل رسمي محلي أو نشر ذاتي عبر Streamable HTTP. فعّل Google Ads API في مشروع Cloud مخوّل، واضبط ADC للحساب وصلاحية الإعلان. عطّل assets وlabels بملف YAML واستخدم search_search. أضف معرف حساب المدير عند الحاجة.
Meta Ads
خادم Meta: https://mcp.facebook.com/ads. استخدم الموصل المدعوم أو موافقة OAuth لتطبيقك. لمسار التطبيق راجع ads_mcp_management وads_read، واختر أدوات التقرير فقط. جرّب عرض الحملات الأعلى إنفاقًا.
TikTok Ads
MCP رسمي للقراءة والكتابة. استخدم مسار OAuth المدعوم، وابدأ بعنوان progressive أدناه وأداة التقارير فقط. الفرق بين flat وprogressive في اكتشاف الأدوات، وليس عزل الصلاحيات.
Snap Ads
خادم رسمي للقراءة فقط: https://mcp.snapchat.com/ads. عند طلبه، يعتمد المسؤول اتصال المؤسسة، ثم يفوض المستخدم وصوله القائم من عميل مدعوم. جرّب الإنفاق والظهور لحساب واحد.
Microsoft Advertising
خادم رسمي https://partner.api.bingads.microsoft.com/ext/mcp/vnext. استخدم Microsoft Entra OAuth وخطوات العميل المحدد. أدواته موثّقة كقراءة فقط رغم اسم النطاق msads.manage. استخدم get_campaigns.
Amazon Ads
MCP رسمي في open beta لشركاء Ads API المؤهلين. خذ إعداد Lite وعنوانه من دليل Amazon المرتبط، وأكمل موافقة Ads منفصلة عن Seller Central. Lite لا يعني قراءة فقط؛ ابدأ باستكشاف الحسابات ثم التقرير.
LinkedIn Ads
تطبيق ChatGPT للقراءة في beta، بحسب الأهلية. لم أتحقق من عنوان MCP عام لكل العملاء. للربط المخصص استخدم Advertising API وOAuth العضو وr_ads_reporting؛ المرفق يعرض GET /rest/adAnalytics.
X Ads
خادم رسمي https://ads-api.x.com/mcp. استخدم OAuth المستخدم بنطاق ads.read وأضف offline.access عند الحاجة للتجديد، بدون ads.write. ابدأ بـlist_ads_accounts. مثال OpenAI في المرفق.
TikTok progressive MCP
https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layerشغّل التجربة المحلية
نفّذ الأوامر من المجلد المستخرج. اختبار stdio لا يتصل بمنصة إعلانات. بعده اختر إدخال ads_demo من ملف TOML، وغيّر المسارات إلى مسارات جهازك. اطلب تقرير الحساب demo من 2026-11-01 إلى 2026-11-07. استخدم LinkedIn الفعلي فقط بعد تحميل الرمز من مخزن الأسرار وتحديد ADS_SOURCE=linkedin وLINKEDIN_AD_ACCOUNTS وLINKEDIN_VERSION المدعوم. الإخراج التعليمي محدود؛ لا تعتبره إجمالي الحساب.
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r code/requirements.txt
python code/smoke_test.pyملفات الكود والخطوة التالية
- `Codex Examples.toml`: إعداد Codex للخادم المحلي وGoogle وX.
- `Google Read Only.yaml + Google Campaign Report.gaql`: قائمة أدوات قراءة من Google واستعلام GAQL للـAPI؛ لا تمرّر GAQL الخام لأداة MCP إذا كان مخططها يطلب حقولًا منظّمة.
- `Meta Insights.sh`: طلب Graph API اختياري مستقل عن MCP؛ يقرأ صفحة واحدة فقط.
- `OpenAI Remote Example.py`: OpenAI Responses API: عنوان HTTPS ورمز OAuth وأداة واحدة. عند طلب الموافقة توقف حتى يراجع المشغّل الاستدعاء؛ المثال لا يوافق عليه تلقائيًا.
- Codex MCP setup · OpenAI remote MCP · Approval flow
- LinkedIn Ads app · TikTok OAuth · Microsoft tool schemas · Meta Insights API
ربط Snapchat مع Codex
شغّل الأمرين على جهاز Codex نفسه، ثم أكمل موافقة Snapchat بنفسك. النطاق الموثّق للموصل هو snapads.read. إذا لم يُعتمد العميل لمؤسستك، يحتاج اعتماد مسؤول المؤسسة.
codex mcp add snap-ads --url https://mcp.snapchat.com/ads --oauth-client-id codex-snap-ads
codex mcp login snap-adsSnap for Developers: client setup
اختُبر الوضع التجريبي ببيانات اصطناعية، ومحوّل LinkedIn بمحاكاة. لم يُختبر أي حساب إعلاني حي.

التعليقات
لا توجد تعليقات منشورة بعد.