חזרה לבלוג

נתונים במהירות המחשבה: חיבור Mixpanel MCP אל Claude Code

4 דקות קריאהShahar Bar
נתונים במהירות המחשבה: חיבור Mixpanel MCP אל Claude Code
תרגום אוטומטי: פוסט זה תורגם מאנגלית באמצעות AI. ייתכנו אי-דיוקים בניסוח. קראו את המאמר המקורי באנגלית ←

גילוי נאות: אני שותף של Mixpanel ועשוי לקבל עמלה אם תירשמו דרך הקישורים בפוסט הזה. אני משתמש ב-Mixpanel בעצמי וממליץ רק על כלים שאני באמת משתמש בהם.

עבודה עם אנליטיקס היא מסורתית "הצצה בין טאבים". יש לכם שאלה, אתם פותחים דפדפן, מנווטים בממשק, בונים דוח, ואז חוזרים לקוד. חלקכם עוברים ל-IDE אחר, כותבים שאילתות מורכבות, שולחים, מתקנים, עד שסוף סוף יש בידכם את הנתונים.

שרת ה-Model Context Protocol (MCP) החדש של Mixpanel מבטל את התהליך הזה. הוא מביא את נתוני המוצר שלכם ישירות אל ה-CLI, ומאפשר ל-Claude Code לתשאל את האירועים החיים שלכם באותה קלות שבה הוא קורא קבצים מקומיים.

הנה איך מקימים את זה בפחות מ-10 דקות, ולמה זו מהפכה אמיתית בהנדסת מוצר.


מדריך הקמה ב-10 דקות

שלב 1: הפעלת MCP בהגדרות Mixpanel

לפני שה-CLI יוכל לדבר עם הנתונים שלכם, מנהל ארגון חייב לאשר את החיבור.

  • נווטו אל: Settings → Org Settings → Overview.
  • פעולה: הפעילו Enable MCP.

Enable MCP toggle in Mixpanel org settings

שלב 2: הוספת שרת MCP אל Claude Code

פתחו את הטרמינל ורשמו את השרת. אנחנו משתמשים ב-mcp-remote כפרוקסי לנקודת הקצה המאוחסנת של Mixpanel.

claude mcp add mixpanel -- npx -y mcp-remote https://mcp.mixpanel.com/mcp

קל יותר — פשוט הדביקו את הפרומפט הזה ישירות ב-Claude:

Prompting Claude to install and connect Mixpanel MCP

Install and connect Mixpanel MCP for this project
https://docs.mixpanel.com/docs/mcp

In addition create skills according to this project
analytics structure to have easy use

Take the project ID from this project

Claude יטפל בהגדרות, ישלוף את ה-Project ID מההקשר, ואפילו ייצור skills מותאמים אישית לפי מבנה האירועים שלכם.

שלב 3: אימות באמצעות OAuth

Claude יודיע לכם כשיגיע הזמן. אתם יכולים לבקש ממנו להפעיל את שלב האימות, והוא יפתח עבורכם את הדפדפן.

Claude's instructions - restart and authenticate via OAuth

שלב 2 אמר ל-Claude איפה השרת נמצא, אבל עדיין צריך להתחבר. הריצו את הפקודה הזו ב-חלון טרמינל סטנדרטי נפרד (למה? כי הרצה בתוך סשן ה-Claude Code האינטראקטיבי תחסום את הפניית הדפדפן שדרושה ל-OAuth):

npx -y mcp-remote https://mcp.mixpanel.com/mcp

Running trigger auth command in Claude

  1. חלון דפדפן ייפתח אוטומטית.
  2. התחברו עם פרטי Mixpanel שלכם.
  3. עברו על ההרשאות ולחצו Authorize.
  4. ברגע שתראו "Authorization successful!", חזרו ל-CLI.

Mixpanel OAuth consent screen - authorizing MCP CLI Proxy access

הטוקן שלכם נשמר בצורה מאובטחת בתיקיית הבית (~/.mcp-auth/ ב-macOS/Linux, או %USERPROFILE%\.mcp-auth\ ב-Windows), כך שלא תצטרכו לחזור על התהליך עד שהטוקן יפוג.

שלב 4: הפעלה מחדש ואימות

הפעילו מחדש את Claude Code כדי לאתחל את התצורה החדשה. כדי לוודא שהכל רץ:

claude mcp list

אתם אמורים לראות וי ירוק: ✓ mixpanel.


מתחילים לתשאל — בלי דשבורד

מכיוון ש-Claude משלב את הכלי הזה בצורה מקורית, אתם יכולים לדלג על בניית הדוחות הידנית. הוא מטפל אוטומטית בניסוח השאילתות, חיפוש בסכמה, ו-pivoting.

דוגמה אמיתית מהטרמינל שלי:

Querying Claude - "how many users were visiting my site? use mixpanel"

Claude טוען אוטומטית את ה-skill של mixpanel כדי לטפל בזה:

Claude loads the mixpanel skill automatically

שאלה אחת. תשובה מיידית. בלי שום ממשק.

Analytics results - Claude returns a full breakdown of daily visitors from Mixpanel


הקסם האמיתי: קוד + נתונים + תיעוד

ה"שחרור" האמיתי כאן הוא לא רק ש-Claude יכול לקרוא Mixpanel — אלא ש-Claude קורא את Mixpanel בזמן שהוא יושב בתוך ה-codebase שלכם. כאשר ל-Claude יש גישה ל-Docs (התוכנית), ל-Code (המימוש), ול-Mixpanel (התוצאות החיות), הוא סוגר את לולאת המשוב לחלוטין.

אתם יכולים לבקש דברים כמו:

"תסתכל על tracking-plan.md בתיקיית ה-docs שלנו, ואז בדוק ב-Mixpanel אם אנחנו באמת מקבלים את התכונה plan_type באירוע signup_completed."

Claude קורא את המפרט, בודק את ה-Lexicon החי, ומזהה אי-התאמות באופן מיידי.

אפשר להשתמש בזה גם לניקוי קוד ו-debugging:

"בדוק את הקובץ analytics.ts שלנו עבור כל האירועים שמיושמים כרגע. אחר כך, תשאל את Mixpanel כדי להגיד לי אילו מהאירועים האלה לא קיבלו תנועה כלשהי בשבעת הימים האחרונים."

Claude מנתח את ה-TypeScript שלכם, מחלץ את שמות האירועים, ממפה אותם מול נתוני פרודקשן חיים, ומסמן קוד מת או מעקב שבור תוך שניות. זה הופך את ה-AI מעוזר קוד פשוט למהנדס מוצר שמבין את ההשפעה האמיתית של השורות שהוא כותב.


פתרון בעיות

אם claude mcp list מציג ✗ Failed to connect, זה כמעט תמיד אומר שתהליך ה-OAuth לא הסתיים כמו שצריך.

  • בדקו: חפשו בתיקיית ~/.mcp-auth/ (או %USERPROFILE%\.mcp-auth\ ב-Windows) קובץ טוקן.
  • תיקון: אם הוא חסר (ואתם רואים רק _client_info.json), הריצו מחדש את הפקודה npx mcp-remote בחלון טרמינל סטנדרטי כדי להפעיל שוב את התחברות הדפדפן.

מחשבות לסיכום

Mixpanel MCP חושף פרטי אירועים, ערכי תכונות, retention, funnels, flows, ו-metadata של session replay. ההקמה לוקחת 10 דקות, אבל היכולת לתשאל נתוני פרודקשן ישירות מהטרמינל משנה את הדרך שבה אתם בונים.

הקימו את זה, שאלו "אילו אירועים לא קיבלו תנועה השבוע?" ולא תפתחו שוב את הטאב של הדשבורד.

הרשמה ל-Mixpanel ←


רוצים לדבר על Mixpanel?

אני שותף של Mixpanel ועוזר לצוותים להקים אנליטיקס נכון — תוכניות מעקב, עיצוב אירועים, אינטגרציית MCP, ולקבל ערך אמיתי מהנתונים שלכם.

אם אתם מקימים את זה ורוצים זוג עיניים נוסף, או סתם רוצים לדבר על איך להפיק את המקסימום מ-Mixpanel למוצר שלכם — שלחו לי הודעה ישירה:

צ'אט ב-WhatsApp