חיבור Meta Ads ל-Claude Code
מדריך צעד-אחר-צעד לחיבור חשבון המטא שלכם ל-Claude Code דרך MCP Server. בסוף תוכלו לשלוף נתוני קמפיינים, לנתח ביצועים ולקבל המלצות - ישירות מהטרמינל. בלי Pipeboard, בלי צד שלישי. חיבור ישיר ל-Meta Marketing API.
מה תלמד
- איך ליצור System User Token בטוח שלא פג תוקף
- איך להתקין Meta Ads MCP Server מקומית (בלי שירותי צד שלישי)
- איך לחבר את ה-MCP ל-Claude Code בפקודה אחת
- מה ההבדל בין הרשאות ads_read (בסיסי) ל-ads_management (מתקדם)
- 53 כלים שמקבלים אחרי החיבור - מניתוח ועד ניהול קמפיינים
- פתרון בעיות נפוצות בחיבור
תוכן עניינים
למה לחבר את Meta ל-Claude Code
ChatGPT יכול לכתוב לכם קופי למודעות. אבל הוא לא יכול להיכנס לחשבון המטא שלכם, לשלוף את הנתונים האמיתיים, ולהגיד לכם איזה קמפיין לכבות.
Claude Code עם MCP כן יכול. הוא מתחבר ישירות ל-Meta Marketing API, שולף נתונים חיים (CPM, CPC, CTR, ROAS), מנתח ביצועים, ונותן המלצות מבוססות דאטה אמיתי - לא מספרים שהוא המציא.
החיבור רץ מקומית על המחשב שלכם. אין שרת ביניים, אין צד שלישי, אין דמי מנוי. הנתונים עוברים ישירות מ-Meta אליכם.
יצירת אפליקציית Meta Developer
אם כבר יש לכם אפליקציית מטא - דלגו לחלק הבא. אם לא, ככה יוצרים:
- נכנסים ל-
developers.facebook.com/apps - לוחצים "Create App"
- בוחרים "Other" ואז "Business"
- נותנים שם לאפליקציה (למשל: "My Ads MCP")
- מחברים את ה-Business Portfolio שלכם
- בתפריט Use Cases בוחרים "Create & manage ads"
יצירת System User Token (בטוח + קבוע)
זה השלב הכי חשוב. במקום לייצר טוקן אישי שפג תוקף אחרי שעתיים, ניצור System User Token שלא פג לעולם ולא קשור לחשבון הפייסבוק האישי שלכם.
- נכנסים ל-
business.facebook.com/settings - בתפריט השמאלי: Users → System users
- בוחרים System User קיים או יוצרים חדש (עם הרשאת Employee)
- לוחצים "Generate token"
- בוחרים את האפליקציה שיצרתם
- מסמנים הרשאות (ראו חלק 07 - הרשאות)
- לוחצים "Generate Token"
- מעתיקים את הטוקן ושומרים במקום בטוח!
למה System User?
- לא פג תוקף - בניגוד לטוקן אישי שפג אחרי שעתיים
- קריאה בלבד (אופציה) -
ads_readלא יכול לשנות או למחוק כלום - לא קשור לחשבון האישי - מופרד מהפייסבוק שלכם
- אפשר לבטל בכל רגע מתוך Business Manager
התקנת Meta Ads MCP Server
מריצים בטרמינל:
git clone https://github.com/brijr/meta-mcp.git meta-ads-mcp
cd meta-ads-mcp
npm install @modelcontextprotocol/sdk@1.25.2 --save-exact
npm installחשוב: חייבים לנעול את גרסת ה-SDK ל-1.25.2 - גרסאות חדשות יותר שוברות את השרת בגלל שינויים ב-schema format.
חיבור ל-Claude Code
מריצים בטרמינל (מחליפים את YOUR_TOKEN בטוקן שהעתקתם):
claude mcp add meta-ads --scope user \
-e META_ACCESS_TOKEN=YOUR_TOKEN \
-- npx tsx /path/to/meta-ads-mcp/src/index.tsהחליפו /path/to/ בנתיב המלא לתיקיה שבה שכפלתם את הפרויקט. אחרי הפקודה, הפעילו מחדש את Claude Code.
בדיקה שהכל עובד
אחרי שהפעלתם מחדש את Claude Code, שאלו:
"תראה לי את כל חשבונות המודעות שלי"אם הכל עובד, תקבלו רשימה של חשבונות המודעות שלכם עם שם, מטבע ואזור זמן.
עוד דברים שאפשר לשאול:
"תראה לי את הקמפיינים הפעילים"
"תנתח את הביצועים של השבוע האחרון"
"מה ה-ROAS של כל קמפיין?"
"איזה קמפיין הכי משתלם ואיזה צריך לכבות?"
"תשווה בין קמפיין A לקמפיין B"
"תראה חתך לפי גיל ומגדר"הרשאות - בסיסי מול מתקדם
כשיוצרים את הטוקן, בוחרים אילו הרשאות לתת. שלוש רמות:
| רמה | הרשאות | מה מקבלים |
|---|---|---|
| מודעות בלבד | ads_read | צפייה בקמפיינים, ניתוח ביצועים, דוחות, חתכים |
| מודעות + אינסטגרם (מומלץ לדשבורד) | ads_read + business_management + pages_show_list + pages_read_engagement + instagram_basic + instagram_manage_insights | הכל מלמעלה + ניתוח פוסטים, סטוריז וריילז באינסטגרם, עוקבים, reach |
| מלא (ניהול) | הכל מלמעלה + ads_management + pages_manage_ads | גם ניהול קמפיינים, יצירת קהלים, העלאת קריאייטיבים |
לדשבורד של הוורקשופ: מומלץ להשתמש ברמה השניה (מודעות + אינסטגרם) כדי לקבל את התמונה המלאה.
מה מקבלים אחרי החיבור
53 כלים זמינים דרך ה-MCP:
- צפייה: רשימת קמפיינים, מודעות, קהלים, קריאייטיבים
- ניתוח: ביצועים, ROAS, CPM, CPC, CTR, עלות לליד, השוואות
- חתכים: פילוח לפי גיל, מגדר, מיקום, מכשיר, מדינה
- טווחי זמן: היום, אתמול, 7/30/90 ימים אחרונים, טווח מותאם
- ניהול (מתקדם): השהיה/הפעלה, עדכון תקציבים, יצירת קמפיינים
- קהלים (מתקדם): יצירת קהלי Custom ו-Lookalike, הערכת גודל
- קריאייטיב (מתקדם): העלאת תמונות, יצירת מודעות, A/B טסטים, תצוגה מקדימה
- אבחון: בדיקת תקינות חשבון, פתרון שגיאות, בדיקת API v23
הכל רץ מקומית. הנתונים עוברים ישירות מ-Meta API למחשב שלכם. אין צד שלישי, אין שרת ביניים, אין דמי מנוי.
פתרון בעיות
הריצו claude mcp list וחפשו את meta-ads:
- Connected - הכל תקין
- Failed to connect - בדקו:
- הטוקן תקין? (לא פג תוקף, לא חתוך באמצע)
- הנתיב לקובץ
src/index.tsנכון? - התקנתם את
@modelcontextprotocol/sdk@1.25.2? - יש
npx tsxמותקן?
שגיאת "Invalid token": הטוקן פג תוקף או לא מורשה. חזרו ל-Business Manager → System Users→Generate Token ויצרו טוקן חדש.
שגיאת SDK: אם רואים שגיאה על "Zod schema" או "ToolAnnotations", הגרסה של ה-SDK לא נכונה. הריצו npm install @modelcontextprotocol/sdk@1.25.2 --save-exact.