התחברות אל Codex

OpenAI Codex

תנו ל-Codex נתוני מוצר אמיתיים: טראפיק, אירועים משמעותיים, funnels, retention, מסלולי sessions ותוצאות ניסויים. בחרו ב-MCP לקריאות כלי מתוך השיחה, או ב-skill וב-CLI כשהסוכן יכול להריץ פקודות בפרויקט.

חיבור דרך MCP

נדרש לקוח Codex שתומך ב-Streamable HTTP וב-OAuth. ב-Codex CLI הריצו:

codex mcp add agent-analytics --url https://mcp.agentanalytics.sh/mcp
codex mcp login agent-analytics

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

פתחו שיחה חדשה ובקשו:

List my Agent Analytics projects, then show the overview for my-site for the last 7 days.

החליפו את my-site בשם פרויקט מהרשימה. לקוחות שתומכים ב-MCP Apps יכולים להציג תצוגות אינטראקטיביות לצד תוצאות הכלים; לקוחות אחרים יכולים להשתמש בטקסט ובנתונים המובנים. זמינות הניתוחים תלויה בהרשאות ובתוכנית שלכם.

בדיקת plugin מקומי

ה-plugin כולל את ה-skill ואת חיבור ה-MCP. הוא זמין לבדיקה מקומית ואינו מופיע כרגע במדריך ה-plugins הציבורי של OpenAI. עקבו אחר הוראות המאגר לגרסה הזמינה בו; חבילת בדיקה מקומית עשויה להיות שונה מהגרסה הציבורית.

דרישות עבור skill ו-CLI

npx זמין בסביבה שבה Codex משתמש
גישה להתחברות עם Google או GitHub שתרצו לחבר כאשר Codex פותח את אישור הדפדפן

חלופה: התקנת Agent Analytics skill

npx skills add agent-analytics/skills

אחר כך בקשו מ-Codex:

Set up Agent Analytics for this project. Install it here if needed. Open the browser for me or give me a login link, then wait. I will sign in with Google or GitHub, approve it, and paste back any finish code if you need it. Then create the project, add tracking and key events, and verify the first event.

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

בדיקת ההתקנה

בקשו מ-Codex:

List my Agent Analytics projects
How is my-site doing this week?
Create an experiment for the signup CTA on my-site

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

פתרון תקלות

אם חיבור MCP לא מחזיר פרויקטים, בדקו שאישרתם את החשבון הנכון.
אם הכלי מחזיר נתונים אבל התצוגה לא מופיעה, בדקו תמיכה ב-MCP Apps ופתחו שיחה חדשה אחרי רענון החיבור. מעבר ל-CLI אינו עוקף הרשאות או מגבלות תוכנית.
אם ה-skill נעצר בשלב האישור, השלימו את ההתחברות בדפדפן והדביקו חזרה כל finish code אם Codex מבקש אותו.
אם בחרתם במפורש במסלול הידני/המתקדם של API key, בדקו ש-AGENT_ANALYTICS_API_KEY קיים בסביבה שבה הסוכן באמת רץ.
אם npx לא זמין, התקינו קודם את סביבת Node.js הנדרשת או עברו זמנית למסלול של API ישיר.
אם אתם צריכים דיבוג ברמת endpoint, השתמשו ב-API reference ובדקו עם curl.