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 ל-IDE ואפליקציית 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" והשוו את התשובה ל-Ads Manager.

Codex שומר שרתי MCP ב-~/.codex/config.toml, טבלת [mcp_servers.tera-ads] אחת לכל שרת עם הכתובת ב-url. התיעוד של OpenAI אומר שאפליקציית ChatGPT לשולחן העבודה, Codex CLI והתוסף ל-IDE חולקים את ההגדרה הזו, כך שהגדרה אחת מכסה את שלושתם (תיעוד MCP של Codex). אותו תיעוד אומר ש-codex mcp login מטפל ב-OAuth ושקודקס יכול לבחור שיטת רישום לקוח אוטומטית. 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?" והשוו את התשובה ל-Ads Manager.
התוסף הוא קובץ קטן gemini-extension.json במאגר ה-GitHub של Tera Ads. הוא מצביע ל-Gemini על 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 ל-IDE ואפליקציית ChatGPT לשולחן העבודה | טוען את GEMINI.md כהקשר |
| תיעוד הסוכן | תיעוד MCP של Codex | תוספים של Gemini CLI |
כדי ש-Codex או סוכן אחר ישתמש ב-Tera Ads בלי שיגידו לו, המאגר מציע להעתיק את תוכן GEMINI.md ל-AGENTS.md או ל-CLAUDE.md של הפרויקט שלכם. אחרת, ציינו את Tera Ads בפרומפט.
פרומפטים שמתאימים לסוכן בטרמינל
סוכן קוד יכול לעשות משהו שחלון צ'אט לא יכול: להניח את התשובה איפה שאתם עובדים. בקשו ממנו לשמור תוצאות בקובץ, להשוות אותן לקובץ של השבוע שעבר, או לפתוח את דף המוצר שקמפיין שולח אליו אנשים.
| בקשה | במה הסוכן משתמש |
|---|---|
| "What was my profit after returns in the last 30 days? Save it to reports/profit.md." | get_profit, ואז כלי הקבצים שלו |
| "Meta says my ROAS is 3. What did my store actually make?" | get_insights, get_profit |
| "Which campaigns lose money after returns, and what should I do about them?" | get_ads_review |
| "Which ads spent money in the last 14 days without a sale?" | get_insights ברמת המודעה |
| "What changed in my ads this week, and can I still undo it?" | list_recent_changes |
| "Copy my best campaign as a paused draft." | duplicate |
| "How many Tera Ads calls do I have left?" | get_usage, שהוא חינם |
קראו את התשובות עם שתי הסתייגויות. הרכישות וההכנסות של Meta הן הייחוס של Meta, לא מכירות החנות שלכם. ו-get_ads_review שופט כל קמפיין שהוציא כסף לפי רווח אחרי ההחזרות הרגילות של החנות שלכם, בעלויות שלכם, מול ROAS האיזון שלכם; נתון הרווח הוא הערכה לכל החנות, לא כסף בבנק. ROAS אמיתי אחרי זיכויים מראה למה הפער חשוב, ובספריית הפרומפטים לניתוח מודעות יש עוד שאלות לנסות.

שומרים את שינויי הסוכן בשליטה
סוכני קוד מוגדרים לעיתים קרובות לערוך קבצים בלי לשאול כל פעם. אל תתנו להרגל הזה להתפשט לכלי מודעות, שבהם קריאה שגויה אחת מוציאה כסף אמיתי. 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. התוסף מכסה מודעות Facebook ו-Instagram בחשבון המודעות שלכם ב-Meta.
האם צריך אפליקציית מפתחים של Meta או אסימון API?
לא. נכנסים ל-Tera Ads בדפדפן, ושינויים מגיעים ל-Meta דרך אפליקציית Meta המאושרת של Tera Ads עצמה. שום דבר סודי לא נכנס לקובץ ההגדרות שלכם.
האם ההגדרה של Codex עובדת גם בתוסף ל-IDE?
כן. התיעוד של OpenAI אומר שאפליקציית ChatGPT לשולחן העבודה, Codex CLI והתוסף ל-IDE חולקים את אותה הגדרת MCP, ולכן שרת שנוסף ב-CLI נמצא גם בשניים האחרים.
האם Gemini CLI עדיין זמין?
התיעוד של Gemini CLI אומר שהוא הוחלף ב-Antigravity CLI למשתמשי השכבה החינמית ו-Google One ב-18 ביוני 2026. בדקו את התיעוד של Google לסוג החשבון שלכם לפני שמגדירים אותו.
כמה זה עולה?
התוכנית החינמית כוללת 30 קריאות בשבוע על חשבון מודעות אחד ב-Meta. Connect Pro עולה $15 לחודש עבור 3,000 קריאות בחודש. קריאה היא חיפוש אחד שהסוכן עושה ב-Tera Ads, ושאלה אחת יכולה לקחת כמה.