פתרון בעיות

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

חיבור והתחברות

הלקוח מציג שגיאת OAuth כשמוסיפים את המחבר

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

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 ולהשתמש במזהה הלקוח ובסוד שלו. ראו את הדף לקוח משלכם.
• במופע משלכם, לבקש ממנהל השרת להוסיף את שם הלקוח ל-MCP_DCR_ALLOWLIST, או להגדיר MCP_DYNAMIC_REGISTRATION=open. ראו את הדף MCP בהתקנה באירוח עצמי.

העוזר הפסיק לעבוד אחרי זמן מה

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

הרצות שלא התחלתם מסומנות בתג דרך MCP

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

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

כלים חסרים

הלקוח מחובר, אבל לא מציג כלים, או מציג רק חלק מהם

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

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

הסעיף הרשאות בדף מדריך כלי ה-MCP מפרט איזה כלי צריך איזו הרשאה.

כלי שמופיע בתיעוד לא נמצא ברשימה שלכם בכלל

חלק מהכלים קיימים רק ב-Nodaro Cloud, למשל כלי הפייפליינים, כלי הפקות Studio, כלי ה-Recast וכלי סביבות העבודה, start_film_director, create_explainer, plan_edit, voice_changer_pro, pro_3d_render וכלי הקרדיטים. כלי סביבות העבודה צריכים גם שתמיכת הארגונים תהיה מופעלת, ו-pro_3d_render מופיע רק כשמנוע הרינדור שלו זמין. ראו את הסעיף כלים שקיימים רק ב-Nodaro Cloud בדף מדריך כלי ה-MCP.

משימות ותוצאות

יצירה נכשלה

בקשו מהעוזר לקרוא ל-get_job או ל-diagnose_run עם מזהה המשימה. בדקו את retryable ואת guidance: כש-retryable הוא false, אותה בקשה תיכשל שוב אם לא תשנו אותה, ולכן שנו את ההגדרות או את הקלט. כשיש suggestedProvider, הריצו את אותו פרומפט ואת אותם ייחוסים במודל המוצע. הפרטים נמצאים בסעיף כשמשימה נכשלת בדף משימות. קרדיטים ששוריינו למשימה שנכשלה מוחזרים, אלא אם הכשל קרה בפוסט־עיבוד.

משימה מציגה את הסטטוס 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, שנותן לכם קישור לפתיחה בדפדפן. ראו את הדף כלי העלאה.

תהליכים

הכלי update_workflow_json מודיע שהתהליך שונה

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

הגדרה ששלחתם היא לא זו שנשמרה

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

הקנבס של במאי הקולנוע נשאר ריק

הסקיל מוסיף את הרכיבים של שלב בבת אחת, אחרי שאתם מאשרים את השלב. חכו עד ש-Claude אומר שהוסיף אותם, ואז רעננו את הדף. פתרונות נוספים בדף במאי קולנוע.

קודי שגיאה