# פתרון בעיות

> תקנו בעיות נפוצות ב-MCP של Nodaro: כתובת שרת שגויה, התחברות שנכשלה, כלים חסרים, משימות שנכשלו, העלאות וקודי שגיאה כמו client_not_allowed.

Source: https://nodaro.ai/he/docs/mcp/troubleshooting

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

## חיבור והתחברות
### הלקוח מציג שגיאת OAuth כשמוסיפים את המחבר
1. ודאו שהכתובת היא בדיוק `https://mcp.nodaro.ai/mcp`, בלי לוכסן בסוף.
2. ודאו ששאילתת DNS ל-`mcp.nodaro.ai` מחזירה כתובת ברשת שלכם.
3. בדקו את מסמך הגילוי. הפקודה הזאת אמורה להחזיר `200` עם JSON:

```bash
curl https://mcp.nodaro.ai/.well-known/oauth-protected-resource
```

באותו מארח זמין גם `/.well-known/oauth-authorization-server`, וגם הוא אמור להחזיר `200` עם JSON.

### ההתחברות לא מסתיימת, או שהכתובת שגויה
השרת עונה רק בכתובת `https://mcp.nodaro.ai/mcp`. בשתי טעויות נפוצות, החיבור נכשל עוד לפני שההתחברות מגיעה ל-Nodaro:

- **`https://api.nodaro.ai/mcp`**: הדומיין הזה לא קיים, ולכן החיבור נכשל כבר בשלב חיפוש השם.
- **`https://app.nodaro.ai/mcp`**: זה דף האינטרנט על MCP, לא השרת. בקשת `POST` לכתובת הזאת מחזירה `405` עם קוד השגיאה `wrong_mcp_host`, שמציין את הכתובת הנכונה.

Claude לא מאפשר לערוך את הכתובת של מחבר. מחקו את המחבר התקול והוסיפו אותו שוב עם `https://mcp.nodaro.ai/mcp`.

### מסך ההסכמה מציג אזהרה כתומה על שם הלקוח
זה צפוי. לקוח שרושם את עצמו בוחר את השם שלו בעצמו, למשל "Claude", ו-Nodaro לא מאמת אותו. האזהרה מזכירה לכם לוודא, לפני שתלחצו על **אישור**, שהאפליקציה שמבקשת גישה היא זו שאתם מגדירים.

### הרישום נכשל עם "Client not allowed" (הלקוח לא מורשה)
הלקוח שלכם נרשם עם שם שלא נמצא ברשימת הלקוחות המאושרים. אפשר:

- להשתמש בלקוח נתמך, כמו Claude, ChatGPT, Cursor, Cline, Continue או Goose.
- לרשום יישום מפתחים בכתובת [app.nodaro.ai/settings/developer-apps](https://app.nodaro.ai/settings/developer-apps) ולהשתמש במזהה הלקוח ובסוד שלו. ראו את הדף [לקוח משלכם](https://nodaro.ai/docs/mcp/connect/custom-client).
- במופע משלכם, לבקש ממנהל השרת להוסיף את שם הלקוח ל-`MCP_DCR_ALLOWLIST`, או להגדיר `MCP_DYNAMIC_REGISTRATION=open`. ראו את הדף [MCP בהתקנה באירוח עצמי](https://nodaro.ai/docs/self-hosting/mcp).

### העוזר הפסיק לעבוד אחרי זמן מה
הגישה תקפה ל-90 ימים, ואין אסימוני רענון. כשתוקף הגישה פג, קריאות מחזירות `401`. התחברו שוב מהלקוח שלכם, או הסירו את המחבר והוסיפו אותו שוב.

### הרצות שלא התחלתם מסומנות בתג דרך MCP
לקוח MCP מחובר התחיל אותן בשמכם. פתחו את **הגדרות › אפליקציות מחוברות**, בכתובת [app.nodaro.ai/settings/connected-apps](https://app.nodaro.ai/settings/connected-apps). הדף מציג כל אפליקציה ועוזר AI עם גישה לחשבון שלכם, לצד תאריך החיבור ותאריך השימוש האחרון של כל אחד מהם.

- עוזר שרשם את עצמו מופיע ברשימה בשם ״עוזר AI (MCP) — השם נקבע על ידי העוזר״. Nodaro לא אימת את השם הזה.
- כדי להסיר אפליקציה שלא ציפיתם לראות, לחצו על **ביטול גישה** ואשרו. הגישה שלה מסתיימת מיד, והאסימונים שלה מפסיקים לעבוד.

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

- **כלי היצירה של ה-Studio** צריכים גם את `workflows:write` וגם את `workflows:execute`. כשיש רק אחת מהשתיים, אף אחד מהכלים האלה לא מופיע.
- **כלי סביבות העבודה** צריכים את `workspaces:read` ואת `workspaces:write`, וחיבורים שאושרו לפני שהיו סביבות עבודה לא כוללים אותן. כדי לקבל אותן, חברו את הלקוח מחדש.

הסעיף [הרשאות](https://nodaro.ai/docs/mcp/tools#permissions) בדף מדריך כלי ה-MCP מפרט איזה כלי צריך איזו הרשאה.

### כלי שמופיע בתיעוד לא נמצא ברשימה שלכם בכלל
חלק מהכלים קיימים רק ב-Nodaro Cloud, למשל כלי הפייפליינים, כלי הפקות Studio, כלי ה-Recast וכלי סביבות העבודה, `start_film_director`, `create_explainer`, `plan_edit`, `voice_changer_pro`, `pro_3d_render` וכלי הקרדיטים. כלי סביבות העבודה צריכים גם שתמיכת הארגונים תהיה מופעלת, ו-`pro_3d_render` מופיע רק כשמנוע הרינדור שלו זמין. ראו את הסעיף [כלים שקיימים רק ב-Nodaro Cloud](https://nodaro.ai/docs/mcp/tools#tools-only-on-nodaro-cloud) בדף מדריך כלי ה-MCP.

## משימות ותוצאות
### יצירה נכשלה
בקשו מהעוזר לקרוא ל-`get_job` או ל-`diagnose_run` עם מזהה המשימה. בדקו את `retryable` ואת `guidance`: כש-`retryable` הוא `false`, אותה בקשה תיכשל שוב אם לא תשנו אותה, ולכן שנו את ההגדרות או את הקלט. כשיש `suggestedProvider`, הריצו את אותו פרומפט ואת אותם ייחוסים במודל המוצע. הפרטים נמצאים בסעיף [כשמשימה נכשלת](https://nodaro.ai/docs/mcp/tools/jobs#when-a-job-fails) בדף משימות. קרדיטים ששוריינו למשימה שנכשלה מוחזרים, אלא אם הכשל קרה בפוסט־עיבוד.

### משימה מציגה את הסטטוס `pending_review`
הפריסה מעכבת תוצאות עד שאדם יבדוק אותן. המשימה עדיין רצה, והיא לא נכשלה. המשיכו לבדוק את הסטטוס שלה, ואל תריצו אותה שוב: גם משימה כפולה תעוכב.

### הכלי `wait_for_job` מחזיר `timeout`
זו לא שגיאה. המשימה עדיין רצה כשההמתנה הסתיימה, אחרי 120 שניות לכל היותר. קראו שוב ל-`wait_for_job`, או בדקו את הסטטוס עם `get_job` כל 5–10 שניות. סרטונים לוקחים בדרך כלל בין 2 ל-10 דקות.

### כרטיס התוצאה לא מופיע
כרטיסים דורשים לקוח שמציג MCP Apps, כמו Claude בדפדפן. בלקוחות אחרים, בקשו מהעוזר לבדוק את המשימה עם `get_job`. התוצאה תמיד נשמרת בספרייה שלכם.

### הרצה חויבה פעמיים אחרי פסק זמן
העבירו `client_request_id` בקריאות ל-`run_workflow`, ל-`run_app`, ל-`run_component` ולכלי ההפקה, והשתמשו באותו ערך גם בניסיון החוזר. Nodaro מחזיר אז את ההרצה הראשונה, במקום להתחיל הרצה שנייה ולגבות עליה קרדיטים.

## העלאות
### הכלי `prepare_image_upload` נכשל ב-Claude בדפדפן
העלאה עם כתובת חתומה מראש דורשת לקוח שיכול להגיע למארח האחסון מתוך shell, כמו Cursor, Cline, Claude Desktop או Claude Code. ב-Claude בדפדפן ובאנדרואיד, השתמשו ב-`upload_image_widget`, או ב-`request_image_upload`, שנותן לכם קישור לפתיחה בדפדפן. ראו את הדף [כלי העלאה](https://nodaro.ai/docs/mcp/tools/uploads).

## תהליכים
### הכלי `update_workflow_json` מודיע שהתהליך שונה
מישהו שינה את התהליך אחרי שקראתם אותו. קראו אותו שוב עם `get_workflow_json`, ואז שלחו שוב את השינוי עם הגרסה החדשה.

### הגדרה ששלחתם היא לא זו שנשמרה
לא כל מודל מקבל כל יחס גובה־רוחב, רזולוציה או איכות. Nodaro משנה ערך לא נתמך לערך נתמך, או מסיר אותו, ומפרט כל שינוי תחת `adjustments`. אל תשלחו שוב את הערך המקורי; בחרו מודל שתומך בו, בעזרת `list_models`.

### הקנבס של במאי הקולנוע נשאר ריק
הסקיל מוסיף את הרכיבים של שלב בבת אחת, אחרי שאתם מאשרים את השלב. חכו עד ש-Claude אומר שהוסיף אותם, ואז רעננו את הדף. פתרונות נוספים בדף [במאי קולנוע](https://nodaro.ai/docs/mcp/film-director#if-something-goes-wrong).

## קודי שגיאה
| קוד | כלי | משמעות | מה לעשות |
| --- | --- | --- | --- |
| `wrong_mcp_host` | השרת | הלקוח קרא לדף האינטרנט בכתובת `app.nodaro.ai/mcp` | השתמשו ב-`https://mcp.nodaro.ai/mcp` |
| `client_not_allowed` | רישום | שם הלקוח לא מאושר | השתמשו בלקוח נתמך או ביישום מפתחים |
| `too_many_open_registrations` | רישום | יותר מדי רישומים של אותו לקוח שלא נעשה בהם שימוש, במצב `open` | השתמשו ברישומים שכבר יש לכם, או חכו |
| `dcr_disabled` | רישום | במופע הזה הרישום העצמי כבוי | השתמשו במזהה לקוח ובסוד שקיבלתם ממנהל השרת |
| `voice_not_found` | כלי דיבור | מזהה הקול לא קיים | השתמשו בשם של קול מוכן מראש, או בקול ששיבטתם |
| `advanced_mode_unsupported` | כלי פרומפטים וטקסט | הבקשה השתמשה ב-`advanced_mode` עם מודל שהוא לא מודל Gemini או Claude | בחרו מודל Gemini או Claude, או כבו את המצב המתקדם |
| `advanced_mode_unavailable` | כלי פרומפטים וטקסט | הספק של המודל עצמו לא יכול לקבל כרגע בקשות במצב מתקדם. הקרדיטים לא נגבים, או מוחזרים | כבו את המצב המתקדם כדי להריץ את המודל, או נסו שוב מאוחר יותר |
| `locked_field` | `run_app` | הפרמטר `inputOverrides` ניסה לשנות את היעד שאליו נשלח פלט | השאירו את היעדים כפי שהאפליקציה מגדירה אותם |
| `portrait_required` | `generate_character` | לדמות אין פורטרט מאושר | אשרו קודם פורטרט עם `approve_portrait` |
| `main_image_required` | כלי מיקומים, אובייקטים ויצורים | אין תמונה ראשית מאושרת | אשרו קודם תמונה ראשית |
| `candidate_object_mismatch`, `candidate_creature_mismatch` | כלי אישור | המועמד נוצר בשביל אובייקט אחר או יצור אחר | אשרו מועמד שנוצר עבורו |
| `scene_overlap` | `resolve_shot_sequence` | לשתי סצנות יש חשיפות באותו פרק זמן | ודאו שכל סימני הזמן של סצנה באים לפני סימני הזמן של הסצנה הבאה |
| `not_available` | כלי הפקות Studio | הפריסה לא תומכת בהפקות Studio | אל תנסו שוב; התכונה לא זמינה שם |
| `studio_preview_unavailable` | `edit_studio_production` | הפריסה לא יכולה להציג תצוגה מקדימה של אצווה | שום דבר לא נשלח; החליטו עם המשתמש אם להחיל את האצווה בלי תצוגה מקדימה |
| `not_finished` | `import_studio_production` | משימת התכנון עדיין רצה | חכו שהמשימה תסתיים, ואז ייבאו |
| `cloud_only_feature` | `combine_videos` | הבקשה השתמשה ב-`smart_cut` בהתקנה באירוח עצמי | אחדו את הקליפים בלי `smart_cut` |
| `payer_balance_jwt_only` | `check_balance`, `credit_transactions` | לקוח מחובר לא יכול לקרוא את חשבון החיוב המשותף של הפריסה | בדקו את היתרה באפליקציה |

## שאלות נפוצות

### למה הלקוח שלי מציג את Nodaro כמחובר, אבל בלי כלים?

ההרשאות שאושרו במסך ההסכמה לא מכסות את הכלים. הסירו את המחבר, הוסיפו אותו שוב ואשרו כל הרשאה.

### באיזו כתובת להשתמש לשרת ה-MCP של Nodaro?

השתמשו בדיוק בכתובת https://mcp.nodaro.ai/mcp, בלי לוכסן בסוף. הדומיין api.nodaro.ai לא קיים, והכתובת app.nodaro.ai/mcp היא דף אינטרנט, לא השרת.

### מה המשמעות של client_not_allowed?

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

### העוזר שלי הפסיק לעבוד אחרי כמה חודשים. למה?

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

### אני רואה הרצות עם התג דרך MCP שלא התחלתי. מה לעשות?

את ההרצות האלה התחיל בשמכם לקוח מחובר. פתחו את הדף הגדרות › אפליקציות מחוברות בכתובת app.nodaro.ai/settings/connected-apps, עברו על כל אפליקציה ועוזר AI עם גישה לחשבון שלכם, ובטלו את הגישה של כל מי שלא ציפיתם לראות שם. ביטול הגישה נכנס לתוקף מיד.