שרת MCP
אפשרות לסוכן בינה מלאכותית לקרוא את נתוני הניתוח: שבעה כלים דרך Model Context Protocol, כולם לקריאה בלבד, עם אימות במפתח API שכבר קיים אצלך.
1. מה סוכן יכול לעשות עם זה
מפנים לקוח Model Context Protocol לנקודת הקצה, והוא יכול לשאול שאלות כגון “איזה דף יוצר הכי הרבה לחיצות זעם החודש” או “הצגת שלושה סשנים מגרמניה שאורכם יותר משתי דקות” — ואז למסור קישור שמנגן את הסשן.
| כלי | תשובות |
|---|---|
mp_projects | אילו פרויקטים מפתח זה רשאי לקרוא |
mp_overview | סשנים, אנשים, צפיות בדף, משך וסימני תסכול |
mp_sessions | סשנים אחרונים עם קישורי הקלטות, מסוננים לפי מדינה, מכשיר או משך |
mp_session | סשן אחד: דפים לפי הסדר, אירועים, מקור ומכשיר |
mp_pages | דפים לפי צפיות, עם מבקרים ייחודיים |
mp_frustration | לחיצות זעם, לחיצות ללא תגובה ושגיאות JavaScript, מקובצות לפי דף |
mp_goals | היעדים שלך ותדירות ההגעה לכל אחד |
כל סשן שעליו הסוכן מדווח מגיע עם קישור שאדם יכול לפתוח. סוכן שמסכם מה שראה הוא שימושי; סוכן שמציג גם את עשרים השניות שעליהן הסתמך ניתן לבדיקה.
2. חיבור
נקודת הקצה מקבלת POST בנתיב /mcp ומשתמשת ב-Streamable HTTP, גרסת פרוטוקול 2026-07-28.
האימות הוא מפתח API רגיל לקריאה של MousePlayer — אותו סוג שיוצרים תחת הגדרות, מפתחות API, ואותו סוג שמקבל API ה-REST. אין פרטי גישה נוספים. ביטול המפתח מבטל באותו רגע את גישת הסוכן.
לאחר מכן יש להפעיל את הפרויקט
מפתח API פותח את כל סביבת העבודה. הנתיב הזה במכוון אינו עושה זאת: לכל פרויקט יש מתג משלו בדף השילובים, והוא כבוי כברירת מחדל. פרויקט שלא הופעל אינו מופיע ברשימה mp_projects ואי אפשר לקרוא אותו גם אם הסוכן מנחש את המזהה.
אין זו בירוקרטיה. מפתח API בסקריפט פריסה נמצא במקום אחד שבשליטתך; מפתח API בקובץ הגדרת סוכן מזין הקשר של מודל, וזהו סוג משמורת רופף הרבה יותר. אישור פרויקט אחד בכל פעם הוא הבקרה המתאימה.
3. קריאה בלבד, ומדוע זה לא ישתנה
אף אחד משבעת הכלים אינו כותב דבר. אין מחיקה, ייצוא או שינוי הגדרה מאחורי נקודת קצה זו — לא בגלל מחסור בזמן, אלא משום שכלי שסוכן יכול לקרוא לו הוא גם כלי שהוא יכול לקרוא לו בטעות.
מה הוא אינו מחזיר
לא את ההקלטות עצמן, לא תמונות מצב DOM ולא כתובות IP. הסוכן מקבל את מה שאדם רואה בממשק, יחד עם הקישור לצפייה בשאר.
מגבלות קצב וטווח
שישים בקשות לדקה לכל מפתח, כמו ב-API ה-REST. טווח זמן מוגבל ל-365 ימים ורשימת תוצאות ל-200 שורות; תשובה קטועה מציינת זאת, כי רשימה שנקטעה ללא הודעה נראית בדיוק כמו רשימה מלאה.
4. למי שבונים את הלקוח
שלוש שיטות: server/discover, tools/list, tools/call. ללא סשנים, ללא זרם GET וללא Last-Event-ID — אלה שייכים לגרסאות פרוטוקול עד 2025-11-25 ואינם חלק מגרסה זו. GET או DELETE מקבלים 405.
כל POST כולל MCP-Protocol-Version, Mcp-Method וכן, עבור tools/call, Mcp-Name, וכל אחת מהכותרות חייבת להתאים לגוף. אי-התאמה היא 400 עם שגיאת JSON-RPC -32020; גרסה שאינה נתמכת היא 400 עם -32022 ורשימת הגרסאות הנתמכות, כדי שהלקוח יוכל לבחור אחת ולנסות שוב.
שני סוגי שגיאות, במכוון
בקשה פגומה או כלי לא מוכר הם שגיאת JSON-RPC. “פרויקט זה לא אושר” או “אין סשן כזה” חוזרים כתוצאה רגילה עם isError: true — כי מודל יכול להתאושש מהסוג השני באמצעות בקשה לכלי mp_projects וניסיון חוזר, ואינו יכול להתאושש מהראשון.
התוצאות כוללות גם structuredContent וגם את אותם נתונים כסריאליזציה בבלוק טקסט, כדי שגם לקוחות ישנים יראו מידע שימושי.
כל הסימנים המסחריים המוזכרים כאן שייכים לבעליהם בהתאמה. ל-MousePlayer אין קשר עסקי עם ספקים אלה.