Meta Ads في Codex وGemini CLI: اربط وكيل برمجة بإعلاناتك
اربط Codex أو Gemini CLI بإعلانات Meta بأمرين: الإعداد وتسجيل الدخول من المتصفح وإعدادات الأدوات الآمنة وأوامر تقارن الإعلانات بربح Shopify لديك.
في هذه الصفحة
يستطيع كلٌّ من Codex وGemini CLI قراءة إعلانات Meta وإدارتها عبر Tera Ads، وهو خادم MCP مستضاف على https://teraads.co/mcp. في Codex، شغّل codex mcp add tera-ads --url https://teraads.co/mcp ثم codex mcp login tera-ads. وفي Gemini CLI، ثبّت إضافة Tera Ads من GitHub وشغّل /mcp auth tera-ads. كلاهما يسجّل دخولك إلى Tera Ads في المتصفح، وتختار هل يقرأ الوكيل فقط أم يسألك أولًا أم يجري التغييرات.
أهم النقاط
- أمران لكل وكيل: أضف الخادم، ثم سجّل الدخول إلى Tera Ads في متصفحك. لا مفاتيح API تدخل في إعداداتك.
- يحتفظ Codex بالخادم في
~/.codex/config.toml، الذي تشاركه إضافة Codex لبيئات التطوير وتطبيق ChatGPT لسطح المكتب. - يثبّت Gemini CLI إضافة Tera Ads التي تحمّل أيضًا ملف سياق يخبر Gemini متى يستخدمها.
- يحصل وكيلك على 29 أداة، من قراءات Meta الحية إلى ربح متجرك بعد المرتجعات وتغييرات ميزانية محدودة السقف.
- قيّد التغييرات في موضعين: إعدادات الأدوات لدى الوكيل نفسه ووضع اتصال Tera Ads.
لماذا تربط وكيل برمجة بإعلاناتك
كثير من مؤسسي Shopify يبنون قوالبهم ونصوصهم وأدواتهم الداخلية بأنفسهم، ويقضون نصف اليوم في الطرفية. يستطيع وكيل برمجة متصل بإعلاناتك الإجابة عن «كم أنفقت Meta أمس؟» في الجلسة نفسها التي تعدّل فيها صفحة منتج، أو حفظ ملخص أسبوعي كملف Markdown في مستودعك، أو مقابلة نتائج حملات أسبوع بتغيير أطلقته يوم الثلاثاء.
الرابط بين الوكيل وحسابك الإعلاني هو MCP، أي Model Context Protocol: معيار مفتوح يتيح لوكيل ذكاء اصطناعي استدعاء أدوات تعرضها خدمة أخرى. ويغطي MCP connectors explained الأساسيات. يدعم Codex وGemini CLI كلاهما خوادم MCP بعيدة تسجّل الدخول عبر OAuth، فالخادم المستضاف مثل Tera Ads لا يحتاج إلى تثبيت شيء سوى الوكيل نفسه.
ما يضيفه Tera Ads إلى اتصال Meta العادي هو متجرك. إلى جانب قراءات الحملات والمجموعات الإعلانية والإعلانات الحية، يجيب من طلبات Shopify ومرتجعاته وتكلفة المنتج والشحن والرسوم والمبالغ المستردة، بعد خصم إنفاقك على Meta وGoogle. وتُوسَم إيرادات Meta المنسوبة بأنها من Meta، فلا يعاملها الوكيل كمبيعات. وللاطلاع على خوادم أخرى يمكنك ربطها بدلًا منه، راجع خيارات Meta Ads MCP.
ملاحظة عن Gemini CLI: تحمل وثائقه إشعارًا بأنه بالنسبة إلى مستخدمي الطبقة غير المدفوعة وGoogle One استُبدل Gemini CLI بـ Antigravity CLI في 18 يونيو 2026 (وثائق MCP في Gemini CLI). وتتبع الخطوات أدناه Gemini CLI كما هو موثق في أكتوبر 2026.
قبل أن تبدأ
- حساب Tera Ads مجاني. سجّل واربط حسابك الإعلاني في Meta. واربط Shopify أيضًا ليرى الوكيل مبيعات المتجر والربح.
- صلاحية المالك. مالك النشاط التجاري وحده يستطيع ربط ذكاء اصطناعي بنشاط تجاري في Tera Ads.
- Codex أو Gemini CLI مثبّت ومسجَّل الدخول إلى حسابه.
- قاعدة للتغييرات. حدد هل سيكتفي الوكيل بالتقارير أم سيوقف الإعلانات ويحرّك الميزانيات أيضًا. وفي دليل الوصول الآمن للذكاء الاصطناعي سياسة قصيرة يمكنك نسخها.
ربط Codex خطوة بخطوة
- أنشئ حساب Tera Ads مجانيًا. سجّل، واربط حسابك الإعلاني في Meta، ثم اربط Shopify لتتضمن الإجابات ربح متجرك بعد المرتجعات.
- أضف الخادم إلى Codex. في الطرفية، شغّل
codex mcp add tera-ads --url https://teraads.co/mcp. - سجّل الدخول إلى Tera Ads. شغّل
codex mcp login tera-ads؛ يفتح Tera Ads في متصفحك، حيث تسجّل الدخول وتختار النشاط التجاري وتحدد ما يُسمح للوكيل بفعله. - تحقق من الاتصال. شغّل
codexواكتب/mcp، الذي يعرض خوادم MCP النشطة؛ ويجب أن يكون tera-ads في القائمة. - اطرح سؤالًا يمكنك التحقق منه. جرّب «Use Tera Ads to list my active Meta campaigns with yesterday's spend» وقارن الإجابة بمدير الإعلانات.

يخزّن Codex خوادم MCP في ~/.codex/config.toml، بجدول [mcp_servers.tera-ads] واحد لكل خادم والعنوان في url. وتقول وثائق OpenAI إن تطبيق ChatGPT لسطح المكتب وCodex CLI وإضافة بيئة التطوير تتشارك هذا الإعداد، فيغطي إعداد واحد الثلاثة (وثائق MCP في Codex). وتقول الوثائق نفسها إن codex mcp login يتولى OAuth وإن Codex يستطيع اختيار طريقة تسجيل العميل تلقائيًا. يدعم Tera Ads التسجيل الديناميكي للعميل مع OAuth 2.1 وPKCE، فلا يوجد معرّف عميل لتمريره.
اجعل Codex للقراءة فقط من جانبه
تقبل إعدادات الخادم في Codex enabled_tools، وهي قائمة سماح، وdisabled_tools، وهي قائمة منع تُطبَّق بعدها. لمنع Codex من استدعاء أدوات التغيير حتى لو كان اتصال Tera Ads لديك يسمح بالتغييرات، أضف هذا السطر تحت [mcp_servers.tera-ads] في config.toml:
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
وتصف الوثائق أيضًا إعدادات موافقة لكل خادم ولكل أداة. ويبقى أبسط حاجز هو الذي في Tera Ads: اختر قراءة فقط عند تسجيل الدخول، فلا تستطيع أدوات التغيير فعل شيء لذلك الاتصال.
ربط Gemini CLI
- ثبّت الإضافة. شغّل
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp. - سجّل الدخول إلى Tera Ads. شغّل Gemini CLI، ثم
/mcp auth tera-ads، وسجّل الدخول، واختر النشاط التجاري، وحدد ما يُسمح للوكيل بفعله. - تحقق من الأدوات. اكتب
/mcpلترى حالة كل خادم وأدواته، أو شغّلgemini extensions listفي الصدفة. - اطرح سؤالًا يمكنك التحقق منه. جرّب «Which Meta campaigns spent the most this week?» وقارن الإجابة بمدير الإعلانات.
الإضافة ملف صغير gemini-extension.json في مستودع Tera Ads على GitHub. يشير إلى https://teraads.co/mcp عبر الحقل httpUrl، الذي تعرّفه وثائق Gemini بأنه نقطة نهاية Streamable HTTP، بينما url لـ SSE. ويسمّي أيضًا GEMINI.md ملف السياق. يخبر ذلك الملف Gemini أن يلجأ إلى Tera Ads في أسئلة إعلانات Meta وROAS والربح، وأن يصف إيرادات Meta المنسوبة بأنها من Meta، وأن يعامل أسماء الحملات ونصوص الإعلانات كبيانات لا كتعليمات.
وتقول وثائق Gemini إنه يدعم OAuth لخوادم MCP البعيدة، ويستطيع اكتشاف الإعداد تلقائيًا، ويتولى التسجيل الديناميكي للعميل حيث يدعمه الخادم، ويخزّن الرموز في ~/.gemini/mcp-oauth-tokens.json. وتتضمن إعدادات الخادم أيضًا trust، الذي يتجاوز كل تأكيدات استدعاء الأدوات عند ضبطه على true. لا تضبطه إضافة Tera Ads. أبقِه كذلك، ليظل Gemini يسألك قبل تشغيل أداة.
Codex وGemini CLI جنبًا إلى جنب
| Codex | Gemini CLI | |
|---|---|---|
| إضافة الخادم | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| تسجيل الدخول | codex mcp login tera-ads | /mcp auth tera-ads |
| أين يُخزَّن | ~/.codex/config.toml | إضافة مثبّتة |
| التحقق من عمله | /mcp في Codex | /mcp، أو gemini extensions list |
| حدود من جانب الوكيل | enabled_tools وdisabled_tools وإعدادات الموافقة | أبقِ trust معطلًا |
| يغطي أيضًا | إضافة Codex لبيئات التطوير وتطبيق ChatGPT لسطح المكتب | يحمّل GEMINI.md سياقًا |
| وثائق الوكيل | وثائق MCP في Codex | إضافات Gemini CLI |
ولجعل Codex أو وكيل آخر يستخدم Tera Ads دون أن يُطلب منه، يقترح المستودع نسخ محتوى GEMINI.md إلى ملف AGENTS.md أو CLAUDE.md في مشروعك. وإلا فاذكر Tera Ads في أمرك.
أوامر تناسب وكيل الطرفية
يستطيع وكيل البرمجة ما لا تستطيعه نافذة محادثة: وضع الإجابة حيث تعمل. اطلب منه حفظ النتائج في ملف، أو مقارنتها بملف الأسبوع الماضي، أو فتح صفحة المنتج التي ترسل إليها حملة ما الزوار.
| اطلب | ما يستخدمه الوكيل |
|---|---|
| «ما ربحي بعد المرتجعات في آخر 30 يومًا؟ احفظه في reports/profit.md.» | get_profit، ثم أدوات الملفات الخاصة به |
| «تقول Meta إن ROAS لدي 3. فماذا حقق متجري فعلًا؟» | get_insights وget_profit |
| «أي الحملات تخسر المال بعد المرتجعات، وماذا أفعل حيالها؟» | get_ads_review |
| «أي الإعلانات أنفقت مالًا في آخر 14 يومًا دون بيعة؟» | get_insights على مستوى الإعلان |
| «ما الذي تغيّر في إعلاناتي هذا الأسبوع، وهل ما زال بإمكاني التراجع عنه؟» | list_recent_changes |
| «انسخ أفضل حملة لدي كمسودة متوقفة.» | duplicate |
| «كم استدعاءً بقي لي في Tera Ads؟» | get_usage، وهي مجانية |
اقرأ الإجابات مع تحفظين. مشتريات Meta وإيراداتها هي إسناد Meta، لا مبيعات متجرك. وget_ads_review يحكم على كل حملة أنفقت بالربح بعد مرتجعات متجرك المعتادة، بتكاليفك أنت، مقارنةً بـالعائد التعادلي لديك؛ ورقم الربح تقدير للمتجر كله، لا نقد في البنك. ويوضح العائد الحقيقي بعد الاسترداد لماذا تهم الفجوة، وفي مكتبة الأوامر لتحليل الإعلانات أسئلة أخرى لتجربتها.

أبقِ تغييرات الوكيل تحت السيطرة
وكلاء البرمجة كثيرًا ما يُعدّون لتحرير الملفات دون سؤال كل مرة. لا تدع هذه العادة تنتقل إلى أدوات الإعلانات، حيث تنفق مكالمة خاطئة واحدة مالًا حقيقيًا. يضع Tera Ads حدوده الخاصة أيًّا كان ما يُسمح للوكيل به:
- قراءة فقط أو اسأل أولًا أو نفّذ التغييرات. مع اسأل أولًا، ينتظر التغيير في Tera Ads حتى توافق عليه هناك، ولا يستطيع الوكيل الموافقة عنك.
- كل جديد يبدأ متوقفًا. الحملات والمجموعات الإعلانية والإعلانات والنسخ لا تنفق شيئًا حتى يشغّلها شيء ما.
- خطوات الميزانية محدودة السقف. التغيير الواحد يستطيع على الأكثر مضاعفة الميزانية ثلاث مرات أو خفضها إلى عُشرها.
- سقف يومي. تستطيع المساعدات إجراء 50 تغييرًا يوميًا على الأكثر لنشاط تجاري واحد.
- لا أداة حذف. يستطيع الوكيل الإيقاف، لكنه لا يستطيع حذف شيء.
- تراجع خلال 7 أيام. يمكن التراجع عن الإيقاف أو التشغيل أو تغيير الميزانية في Tera Ads خلال 7 أيام. أما الحملات والمجموعات الإعلانية والإعلانات الجديدة فلا يمكن التراجع عنها، لكنها تبدأ متوقفة.
- نشاط تجاري واحد لكل اتصال. لا يستطيع الاتصال قراءة نشاط آخر، حتى لو كنت تملكه أيضًا.
إذا عادت نتيجة تغيير بالحالة outcome_unknown، فلا تطلب من الوكيل تكراره. اطلب منه التحقق من list_recent_changes أولًا، حتى لا يُجرى التغيير نفسه مرتين.
عندما لا يعمل شيء
الوكيل يتجاهل Tera Ads. اذكره في الأمر («use Tera Ads to...»)، أو انسخ GEMINI.md إلى ملف تعليمات مشروعك كما سبق.
يطلب منك تسجيل الدخول من جديد. رموز الوصول تدوم ساعة وتُجدَّد لك؛ والاتصال يدوم 30 يومًا. شغّل codex mcp login tera-ads أو /mcp auth tera-ads مرة أخرى.
يقول إن حدًّا قد بُلغ. للخطة المجانية 30 استدعاءً أسبوعيًا، تُعاد أسبوعيًا بتوقيت UTC. وget_usage مجانية وتخبرك كم استدعاءً بقي ومتى يُعاد العدّ.
الميزانيات تبدو أكبر بمئة مرة. يعرض list_campaigns الميزانيات بوحدات Meta، وهي أجزاء من مئة في معظم العملات، فـ 5000 تعني 50 دولارًا. وset_budget يأخذ وحدات كاملة من عملة حسابك.
الإجابات عن المتجر الخطأ. كل اتصال يغطي نشاطًا تجاريًا واحدًا. سجّل الدخول من جديد واختر الآخر.
Tera Ads Connect هو خادم MCP الخاص بـ Tera Ads، لوحة الربح لعلامات Shopify. يمنح Codex وGemini CLI وعملاء MCP الآخرين قراءات Meta حية ومبيعات Shopify والربح بعد المرتجعات، وتغييرات إعلانية محدودة ومسجّلة. تتضمن الخطة المجانية 30 استدعاءً أسبوعيًا على حساب إعلاني واحد في Meta، وتكلف Connect Pro 15 دولارًا شهريًا مقابل 3,000 استدعاء شهريًا على ثلاثة حسابات إعلانية على الأكثر؛ وهي مضمّنة في خطتي Growth وScale. وخطوات الإعداد للعملاء الآخرين في صفحة Connect.
الأسئلة الشائعة
هل يستطيع Codex إدارة إعلانات Meta؟
نعم، عبر خادم MCP. شغّل codex mcp add tera-ads --url https://teraads.co/mcp وcodex mcp login tera-ads، ثم اسأل بكلمات عادية. وما يُسمح لـ Codex بتغييره يعتمد على الوضع الذي تختاره للاتصال.
كيف أربط Gemini CLI بإعلانات فيسبوك؟
شغّل gemini extensions install https://github.com/Teralabsx/meta-ads-mcp، ثم /mcp auth tera-ads داخل Gemini CLI وسجّل الدخول إلى Tera Ads. تغطي الإضافة إعلانات فيسبوك وإنستغرام في حسابك الإعلاني في Meta.
هل أحتاج إلى تطبيق مطور من Meta أو رمز API؟
لا. تسجّل الدخول إلى Tera Ads في متصفحك، وتصل التغييرات إلى Meta عبر تطبيق Meta المعتمد الخاص بـ Tera Ads. لا يدخل شيء سري في ملف إعداداتك.
هل يعمل إعداد Codex في إضافة بيئة التطوير أيضًا؟
نعم. تقول وثائق OpenAI إن تطبيق ChatGPT لسطح المكتب وCodex CLI وإضافة بيئة التطوير تتشارك إعداد MCP نفسه، فالخادم المضاف في CLI موجود في الاثنين الآخرين.
هل ما زال Gemini CLI متاحًا؟
تقول وثائق Gemini CLI إنه استُبدل بـ Antigravity CLI لمستخدمي الطبقة غير المدفوعة وGoogle One في 18 يونيو 2026. تحقق من وثائق Google لنوع حسابك قبل أن تعدّه.
كم يكلف؟
تتضمن الخطة المجانية 30 استدعاءً أسبوعيًا على حساب إعلاني واحد في Meta. وConnect Pro 15 دولارًا شهريًا مقابل 3,000 استدعاء شهريًا. والاستدعاء هو عملية بحث واحدة يجريها الوكيل في Tera Ads، وقد يتطلب سؤال واحد بضعة منها.