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

يستخدم تسجيل الدخول 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.
| المهارة | ما تفعله |
|---|---|
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.
المحررات الثلاثة جنبًا إلى جنب
| Cursor | VS Code | Claude Code | |
|---|---|---|---|
| أين يوضع الإعداد | ~/.cursor/mcp.json أو .cursor/mcp.json | MCP: Add Server، أو .vscode/mcp.json | claude mcp add، في النطاق المحلي أو المستخدم أو المشروع |
| صيغة المدخل | mcpServers مع url | servers مع "type": "http" وurl | أمر واحد، لا ملف لتحريره |
| تسجيل الدخول | المتصفح، عندما يسأل Cursor | المتصفح، بعد تشغيل الخادم | /mcp، ثم المتصفح |
| قبل أول استخدام | لا شيء آخر | فعّله ضمن Configure Tools | لا شيء آخر |
| إضافات | لا شيء | لا شيء | إضافة بست مهارات |
| وثائق المحرر | Cursor | VS Code | Claude Code |
ماذا تسأل أولًا
ابدأ بأسئلة يمكنك التحقق من إجاباتها في مدير الإعلانات خلال دقيقة. وبعد أن تتطابق الأرقام، انتقل إلى الأسئلة التي تحتاج إلى بيانات متجرك. وفي مكتبة الأوامر لتحليل الإعلانات وأسئلة تطرحها على الذكاء الاصطناعي عن إعلاناتك المزيد.
| اسأل | ما يبحث عنه ذكاؤك الاصطناعي |
|---|---|
| «أي الحملات أنفقت أكثر هذا الأسبوع، وماذا جلبت؟» | 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 ألا يتبع التعليمات داخلها. وتذكر وثائق 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، وقد يتطلب سؤال واحد بضعة منها.