Why do MCP tool names still say label?

The Hitsteps dashboard calls the feature Segments, and each saved object is a Segment. Stable MCP tools and scopes retain legacy identifiers such as create_label and labels:write for compatibility. An unqualified request for a Hitsteps Segment should use those tools unless the user explicitly means a conversion-goal or campaign trigger condition.

האם זה קוד המעקב לאתר שלי?

לא. השרת MCP מיועד לעוזרי AI מחוברים שצריכים לקרוא או לפעול על נתוני Hitsteps. מעקב אתרים עדיין משתמש בקוד המעקב של Hitsteps JavaScript או בתוסף Hitsteps ספציפי לפלטפורמה.

האם עוזר בינה מלאכותית יכול לשנות את חשבון Hitsteps שלי לאחר שאני מחבר אותו?

רק אם הרשאת OAuth כוללת את היקף הכתיבה הנדרש והמשתמש מאשר במפורש את פעולת הכתיבה המסוימת. הרשאות ניתוח לקריאה בלבד אינן יכולות ליצור אתרים, לשנות הגדרות, לערוך מנטרי זמינות, לעדכן התראות או לשלוח תשובות בצ׳אט.

האם אני יכול לחבר את ChatGPT או Claude AI?

כן. משתמשי Claude יכולים להתקין את Hitsteps Web Analytics מ-Connector Directory של Claude. דף הספרייה של ChatGPT יגיע בקרוב; עד אז, הוסיפו ידנית את https://www.hitsteps.com/mcp/ כשרת MCP מותאם אישית ב-ChatGPT והשלימו את תהליך ה-OAuth של Hitsteps.

How do I know an MCP client is trusted?

Hitsteps supports new and custom clients through open OAuth registration. Start the connection from the client you chose, then review the Hitsteps consent page: verify that the exact callback destination and requested scopes match what the client shows you. Cancel unexpected requests, and treat write-capable access as an additional decision.

מה קורה אם תקופת הניסיון, הרישיון או מגבלת התוכנית שלי ב-Hitsteps חוסמים את הגישה?

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

האם Hitsteps שומרת את פרומפטי ה-AI שלי?

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

שרת Hitsteps AI MCP לעוזרי אנליטיקה

תיעוד שרת של Hitsteps AI MCP

Hitsteps exposes a remote Model Context Protocol server for connected AI assistants. Use it to ask about analytics, live visitors, sites, goals, uptime, alerts, Mentions, and authorized chat activity from your Hitsteps account while keeping access bounded by OAuth scopes, account permissions, license checks, and privacy-shaped tool results.

לפני שמתחילים

חשבון Hitsteps עם גישה לאתרים שברצונכם לבדוק

הגדרת לקוח AI או סביבת עבודה תואמת MCP התומכת בשרתים מרוחקים של Streamable HTTP

אפשרות להיכנס באמצעות Hitsteps OAuth כאשר לקוח הבינה המלאכותית מבקש

החלטה אילו היקפי OAuth העוזר אמור לקבל

השתמשו בנקודת הקצה המרוחקת של MCP

נקודת הקצה של Hitsteps MCP היא https://www.hitsteps.com/mcp/. אם הלקוח מבקש סוג תעבורה, בחרו Streamable HTTP או HTTP. שם הרישום הרשמי הוא com.hitsteps/analytics-operations.

בחר את רמת הגישה

לפני חיבור השרת, ודאו איזה משתמש Hitsteps יתחבר, לאילו אתרים הוא יכול לגשת ואילו היקפי OAuth לקוח ה-AI מבקש. שימוש אנליטי בלבד יכול להישאר לקריאה בלבד; תהליכי עבודה תפעוליים זקוקים להיקפי הכתיבה המסוימים שלהלן.

הוסיפו את Hitsteps ל-Google Antigravity

הגדרת MCP מרוחק מותאמת אישית ב-Antigravity משתמשת ב-serverUrl עבור שרתים מרוחקים.

{
  "mcpServers": {
    "Hitsteps": {
      "serverUrl": "https://www.hitsteps.com/mcp/"
    }
  }
}

בצעו אימות באמצעות Hitsteps OAuth

שמרו את ההגדרה, הפעילו או רעננו את שרת MCP בלקוח ה-AI ולאחר מכן פעלו לפי בקשת ההתחברות. Hitsteps משתמשת ב-OAuth, ולכן אין צורך להדביק את מפתח API למעקב בלקוח ה-AI.

בדקו את הכלים ואת עקרון ההרשאה המינימלית

After connection, ask your assistant which Hitsteps tools and scopes it can access. Read-only analytics tools can answer reports; management tools such as goals, Segments, uptime, alerts, Mentions, and chat actions require matching OAuth scopes, account permissions, and explicit confirmation.

טוב לדעת

שרת MCP זה מיועד לעוזרי AI. הוא אינו מתקין מעקב של Hitsteps באתר שלכם.

משתמשי VS Code ו-GitHub Copilot צריכים להתחיל ב-MCP Registry של GitHub; משתמשי Cursor ו-Claude יכולים להשתמש בדפי Hitsteps הייעודיים בספריות שלעיל.

תמיכה בספריית ChatGPT תגיע בקרוב. עד אז, הוסף את https://www.hitsteps.com/mcp/ באופן ידני כשרת MCP מותאם אישית.

אל תדביק את מפתח API למעקב אחר אתר Hitsteps, אסימון OAuth או סיסמת החשבון שלך בתצורה של MCP.

פתרון בעיות

בקשת GET מהדפדפן לנקודת הקצה של MCP עשויה להחזיר הודעת אין-SSE או הודעה על השיטה. זה תקין; לקוחות MCP מתחברים באמצעות JSON-RPC דרך HTTP.

תגובה 401 לפני ההתחברות צפויה. הלקוח צריך להשתמש במטא-נתוני OAuth שפורסמו כדי להתחיל את ההרשאה.

אם Hitsteps אינה מופיעה בספריית הלקוח הרשמית, רעננו את הספרייה ובדקו את מדיניות הארגון ואת הגדרות MCP של הלקוח.

מה העוזר יכול לבקש מ-Hitsteps לעשות

שרת MCP מספק כלי קריאה לאנליטיקה, כלי כתיבה המחייבים אישור, משאבים הדורשים אימות, תבנית משאב והנחיות. קריאות Mentions משתמשות במטמון של שעה; שינוי שאילתת Mentions מחייב אישור מפורש.

אמצעי הגנה לפעולות כתיבה

כל כלי הכתיבה דורשים OAuth ואת ההיקף המדויק שהוצהר עבור כלי זה. מפתחות API של אתר מדור קודם ואסימונים פרטיים לנייד יכולים להשתמש בקריאה ניתוחית בלבד.

כל פעולת שינוי דורשת confirm=true לאחר שהמשתמש מאשר במפורש את הפעולה בשיחה עם לקוח ה-AI.

כל פעולת שינוי דורשת idempotency_key באורך 8–128 תווים. שימוש חוזר באותו מפתח ובאותם ארגומנטים מחזיר את התוצאה הקודמת; שימוש בו עם ארגומנטים שונים מחזיר HTTP 409.

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

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

גישה לנתונים וגבולות פרטיות

Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.

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

הגדרת היעד אינה כוללת כתובות התראה, ערכי טריגר רגישים או שורות המרה בודדות. פלט הזמינות אינו כולל פרטי הזדהות, תנאי התאמה, מחרוזות שאילתה או את מקטע ה-fragment/hash של URL שאחרי #.

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

לצורך בקרה תפעולית, טלמטריית MCP שומרת חשבון או אתר, סוג פרטי כניסה, מזהה לקוח OAuth ציבורי, ערוץ לקוח AI מנורמל, שם כלי, מצב, משך וחותמת זמן. היא אינה כוללת פרומפטים, ארגומנטים, אסימונים, user-agent גולמי, שורות תוצאות או תוכן שגיאות; חלון הצבירה הוא 90 יום.

השרת אינו חושף במכוון גישה ישירה ל-SQL, שינויי חיוב או סיסמה, שינויי פרופיל או 2FA, ייצוא גולמי של פרופילי מבקרים, מפתחות פרטיים, שינוי מפתח API למעקב, וידאו הקלטת סשן, יומני מסוף JavaScript, עקבות רשת או ניהול ניסויים.

OAuth גילוי ותאימות לקוח

מטא נתונים של משאבים מוגנים: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp

מטא נתונים של שרת הרשאות: https://www.hitsteps.com/.well-known/oauth-authorization-server

נקודת הקצה MCP מקבלת מקורות לקוח חוקיים של HTTPS MCP ומקורות פיתוח לולאה של HTTP עבור לקוחות מבוססי דפדפן ומחשבים שולחניים.

רישום לקוח דינמי תומך בסכימות לולאה בטוחות של HTTPS, HTTP וסכימות להפניה מחדש של אפליקציות מקוריות המשמשות לקוחות שולחניים של MCP, תוך דחיית סכמות לא בטוחות כגון javascript:, data:, file:, blob: ו-websocket.

Registration is intentionally open for new and custom clients. The consent page asks users to verify the exact callback and scopes, and requires an extra acknowledgement before write-capable access is granted.

קהל המשאבים הוא https://www.hitsteps.com/mcp או https://www.hitsteps.com/mcp/, התואם לטופס נקודת הקצה שנשמר על ידי לקוח הבינה המלאכותית.

תיעוד שרת של Hitsteps AI MCP

לפני שמתחילים

התקן את Hitsteps במקום שבו אתה כבר משתמש בבינה מלאכותית

VS Code ו-GitHub Copilot

Cursor

Claude AI

ChatGPT AI

Google Antigravity ולקוחות אחרים של MCP

השתמשו בנקודת הקצה המרוחקת של MCP

בחר את רמת הגישה

הוסיפו את Hitsteps ל-Google Antigravity

בצעו אימות באמצעות Hitsteps OAuth

בדקו את הכלים ואת עקרון ההרשאה המינימלית

טוב לדעת

פתרון בעיות

השתמשו ב-AI בדרך שלכם: בתוך Hitsteps או בעוזר שלכם

פרטי חיבור

נקודת קצה ציבורית

שיטת תעבורה

זהות הרישום

אימות

אין סודות משותפים בתצורה

גישה מוגבלת

היקפים של OAuth

מה העוזר יכול לבקש מ-Hitsteps לעשות

גילוי ודיווח

תעבורת אתר וגיוס מבקרים

המרות והתנהגות

תצורה ותפעול

אמצעי הגנה לפעולות כתיבה

גישה לנתונים וגבולות פרטיות

OAuth גילוי ותאימות לקוח

Questions about connecting Hitsteps to AI

מה עוזרי AI יכולים לעשות עם Hitsteps