פתרון בעיות בחיבור סוכני AI

הסוכן לא מצליח להיכנס

אם אפליקציית ה-AI שלכם מציגה שגיאת כניסה, או ממשיכה לבקש מכם להתחבר:

1. התחילו את החיבור מחדש מאפליקציית ה-AI. ב-Claude Code, הקלידו /mcp, בחרו את החיבור של Metaintro והיכנסו שוב.

2. ודאו שאתם נכנסים לחשבון Metaintro שבו אתם רוצים שהסוכן ישתמש.

3. בדף של Metaintro שנפתח, בחרו אישור. אם מופיע "פג התוקף של הקישור הזה", חזרו לאפליקציית ה-AI והתחילו מחדש.

4. בדקו את הכתובת שהוספתם. היא צריכה להיות בדיוק https://www.metaintro.com/api/mcp, או https://www.metaintro.com/api/mcp/org/<org-slug> עבור ארגון. הקטע איך מתחילים בהגדרות > סוכנים, או בכרטיסייה סוכני ה-AI שלי בהגדרות הארגון, מציג את הכתובת הנכונה עם כפתור להעתקתה.

אם התחברתם עם מפתח אישי, ייתכן שהסוכן יקבל את ההודעה: "Sign in through your AI client, or send a Metaintro personal API key…". המשמעות היא שהמפתח חסר, הוקלד לא נכון, פג תוקפו או נותק. מפתחות תקפים ל-90 יום. בהגדרות > סוכנים, פתחו את הכרטיסייה אפליקציות אחרות תחת איך מתחילים, בחרו יצירת מפתח API ועדכנו את ההגדרה באפליקציה שלכם.

ב-Codex, הריצו codex mcp login metaintro. ב-Pi, הריצו pi mcp login metaintro. לארגון, השתמשו בשם החיבור שלו, למשל metaintro-<org-slug>. עם התוסף pi-mcp-adapter, התחברו במקום זאת מתוך Pi עם /mcp-auth metaintro. כדי לראות אם האפליקציה מחוברת, הריצו codex mcp list או pi mcp list.

הסוכן יכול לקרוא אבל לא לבצע שינויים

אם הסוכן מדווח על insufficient scope, או אומר שהוא לא יכול לבצע שינויים, הוא מחובר עם קריאה בלבד: ברשימה סוכנים שחיברת מופיע לידו קריאה בלבד. נתקו אותו וחברו אותו מחדש. עם מפתח API, בחרו קריאה ופעולה תחת מה מותר לו לעשות. כשנכנסים דרך האפליקציה, בדקו שהדף של Metaintro מציג ביצוע שינויים בשבילכם לפני שאתם בוחרים אישור.

אם ההודעה היא "This credential cannot use the MCP server", המפתח נוצר בלי גישת סוכן. בחרו יצירת מפתח API בכרטיסייה אפליקציות אחרות בהגדרות > סוכנים, או היכנסו שוב דרך אפליקציית ה-AI ואפשרו גישה.

"Organization keys name no person to act as"

אי אפשר להשתמש במפתחות API של ארגון (mi_org_…) עם סוכני AI. סוכן תמיד פועל בשם אדם אחד, כך שכל שינוי נרשם על שם מישהו. השתמשו במפתח אישי מהגדרות > סוכנים, או היכנסו דרך אפליקציית ה-AI שלכם.

"You aren't on this organization's staff"

חיבור של ארגון (/api/mcp/org/<org-slug>) עובד רק עבור אנשים עם תפקיד צוות באותו ארגון. אם מופיעה ההודעה הזו:

• בדקו את שם הארגון בכתובת.

• שאלו מנהל של הארגון אם יש לכם תפקיד צוות. רק אנשי צוות רואים את הכרטיסייה סוכני ה-AI שלי בהגדרות הארגון.

• לחיפוש העבודה שלכם, השתמשו בכתובת האישית https://www.metaintro.com/api/mcp.

"This connection only reaches…"

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

הסוכן לא מוצא את הכלים של מנהלי תיקים

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

"Too many calls from this key. Try again in N seconds."

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

ההודעות "Too many requests" או "Metaintro is temporarily unavailable" בדרך כלל חולפות תוך דקה.

פעולה ממתינה לאישור

אם הסוכן אומר שפעולה ממתינה לאישור, היא לא תקועה. אשרו או דחו אותה תחת בהמתנה לאישור שלך בהגדרות > סוכנים, או בכרטיסייה סוכני ה-AI שלי בהגדרות הארגון אם היא הגיעה דרך החיבור של אותו ארגון. תוקף הבקשות פג אחרי 7 ימים. ראו אישור הפעולות של סוכן ה-AI שלכם.

פעולה נכשלה אחרי שאישרתם אותה

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

• הרשומה השתנתה בינתיים. בקשו מהסוכן לקרוא אותה שוב ולנסות מחדש.

• הסוכן נותק לפני שאישרתם, ולכן שום דבר לא בוצע.

• כבר אין לכם גישה למה שהפעולה הייתה צריכה.

הסוכן אומר שרשומה השתנתה

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

ניתוק או חיבור מחדש של סוכן

1. היכנסו להגדרות > סוכנים, או לכרטיסייה סוכני ה-AI שלי בהגדרות הארגון.

2. מצאו את הסוכן תחת סוכנים שחיברת ובחרו את כפתור המחיקה (פח האשפה) שלו.

3. אשרו עם ניתוק.

הוא מפסיק לעבוד מיד, בכל מקום. כדי להשתמש בו שוב, חברו אותו מחדש מאפליקציית ה-AI שלכם.

לסוכני AI: בדיקת החיבור

עבור על השלבים האלה לפי הסדר:

1. קרא ל-whoami. אם זה עובד, החיבור תקין. שים לב לאיזה חיבור מדובר ומהי הגדרת האישור.

2. אם מתקבלת שגיאת כניסה, בקש מהאדם להתחבר שוב (/mcp ב-Claude Code,‏ codex mcp login metaintro ב-Codex,‏ pi mcp login metaintro ב-Pi (או /mcp-auth metaintro מתוך Pi עם התוסף pi-mcp-adapter)). ודא שהכתובת היא בדיוק https://www.metaintro.com/api/mcp.

3. אם שינוי נדחה בגלל insufficient scope, החיבור הוא קריאה בלבד. ספר לאדם ואל תנסה שוב.

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

5. אם שינוי נדחה כי הרשומה השתנתה, קרא אותה שוב ונסה שוב עם הגרסה החדשה.

עדיין תקועים?

צרו איתנו קשר וצרפו את הודעת השגיאה. אם יש בה מזהה בקשה (request ID), צרפו גם אותו; זה עוזר לנו להבין מה קרה.