انتقل إلى المحتوى
الذكاء الاصطناعي للإعلانات

Meta Ads MCP في Cursor وVS Code وClaude Code: دليل الإعداد

اربط Meta Ads بـ Cursor أو VS Code أو Claude Code بعنوان MCP واحد: الإعداد الدقيق لكل محرر، وكيف يعمل تسجيل الدخول، وكيف تُبقي تغييرات الإعلانات في يدك.

آخر تحديث 9 دقائق للقراءةبقلم Tera Ads editorial teamتم التحقق من الحقائق

متوفر أيضًا بـ English · Español · Português · Deutsch · Français · Italiano · Bahasa Indonesia · Nederlands · Türkçe · Polski · 日本語 · 한국어 · 简体中文 · 繁體中文 · हिन्दी · עברית · Русский · Українська · Svenska · Dansk · Norsk bokmål · Suomi · Čeština · Română · Magyar · Ελληνικά · ไทย · Tiếng Việt · Bahasa Melayu · Filipino · Български · Slovenčina · Hrvatski · Lietuvių · Slovenščina

في هذه الصفحة
  1. لماذا تربط Meta Ads بمحرر الشيفرة
  2. قبل أن تبدأ
  3. الإعداد في خمس خطوات
  4. Cursor
  5. VS Code
  6. Claude Code
  7. المحررات الثلاثة جنبًا إلى جنب
  8. ماذا تسأل أولًا
  9. أبقِ تغييرات الإعلانات تحت سيطرتك
  10. عندما لا يعمل شيء
  11. الأسئلة الشائعة

يمكنك وضع Meta Ads داخل Cursor أو VS Code أو Claude Code بإضافة عنوان خادم MCP بعيد واحد، https://teraads.co/mcp، وتسجيل الدخول إلى Tera Ads في متصفحك. لا شيء لتثبيته أو استضافته. يأخذ Cursor وVS Code مدخلًا قصيرًا بصيغة JSON، ويأخذ Claude Code أمرًا واحدًا، ثم تستطيع المحررات الثلاثة قراءة حملاتك الحية وربح متجر Shopify بعد المرتجعات. وتختار لكل اتصال هل يقرأ ذكاؤك الاصطناعي فقط أم يسألك أولًا أم يجري التغييرات.

أهم النقاط

  • عنوان واحد يعمل في المحررات الثلاثة: https://teraads.co/mcp، خادم MCP مستضاف بتسجيل دخول من المتصفح ودون مفاتيح API في إعداداتك.
  • يقرأ Cursor الملف ~/.cursor/mcp.json لكل المشاريع أو .cursor/mcp.json لمشروع واحد؛ ويستخدم VS Code الأمر MCP: Add Server أو .vscode/mcp.json.
  • يحتاج Claude Code إلى أمر claude mcp add واحد، أو إضافة تضيف الخادم مع ست مهارات إعلانية جاهزة.
  • يحصل ذكاؤك الاصطناعي على 29 أداة: قراءات Meta الحية، وربح متجرك بعد المرتجعات، والإيقاف والتشغيل وتغييرات الميزانية ضمن حدود ثابتة.
  • حدّد ما يُسمح للذكاء الاصطناعي بفعله قبل أن تتصل: قراءة فقط أو اسأل أولًا أو نفّذ التغييرات.

لماذا تربط Meta Ads بمحرر الشيفرة

إذا كنت تبني قالب Shopify أو نصوصه أو أدواتك الداخلية بنفسك، فمحررك هو المكان الذي تقضي فيه يومك أصلًا. يستطيع وكيل ذكاء اصطناعي هناك الإجابة عن سؤال إعلاني دون رحلة إلى مدير الإعلانات، أو كتابة الإجابة في ملف داخل مستودعك، أو التحقق مما إذا كانت صفحة الهبوط التي غيّرتها للتو هي التي ترسل إليها أفضل إعلاناتك الزوار.

MCP، أي Model Context Protocol، هو المعيار المفتوح الذي يجعل ذلك ممكنًا: يستدعي وكيل المحرر أدوات يعرضها خادم، ويتحدث الخادم إلى منصة الإعلانات. ويشرح MCP connectors explained كيف يعمل. تذكر وثائق Cursor أن stdio وSSE وStreamable HTTP أنواع نقل مدعومة، وتقول إنه يدعم OAuth للخوادم التي تحتاجه (وثائق MCP في Cursor). ويسجّل Claude Code الدخول إلى الخوادم البعيدة عبر OAuth بأمره /mcp (وثائق MCP في Claude Code). فالخادم المستضاف لا يحتاج إلى مفاتيح تُلصق في ملف إعداد.

Tera Ads Connect خادم من هذا النوع، مبني لعلامات Shopify. إلى جانب قراءات Meta الحية، يجيب من متجرك: الطلبات والمرتجعات وتكلفة المنتج والشحن والرسوم والمبالغ المستردة، بعد خصم إنفاقك على Meta وGoogle. وتُوسَم إيرادات Meta المنسوبة بأنها من Meta، فلا يظنها ذكاؤك الاصطناعي مبيعات. وإن أردت صورة أوسع عن الخوادم التي يمكنك استخدامها بدلًا منه، فيقارن خيارات Meta Ads MCP بينها.

قبل أن تبدأ

  • حساب Tera Ads مجاني. سجّل واربط حسابك الإعلاني في Meta. واربط Shopify أيضًا ليرى ذكاؤك الاصطناعي مبيعات المتجر والربح.
  • صلاحية المالك. مالك النشاط التجاري وحده يستطيع ربط ذكاء اصطناعي بنشاط تجاري في Tera Ads.
  • محررك. Cursor، أو VS Code مع عرض المحادثة فيه، أو Claude Code في الطرفية.
  • قرار بشأن التغييرات. حدد هل سيكتفي الذكاء الاصطناعي بالتقارير أم سيوقف الإعلانات ويغيّر الميزانيات أيضًا. وفي دليل الوصول الآمن للذكاء الاصطناعي سياسة قصيرة يمكنك نسخها.

الإعداد في خمس خطوات

  1. أنشئ حساب Tera Ads مجانيًا. سجّل، واربط حسابك الإعلاني في Meta، ثم اربط Shopify لتتضمن الإجابات ربح متجرك بعد المرتجعات.
  2. أضف عنوان الخادم إلى محررك. الصق https://teraads.co/mcp في إعدادات MCP في Cursor أو VS Code، أو شغّل أمرًا واحدًا في Claude Code؛ وتعطي الأقسام أدناه المدخل الدقيق لكل منها.
  3. سجّل الدخول إلى Tera Ads في متصفحك. يفتح المحرر Tera Ads، حيث تسجّل الدخول وتختار النشاط التجاري الواحد الذي ستشاركه.
  4. اختر ما يُسمح لذكائك الاصطناعي بفعله. اختر قراءة فقط أو اسألني أولًا أو نفّذ التغييرات لهذا الاتصال؛ ويمكنك التبديل بين الأخيرين لاحقًا ضمن AI connections في Tera Ads.
  5. اطرح سؤالًا يمكنك التحقق منه. ابدأ بشيء مثل «كم أنفقت على Meta أمس؟» وقارن الإجابة بمدير الإعلانات قبل أن تعتمد على أي شيء أكبر.
كيف يتصل محرر بـ Tera Ads: أضف العنوان، وسجّل الدخول، واختر النشاط والوضع، ثم اسأل
كيف يتصل محرر بـ Tera Ads: أضف العنوان، وسجّل الدخول، واختر النشاط والوضع، ثم اسأل

يستخدم تسجيل الدخول OAuth 2.1 مع PKCE، ويدعم الخادم التسجيل الديناميكي للعميل، فيسجّل محررك نفسه ولا تتعامل أبدًا مع معرّف عميل أو سرّ. ويخزّن Tera Ads الرموز في صورة تجزئات أحادية الاتجاه فقط. تدوم رموز الوصول ساعة وتُجدَّد لك؛ ويدوم الاتصال 30 يومًا قبل أن تسجّل الدخول من جديد.

Cursor

يقرأ Cursor خوادم MCP من ملف JSON. تقول وثائقه إن ~/.cursor/mcp.json في مجلدك الرئيسي يجعل الأدوات متاحة في كل مكان، و.cursor/mcp.json داخل مشروع يقصرها على ذلك المشروع (وثائق MCP في Cursor). أضف هذا المدخل، وهو نفسه الذي ينشره Tera Ads باسم configs/cursor/mcp.json في مستودعه على GitHub:

{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}

إذا كان الملف يدرج خوادم أخرى بالفعل، فأضف مدخل "tera-ads" داخل الكائن mcpServers الموجود بدل استبداله. وعندما يسألك Cursor، سجّل الدخول إلى Tera Ads في متصفحك. لا مفتاح API ولا ترويسة لإضافتها.

افتراضيًا، يطلب Cursor الموافقة قبل أن يستخدم أداة MCP. وتصف وثائقه أيضًا وضع الأدوات في قائمة سماح لتعمل دون سؤال. إذا استخدمت ذلك، فضع في قائمة السماح أدوات القراءة فقط مثل get_insights وget_profit، وأبقِ أدوات التغيير (pause وresume وset_budget وduplicate وأدوات الإنشاء) خلف سؤال.

VS Code

يمنحك VS Code طريقين:

  • MCP: Add Server. افتح Command Palette، وشغّل MCP: Add Server، واختر HTTP، والصق https://teraads.co/mcp وأعطِ الخادم المعرّف tera-ads.
  • ملف مساحة العمل. أضف المدخل من configs/vscode/mcp.json في المستودع إلى .vscode/mcp.json: {"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. يستخدم VS Code الحقل servers حيث يستخدم Cursor الحقل mcpServers، فلا تنسخ ملف محرر إلى الآخر.

توجّه وثائق MCP في VS Code الإعدادات الجديدة الآن عبر مسارها الموجَّه، وتقول إن ملفات .vscode/mcp.json في مساحة العمل تبقى متاحة للتوافق، فكلا الطريقين يعمل. شغّل الخادم، وسجّل الدخول إلى Tera Ads عندما يطلب VS Code، ثم فعّل Tera Ads ضمن Configure Tools في خانة إدخال المحادثة. وتنصح وثائق VS Code بالموافقة فقط على الإجراءات التي تفهمها، وهذه هي العادة الصحيحة مع أي طلب يمس ميزانية.

Claude Code

أمر واحد يضيف الخادم:

claude mcp add --transport http tera-ads https://teraads.co/mcp

شغّل Claude Code، واكتب /mcp، واختر tera-ads وسجّل الدخول إلى Tera Ads في متصفحك. تقول وثائق Claude Code إن /mcp يشغّل تسجيل دخول OAuth وإن الرموز تُخزَّن وتُجدَّد تلقائيًا؛ وclaude mcp list يبيّن هل كل خادم متصل أم يحتاج إلى مصادقة.

يُضاف الخادم افتراضيًا في النطاق المحلي: لك وحدك، وفي المشروع الحالي فقط. أضف --scope user ليكون في كل مشاريعك، أو --scope project لكتابته في ملف .mcp.json يُشارَك عبر التحكم بالإصدارات. الملف المشترك لا يشارك إلا العنوان. يسجّل كل شخص دخوله على حدة، ومالك النشاط التجاري وحده يستطيع ربط ذكاء اصطناعي بنشاط في Tera Ads.

الإضافة مع ست مهارات

لإضافة الخادم مع سير عمل جاهزة، ثبّت Tera Ads كإضافة بدلًا من ذلك. شغّل claude plugin marketplace add Teralabsx/meta-ads-mcp، ثم claude plugin install tera-ads@tera-ads. تقول وثائق الإضافات في Claude Code إن الإضافة تضيف مهاراتها ووكلاءها وخطافاتها وخوادم MCP، وإن مهاراتها تظهر بالصيغة /<plugin>:<skill>، فأول مهارة أدناه هي /tera-ads:profit-check.

المهارات الست في إضافة Tera Ads لـ Claude Code، كما هي مدرجة في مستودعها على GitHub في أكتوبر 2026.
المهارةما تفعله
profit-checkتضع أرقام Meta بجانب ربح متجرك بعد المرتجعات
weekly-ads-reviewتقارن هذا الأسبوع بالأسبوع الماضي وتقترح تغييرات دون أن تجري أيًّا منها
pause-wasted-spendتجد الإعلانات التي تنفق دون مبيعات وتوقف التي تختارها
scale-a-winnerترفع ميزانية إعلان رابح بخطوات آمنة، أو تنسخه كمسودة متوقفة
launch-paused-campaignتبني حملة ومجموعة إعلانية وإعلانًا كاملة، كلها متوقفة، لتراجعها
refresh-ad-copyتكتب نسخًا جديدة من إعلان مُجهَد كإعلانات متوقفة بجانبه

وتقول الوثائق نفسها إن الإضافات من أسواق الأطراف الثالثة لا تُحدَّث تلقائيًا افتراضيًا. للحصول على نسخة جديدة، شغّل claude plugin update tera-ads@tera-ads.

المحررات الثلاثة جنبًا إلى جنب

إعداد Tera Ads في Cursor وVS Code وClaude Code، من وثائق كل محرر ومستودع Tera Ads، روجع في 31 أكتوبر 2026.
CursorVS CodeClaude Code
أين يوضع الإعداد~/.cursor/mcp.json أو .cursor/mcp.jsonMCP: Add Server، أو .vscode/mcp.jsonclaude mcp add، في النطاق المحلي أو المستخدم أو المشروع
صيغة المدخلmcpServers مع urlservers مع "type": "http" وurlأمر واحد، لا ملف لتحريره
تسجيل الدخولالمتصفح، عندما يسأل Cursorالمتصفح، بعد تشغيل الخادم/mcp، ثم المتصفح
قبل أول استخداملا شيء آخرفعّله ضمن Configure Toolsلا شيء آخر
إضافاتلا شيءلا شيءإضافة بست مهارات
وثائق المحررCursorVS CodeClaude Code

ماذا تسأل أولًا

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

أسئلة أولى لتطرحها في محررك، مع أدوات Tera Ads التي يستخدمها كل منها.
اسألما يبحث عنه ذكاؤك الاصطناعي
«أي الحملات أنفقت أكثر هذا الأسبوع، وماذا جلبت؟»get_insights
«ما ربحي بعد المرتجعات في آخر 30 يومًا؟»get_profit
«تقول Meta إن ROAS لدي 3. فماذا حقق متجري فعلًا؟»get_insights وget_profit
«أي الحملات تخسر المال بعد المرتجعات، وماذا أفعل حيالها؟»get_ads_review
«أي الإعلانات أنفقت مالًا في آخر 14 يومًا دون بيعة؟»get_insights على مستوى الإعلان
«ما الذي تغيّر في إعلاناتي هذا الأسبوع، وهل ما زال بإمكاني التراجع عنه؟»list_recent_changes

أمران تضعهما في بالك عند قراءة الإجابات. أولًا، مشتريات Meta وإيراداتها هي إسناد Meta، لا مبيعات متجرك؛ ويشرح لماذا تختلف Meta Ads وShopify الفجوة. وثانيًا، يحكم get_ads_review على كل حملة أنفقت بالربح بعد مرتجعات متجرك المعتادة، بتكاليفك أنت، مقارنةً بـالعائد التعادلي لديك. والربح نفسه تقدير للمتجر كله، مبني على طلباتك بإعداد هامشك، لا نقد في البنك.

أبقِ تغييرات الإعلانات تحت سيطرتك

تُضبط التغييرات في موضعين: محررك، الذي يستطيع السؤال قبل تشغيل كل أداة، وTera Ads، الذي يقرر ما يُسمح للاتصال بفعله أصلًا.

  • قراءة فقط أو اسأل أولًا أو نفّذ التغييرات. مع اسأل أولًا، ينتظر التغيير في Tera Ads حتى توافق عليه هناك، ولا يستطيع ذكاؤك الاصطناعي الموافقة عنك.
  • كل جديد يبدأ متوقفًا. الحملات والمجموعات الإعلانية والإعلانات والنسخ لا تنفق شيئًا حتى يشغّلها شيء ما.
  • خطوات الميزانية محدودة السقف. التغيير الواحد يستطيع على الأكثر مضاعفة الميزانية ثلاث مرات أو خفضها إلى عُشرها.
  • سقف يومي. تستطيع المساعدات إجراء 50 تغييرًا يوميًا على الأكثر لنشاط تجاري واحد.
  • لا أداة حذف. يستطيع ذكاؤك الاصطناعي الإيقاف، لكنه لا يستطيع حذف شيء.
  • تراجع خلال 7 أيام. يمكن التراجع عن الإيقاف أو التشغيل أو تغيير الميزانية في Tera Ads خلال 7 أيام. أما الحملات والمجموعات الإعلانية والإعلانات الجديدة فلا يمكن التراجع عنها، لكنها تبدأ متوقفة.
  • نشاط تجاري واحد لكل اتصال. لا يستطيع الاتصال قراءة نشاط آخر، حتى لو كنت تملكه أيضًا.
طبقتان من التحكم: ما يفحصه محررك وما يفرضه Tera Ads
طبقتان من التحكم: ما يفحصه محررك وما يفرضه Tera Ads

تصل أسماء الحملات ونصوص الإعلانات إلى ذكائك الاصطناعي كبيانات، ويطلب منه Tera Ads ألا يتبع التعليمات داخلها. وتذكر وثائق Claude Code النقطة العامة أيضًا: الخوادم التي تجلب محتوى خارجيًا قد تعرّضك لحقن الأوامر، فاربط الخوادم الموثوقة فقط. وإن أردت رؤية كل تغيير قبل أن يحدث، فاختر اسأل أولًا.

عندما لا يعمل شيء

يقول الخادم إنه يحتاج إلى تسجيل دخول. في Claude Code، شغّل /mcp واختر tera-ads؛ ويبيّن claude mcp list أنه يحتاج إلى مصادقة حتى تفعل. وفي Cursor وVS Code، أعد تشغيل الخادم وأكمل تسجيل الدخول في المتصفح.

لا تظهر الأدوات في محادثة VS Code. افتح Configure Tools في خانة إدخال المحادثة وفعّل Tera Ads.

يقول ذكاؤك الاصطناعي إن حدًّا قد بُلغ. للخطة المجانية 30 استدعاءً أسبوعيًا، تُعاد أسبوعيًا بتوقيت UTC. اطلب من ذكائك الاصطناعي تشغيل get_usage، وهي مجانية وتخبرك كم استدعاءً بقي ومتى يُعاد العدّ.

الميزانيات تبدو أكبر بمئة مرة. يعرض list_campaigns الميزانيات بوحدات Meta، وهي أجزاء من مئة في معظم العملات، فـ 5000 تعني 50 دولارًا. وset_budget يأخذ وحدات كاملة من عملة حسابك.

الإجابات عن المتجر الخطأ. كل اتصال يغطي نشاطًا تجاريًا واحدًا. اربط من جديد واختر النشاط الآخر.

Tera Ads Connect هو خادم MCP الخاص بـ Tera Ads، لوحة الربح لعلامات Shopify. يمنح محررك قراءات Meta حية ومبيعات Shopify والربح بعد المرتجعات، وتغييرات إعلانية محدودة ومسجّلة. تتضمن الخطة المجانية 30 استدعاءً أسبوعيًا على حساب إعلاني واحد في Meta، وتكلف Connect Pro ‏15 دولارًا شهريًا مقابل 3,000 استدعاء شهريًا على ثلاثة حسابات إعلانية على الأكثر؛ وهي مضمّنة في خطتي Growth وScale. وخطوات الإعداد لكل العملاء في صفحة Connect.

الأسئلة الشائعة

هل يعمل Meta Ads MCP في Cursor؟

نعم. يدعم Cursor خوادم MCP البعيدة بتسجيل دخول OAuth. أضف مدخل Tera Ads إلى ~/.cursor/mcp.json أو .cursor/mcp.json، ثم سجّل الدخول إلى Tera Ads عندما يسألك Cursor.

كيف أضيف Meta Ads MCP إلى VS Code؟

شغّل MCP: Add Server، واختر HTTP والصق https://teraads.co/mcp، أو أضف المدخل إلى .vscode/mcp.json. شغّل الخادم، وسجّل الدخول، ثم فعّل Tera Ads ضمن Configure Tools في المحادثة.

ما أمر Claude Code لـ Meta Ads MCP؟

claude mcp add --transport http tera-ads https://teraads.co/mcp. ثم اكتب /mcp في Claude Code وسجّل الدخول. وللحصول على ست مهارات إعلانية جاهزة، ثبّت الإضافة بـ claude plugin marketplace add Teralabsx/meta-ads-mcp وclaude plugin install tera-ads@tera-ads.

هل أحتاج إلى مفتاح API أو تطبيق مطور من Meta؟

لا. تسجّل الدخول إلى Tera Ads في متصفحك، وتصل التغييرات إلى Meta عبر تطبيق Meta المعتمد الخاص بـ Tera Ads. لا يدخل شيء سري في ملف إعداداتك.

هل يستطيع الذكاء الاصطناعي في محررك تغيير إعلاناتي؟

فقط إذا سمحت بذلك لذلك الاتصال. وحتى حينها، يبدأ كل جديد متوقفًا، وتغيير الميزانية الواحد يستطيع على الأكثر مضاعفتها ثلاث مرات أو خفضها إلى عُشرها، ويمكن التراجع عن الإيقاف أو التشغيل أو تغيير الميزانية في Tera Ads خلال 7 أيام.

كم يكلف؟

تتضمن الخطة المجانية 30 استدعاءً أسبوعيًا على حساب إعلاني واحد في Meta. وConnect Pro‏ 15 دولارًا شهريًا مقابل 3,000 استدعاء شهريًا. والاستدعاء هو عملية بحث واحدة يجريها ذكاؤك الاصطناعي في Tera Ads، وقد يتطلب سؤال واحد بضعة منها.

شاهد ما تربحه إعلاناتك فعلًا.

اربط متجرك وحساباتك الإعلانية. مجاني لنشاط تجاري واحد، بلا بطاقة.

إنشاء حساب مجاني