Cursor

ב-Cursor עדיף להתחיל עם Agent Analytics skill ו-workflow בסגנון CLI. בפועל זה בדרך כלל מהיר יותר, זול יותר בטוקנים וקל יותר לכיוון מאשר MCP לשימוש יומיומי.

דרישות מקדימות

חשבון Agent Analytics ב-app.agentanalytics.sh
Cursor מותקן
npx זמין בסביבה שבה Cursor משתמש
מפתח API תקין של Agent Analytics זמין כ-AGENT_ANALYTICS_API_KEY

מומלץ: התקנת ה-Agent Skill

npx skills add Agent-Analytics/agent-analytics-mcp
export AGENT_ANALYTICS_API_KEY=aak_...

כך Cursor מקבל גם את שכבת ה-workflow של Agent Analytics וגם הרצה מוכוונת CLI באותה סביבה. לרוב זהו ה-tradeoff הטוב ביותר כשאתם רוצים פחות latency ופחות overhead של טוקנים מאשר קריאות כלי דרך MCP.

בדיקת ההתקנה

בקשו מ-Cursor:

List my Agent Analytics projects
How is my-site doing this week?
What are the top pages for my-site this week?

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

חלופה: הוספת שרת MCP מותאם אישית

השתמשו ב-MCP ב-Cursor רק אם אתם רוצים במפורש קריאות כלי בסגנון connector במקום skill + CLI execution.

פתחו את Command Palette
חפשו MCP
בחרו Cursor Settings > Tools & MCP
לחצו על Add Custom MCP
הוסיפו את זה ל-mcp.json שלכם:

{
  "mcpServers": {
    "agent-analytics": {
      "url": "https://mcp.agentanalytics.sh/mcp"
    }
  }
}

שמרו את הקובץ וטעינו מחדש את Cursor אם רשימת הכלים לא מתרעננת אוטומטית. MCP עובד, אבל בדרך כלל מוסיף יותר latency ו-overhead של טוקנים מאשר מסלול ה-skill.

חלופה ברמה נמוכה יותר: API ישיר

אם אתם רוצים לעקוף גם את ה-skill וגם את MCP, אפשר לקרוא ישירות ל-API המארח:

curl "https://api.agentanalytics.sh/stats?project=my-site&since=7d" \
  -H "X-API-Key: aak_..."

המסלול הזה שימושי לדיבוג auth, אבל ה-flow המומלץ לשימוש יומיומי ב-Cursor הוא skill + CLI.

פתרון תקלות

אם ה-skill מותקן אבל השאילתות נכשלות, ודאו ש-AGENT_ANALYTICS_API_KEY זמין בסביבה שבה Cursor באמת רץ.
אם בחרתם במסלול MCP, ודאו שהערך ב-mcp.json הוא JSON תקין.
טענו מחדש את Cursor אחרי הוספת שרת MCP מותאם אם פאנל הכלים עדיין מציג את המצב הישן.
אם Cursor רואה את שרת ה-MCP אבל לא את הפרויקטים שלכם, ודאו שההתחברות המארחת הושלמה עם החשבון הנכון.