ملفات تعريف الارتباط

نستخدم ملفات تعريف الارتباط لتسجيل الدخول (ضرورية) وللتحليلات (اختيارية). مزيد من التفاصيل - سياسة الخصوصية.

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

ربط Codex بـ ADS Beast

يحفظ Codex خوادم MCP في `~/.codex/config.toml` ويقرأ المفتاح من متغير بيئة تحدده أنت.

أولًا، أنشئ مفتاح API

  1. 1سجّل الدخول إلى ADS Beast وافتح مفاتيح API من القائمة. إنشاء مفتاح يتطلب دور المسؤول.
  2. 2أنشئ مفتاحًا بالصلاحيات التي يحتاجها المساعد فقط. read:* تكفي للاطلاع على البيانات. أضف write:proposals ليتمكن من اقتراح تغييرات وبناء مسودات حملات، وwrite:leads ليتمكن من تحديث العملاء المحتملين.
  3. 3انسخ المفتاح الذي يبدأ بـ absk_. يُعرض مرة واحدة. تلغيه من الشاشة نفسها، والمفتاح الملغى يتوقف عن العمل فورًا.

أضف الخادم بمفتاح

  1. 1احفظ المفتاح في متغير بيئة يبقى بعد إعادة التشغيل، ثم افتح نافذة طرفية جديدة.
  2. 2شغّل الأمر codex mcp add، أو اكتب الكتلة نفسها يدويًا في ~/.codex/config.toml.
  3. 3شغّل codex mcp list للتأكد من وجود adsbeast، ثم شغّل Codex.
macOS, Linux
echo 'export ADSBEAST_API_KEY=absk_your_key' >> ~/.zshrc   # or ~/.bashrc
Windows PowerShell
[Environment]::SetEnvironmentVariable("ADSBEAST_API_KEY", "absk_your_key", "User")
codex mcp add adsbeast --url https://adsbeast.pro/api/mcp/workspace --bearer-token-env-var ADSBEAST_API_KEY
ملف: ~/.codex/config.toml
[mcp_servers.adsbeast]
url = "https://adsbeast.pro/api/mcp/workspace"
bearer_token_env_var = "ADSBEAST_API_KEY"

أو ثبّت الإضافة

  1. 1تضيف الإضافة إلى الخادم مسارات عمل جاهزة: تدقيق الحساب والإنفاق غير المفيد والتقرير الأسبوعي وغيرها.
  2. 2لا تستطيع إضافة Codex حمل المفتاح، لذلك نفّذ أيضًا أمر codex mcp add أعلاه بالاسم نفسه adsbeast. بدونه تردّ الأدوات بالرمز 401 وتذكر ما الناقص.
codex plugin marketplace add notformal/adsbeast-plugins
codex plugin add adsbeast@adsbeast-plugins

تسجيل الدخول بلا مفتاح (OAuth) جاهز، لكنه لم يُفعَّل بعد في بيئة الإنتاج. الخطوات التي تحتاج إليه ستظهر هنا حين يُفعَّل.

شغّلنا هذه الأوامر في Codex CLI وقرأنا ملف الإعداد الذي حفظه. لم نسجّل الدخول إلى Codex، ولذلك لم نستدعِ أداة من داخله.

طلبات أولى للتجربة

  • استدعِ whoami في ADS Beast وأخبرني ما المؤسسة وما الصلاحيات التي يملكها هذا الاتصال.
  • اعرض ملخص لوحة الحملات والتنبيهات غير المقروءة.
  • افحص عنوان Google Ads هذا وفق حدود المنصة: "Plumber in Bratislava, same day".

إذا لم يعمل

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

نفّذنا الأوامر الواردة في هذه الصفحة بأنفسنا بتاريخ 18 نوفمبر 2026، على إعداد نظيف وبمفتاح محدد الصلاحيات، على بيئة الإنتاج. وثائق المورّد