# מדריך כלי ה-MCP

> כל הכלים ששרת ה-MCP של Nodaro חושף, מקובצים לפי תחום, עם ההרשאה שכל כלי צריך, איך משימות מדווחות על התוצאות ואיך לקרוא את התיעוד של כלי.

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

**כלי ה-MCP של Nodaro** הם הפעולות שעוזר AI יכול לבצע בחשבון ה-Nodaro שלכם אחרי שהוא מתחבר ל[שרת ה-MCP של Nodaro](https://nodaro.ai/docs/mcp). יש כ-200 כלים כאלה, והם מקובצים כאן לפי תחום: יצירת מדיה ועריכה שלה, ניהול נכסים, בנייה והרצה של תהליכים, ובימוי של הפקות שלמות. כל דף מפרט את השמות המדויקים של הכלים, את ההרשאה שכל כלי צריך, את הפרמטרים העיקריים שלו, מה הוא מחזיר וכמה הוא עולה.

## קבוצות הכלים
| קבוצה | מה הכלים עושים |
| --- | --- |
| [משימות](https://nodaro.ai/docs/mcp/tools/jobs) | בדיקה של משימות והרצות, המתנה להן, הצגתן ברשימה, דירוג ואבחון |
| [העלאות](https://nodaro.ai/docs/mcp/tools/uploads) | העלאת התמונות, האודיו והווידאו שלכם ל-Nodaro |
| [גלריה ונכסים](https://nodaro.ai/docs/mcp/tools/gallery-and-assets) | עיון בגלריה ובהעלאות שלכם, הצגת תוצאה בצ׳אט וסימון מועדפים |
| [מודלים, קרדיטים וערכות](https://nodaro.ai/docs/mcp/tools/models-and-credits) | רשימת המודלים עם היכולות והמחירים שלהם, קריאת היתרה שלכם, ושמירה והחלה של ערכות |
| [סביבות עבודה](https://nodaro.ai/docs/mcp/tools/workspaces) | בחירת סביבת העבודה של הארגון שבה הסשן עובד |
| [פרויקטים ותהליכים](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) | יצירה, עריכה, ייבוא, ייצוא והרצה של תהליכים, לימוד המבנה של הרכיבים, וארגון סשנים של יצירה |
| [אפליקציות ורכיבים שמורים](https://nodaro.ai/docs/mcp/tools/apps-and-components) | הרצת אפליקציות שפורסמו ורכיבים שמורים |
| [פייפליינים](https://nodaro.ai/docs/mcp/tools/pipelines) | התחלה, הכוונה ואישור של פייפליינים של **סיפור ← וידאו** |
| [פרומפטים וטקסט](https://nodaro.ai/docs/mcp/tools/prompts-and-text) | כתיבת פרומפטים טובים יותר, כתיבת תסריטים ובחירת הטובה מבין כמה תוצאות |
| [תמונה](https://nodaro.ai/docs/mcp/tools/image) | יצירה, המרה, עריכה, שילוב שכבות ותיאור של תמונות, ושמירת פלטות ומודבורדים |
| [וידאו](https://nodaro.ai/docs/mcp/tools/video) | יצירה, הרחבה, שינוי סגנון והגדלה של וידאו, וסרטונים של אנשים שמדברים וזזים |
| [עריכת וידאו](https://nodaro.ai/docs/mcp/tools/video-editing) | קיצוץ, איחוד, לולאה, כתוביות, שכבות והרכבה של וידאו |
| [ניתוח ורשימות עריכה](https://nodaro.ai/docs/mcp/tools/analysis-and-edl) | ניתוח של סרטון סצנה אחר סצנה, זיהוי שקט, סנכרון הקלטות ורינדור של רשימות עריכה |
| [אודיו](https://nodaro.ai/docs/mcp/tools/audio) | דיבור, דיאלוג, קולות, דיבוב, אפקטי קול, תמלול וניקוי |
| [מוזיקה](https://nodaro.ai/docs/mcp/tools/music) | שירים וקטעים אינסטרומנטליים עם Suno ומודלי מוזיקה אחרים |
| [דמויות](https://nodaro.ai/docs/mcp/tools/characters) | יצירת דמויות, יצירת פורטרטים ווריאנטים שלהן, הנפשה שלהן ואימון מודלים של דמויות |
| [מיקומים](https://nodaro.ai/docs/mcp/tools/locations) | יצירת מיקומים, שוטים פותחים וקליפי אווירה |
| [אובייקטים ויצורים](https://nodaro.ai/docs/mcp/tools/objects-and-creatures) | אביזרים, מוצרים, חיות ויצורים עם מראה נעול |
| [רצף שוטים ובמאי וידאו](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director) | סרטוני גרפיקת תנועה עם קריינות, שמתוזמנים לפי הקריינות |
| [הפקות Studio](https://nodaro.ai/docs/mcp/tools/studio-productions) | סרטים שאפשר להמשיך לערוך בעורך של Studio |
| [כלי ה-Recast](https://nodaro.ai/docs/mcp/tools/recast) | סרט שנכתב כתסריט JSON אחד ומרונדר כפרויקט Recast |
| [סצנות תלת־ממד](https://nodaro.ai/docs/mcp/tools/3d-scenes) | סצנות תלת־ממד שאפשר לערוך, מרונדרות לווידאו |
| [כלי עזר, מתכונים וסקילים](https://nodaro.ai/docs/mcp/tools/utility) | בדיקת החיבור, טעינת מתכונים וסקילים, צילום דפי אינטרנט ובניית סרטוני UGC |

## הרשאות
כל כלי צריך הרשאת OAuth אחת או יותר (scopes), שאתם מאשרים במסך ההסכמה כשאתם מחברים את העוזר. כלי שלא אישרתם את ההרשאות שלו נשמט מרשימת הכלים לגמרי. העוזר אף פעם לא רואה אותו, ולכן הוא לא יכול לקרוא לו ולהיכשל.

| הרשאה | כלים |
| --- | --- |
| `workflows:read` | `list_projects`, `get_project`, `list_workflows`, `get_workflow`, `get_workflow_json`, `export_workflow`, `list_components`, `get_component_inputs`, `get_recast_status`, `validate_studio_plan`, `list_studio_productions`, `get_studio_production`, `plan_studio_export` |
| `workflows:write` | `create_workflow`, `delete_workflow`, `update_workflow_json`, `import_workflow`, `import_recast_script`, `create_studio_production`, `import_studio_production`, `edit_studio_production`, `share_studio_production`, `clone_studio_production` |
| `workflows:execute` | `run_workflow`, `render_final`, `run_app`, `retry_app_run`, `run_component`, `delete_app_run`, `mix_audio`, `capture_site`, כל כלי יצירה, עריכה וניתוח של תמונה, וידאו, אודיו, מוזיקה, נכסים וסצנות תלת־ממד, כלי הפרומפטים, `reduce`, כלי רצף השוטים, `create_explainer`, `create_launch_video`, `start_recast`, `resolve_recast_gate`, `cast_swap`, `estimate_trend`, `run_trend`, `tighten_episode`, `continue_use_case` |
| `workflows:write` ו-`workflows:execute` יחד | `describe_studio_production`, `generate_studio_still`, `generate_studio_keyframe`, `generate_studio_clip`, `new_studio_shot_from_frame`, `voice_studio_shot`, `revoice_studio_clip`, `score_studio_production` |
| `workflows:execute` ו-`assets:write` יחד | `train_character` |
| `jobs:read` | `list_jobs`, `get_job`, `wait_for_job`, `diagnose_run`, `list_sessions`, `read_session`, `list_trash`, `list_trends`, `get_trend` |
| `assets:read` | `browse_gallery`, `browse_uploads`, `list_favorites`, `get_asset`, `display_asset`, `get_app_run`, `list_characters`, `get_character`, `list_locations`, `get_location`, `list_objects`, `get_object`, `list_creatures`, `get_creature`, `list_palettes`, `list_moodboards` |
| `assets:write` | `favorite_asset`, `create_character`, `update_character`, `approve_portrait`, `recaption_character`, `create_location`, `update_location`, `approve_main_image`, `recaption_location`, `approve_object_main_image`, `recaption_object`, `approve_creature_main_image`, `recaption_creature`, `rate_job`, `create_session`, `update_session`, `restore_job`, `save_palette`, `save_moodboard`, `save_node_preset`, `delete_node_preset`, `favorite_node_preset` ותשעת כלי ההעלאה |
| `credits:read` | `check_balance`, `credit_transactions` |
| `apps:read` | `list_apps`, `get_app_inputs` |
| `presets:read` | `list_node_presets`, `get_node_preset` |
| `pipelines:read` | `get_pipeline_stage_chat`, `get_pipeline_status`, `pipeline_pending_approvals` |
| `pipelines:execute` | `branch_pipeline`, `start_pipeline` |
| `pipelines:approve` | `chat_pipeline_stage`, `apply_chat_proposal` |
| `workspaces:read` | `list_workspaces` |
| `workspaces:write` | `select_workspace` |

הכלים האלה לא צריכים הרשאה ותמיד גלויים, במהדורות שבהן הם קיימים: `ping`, `list_models`, `start_film_director`, `start_video_director`, `start_workflow_editor`, `get_node_skill`, `get_picker_catalog`, `list_shot_shapes`, `get_shot_shape`, `list_brand_presets`, `get_recipe`, `get_studio_production_skill`, `get_recast_authoring_skill`, `validate_recast_script`, `build_ugc_creator`, `build_ugc_clips`, `build_ugc_cards`, `ugc_split_speech` ו-`ugc_finish_clips`.

כלים שצריכים שתי הרשאות מופיעים רק כששתיהן אושרו. חיבור שיש לו רק אחת מהשתיים לא רואה אף אחד מהכלים האלה.

## איך משימה מדווחת על התוצאה שלה
רוב כלי היצירה מתחילים **משימה** ועונים מיד בשורה כגון `image collage started (id 7f3c…).` (קולאז׳ התמונות התחיל). המשימה רצה ב-Nodaro, והתוצאה שלה תמיד נשמרת גם בספרייה שלכם.

- **בלקוחות שמציגים MCP Apps**, כמו Claude בדפדפן, הכלי מציג כרטיס. הכרטיס מציג התקדמות בזמן אמת, ואחר כך את התוצאה המוכנה. לכלי תמונה, וידאו ואודיו יש כרטיסים משלהם. כל שאר הכלים שמתחילים משימה חולקים כרטיס אחד שמזהה את הפלט שלהם: נגן לווידאו, לתמונה או לאודיו, טקסט עם הכפתור **Copy** (העתקה) לתסריטים, למילות שירים, לתמלולים ולנתוני יישור, או הפלטים של רכיב שמור, אחד מתחת לשני.
- **בלקוחות אחרים**, העוזר בודק את המשימה עם [`get_job`](https://nodaro.ai/docs/mcp/tools/jobs#get_job) כל 5–10 שניות, או ממתין עד 45 שניות בכל קריאה עם [`wait_for_job`](https://nodaro.ai/docs/mcp/tools/jobs#wait_for_job). תמונה מוכנה בדרך כלל בתוך דקה. סרטון לוקח בדרך כלל בין 2 ל-10 דקות.
- **הרצות של תהליכים ושל אפליקציות** מחזירות מזהה הרצה במקום מזהה משימה. בדקו את ההרצה עם [`get_app_run`](https://nodaro.ai/docs/mcp/tools/gallery-and-assets#get_app_run).

לקוחות שתומכים ב-API של `tasks` ב-MCP מקבלים דרכו גם את ההתקדמות. כשמשימה ממתינה לבדיקה של אדם, בפריסה שבודקת תוצאות, הסטטוס שלה ב-`tasks` הוא `input_required`. ההחלטה הזאת שייכת לבודק: אל תריצו את המשימה שוב.

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

| כלים | לאן יש להם גישה |
| --- | --- |
| `list_projects`, `get_project` | כל הפרויקטים שלכם, לקריאה בלבד |
| `list_workflows`, `get_workflow`, `get_workflow_json` | תהליכים בפרויקט mcp |
| `create_workflow`, `delete_workflow`, `update_workflow_json`, `import_workflow` | תהליכים בפרויקט mcp |
| `export_workflow` | כל אחד מהתהליכים שלכם |
| `run_workflow`, `render_final` | תהליכים בפרויקט mcp |

כדי לתת לעוזר לעבוד על תהליך מפרויקט אחר, ייצאו את התהליך עם `export_workflow` וייבאו את החבילה עם `import_workflow`. העותק נשמר בפרויקט mcp, והמקור שלכם נשאר בלי שינוי.

## איך לקרוא את התיעוד של כלי
לכל כלי בדפים האלה יש אותו מבנה:

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

התיאור של הכלי עצמו, שהעוזר קורא כשהוא מתחבר, הוא הקובע לגבי פרמטרים ומגבלות. מחיר שמופיע בתיאור של כלי יכול להיות שונה מהסכום שנגבה על הרצה. [`list_models`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_models) מחזיר את המחירים הנוכחיים של המודלים. הכפתור **הרצה** של רכיב מציג את המחיר של ההרצה שלו.

## מוסכמות משותפות לכלים רבים
- **מדיה לפי כתובת או לפי מזהה.** כלים שמקבלים מדיה מקבלים כתובת `https` ציבורית, כגון `image_url`, או מזהה של Nodaro, כגון `image_asset_id`. המזהה יכול להיות של המשימה שיצרה את המדיה, או של העלאה.
- **מודלים לפי מזהה.** פרמטר `model` מקבל מזהה מודל מ-[`list_models`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_models), שמחזיר גם את יחסי הגובה־רוחב, הרזולוציות, האורכים והמחירים של כל מודל.
- **ערכות.** הכלים `generate_image`, `generate_video`, `generate_music`, `generate_speech` ו-`text_to_audio` מקבלים `presetId` מ-[`list_node_presets`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets). שדות שאתם שולחים בעצמכם גוברים על הערכה.
- **אסימוני ניסיון חוזר.** הכלים `run_workflow`, `run_app`, `run_component` וכמה כלי הפקה מקבלים `client_request_id`: בין 8 ל-128 תווים של אותיות, ספרות ו-`_ - . :`. שלחו את אותו ערך כשאתם מנסים שוב אחרי פסק זמן, ו-Nodaro לא מתחיל את העבודה פעמיים ולא גובה עליה פעמיים.
- **אומדן מחיר לפני הוצאה.** כמה כלים יכולים לתמחר עבודה בלי להתחיל אותה, למשל כלי ה-Studio עם `dry_run: true`, ו-`start_recast`, `cast_swap`, `run_trend` ו-`full_quality` בלי `confirm`.

## כלים שקיימים רק ב-Nodaro Cloud
הכלים האלה קיימים רק ב-Nodaro Cloud: `check_balance`, `credit_transactions`, `train_character`, `plan_edit`, `switch_cameras`, `voice_changer_pro`, `voice_changer_pro_analyze`, `voice_changer_pro_export`, `create_explainer`, `create_launch_video`, `start_film_director`, `pro_3d_render`, `cast_swap`, [כלי הטרנדים](https://nodaro.ai/docs/mcp/tools/video#trends), [כלי סביבות העבודה](https://nodaro.ai/docs/mcp/tools/workspaces), [כלי ה-Recast](https://nodaro.ai/docs/mcp/tools/recast), [כלי הפקות ה-Studio](https://nodaro.ai/docs/mcp/tools/studio-productions), [כלי הפייפליינים](https://nodaro.ai/docs/mcp/tools/pipelines) ו[כלי ה-UGC](https://nodaro.ai/docs/mcp/tools/utility#the-ugc-video-builders). גם [`estimate_full_quality` ו-`full_quality`](https://nodaro.ai/docs/mcp/tools/video#full-quality) קיימים רק שם. כלי סביבות העבודה דורשים גם שתכונת הארגונים תהיה מופעלת, ו-`pro_3d_render` מופיע רק כשמנוע הרינדור שלו זמין.

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

### כמה כלים יש בשרת ה-MCP של Nodaro?

ב-Nodaro Cloud יש בשרת ה-MCP כ-200 כלים. הרשימה המדויקת תלויה בהרשאות שאישרתם ובמהדורה שלכם, כי כלי שאי אפשר להשתמש בו נשמט מרשימת הכלים.

### איך העוזר שלי מקבל את התוצאה של יצירה?

כלי יצירה מתחיל משימה ומחזיר מיד את המזהה שלה. לקוחות שמציגים MCP Apps מציגים כרטיס עם התקדמות בזמן אמת ועם התוצאה; לקוחות אחרים קוראים ל-get_job או ל-wait_for_job עם המזהה הזה.

### למה העוזר יכול לערוך רק תהליכים שבפרויקט mcp?

כלי התהליכים עובדים בתוך פרויקט אחד בשם mcp, כך שעוזר AI אף פעם לא משנה את הפרויקטים שלכם. העוזר עדיין יכול לקרוא כל תהליך עם export_workflow ולייבא עותק שלו לפרויקט mcp.

### אילו כלים לא עולים כלום?

כלי הגילוי והמדריכים, כגון ping, list_models, get_node_skill, get_picker_catalog, list_shot_shapes ו-get_recipe, לא עולים כלום. כל כלי שיוצר, עורך או מנתח מדיה מוציא קרדיטים.