# שרת ה-MCP של Nodaro

> חברו את Claude, ChatGPT, Cursor או כל לקוח MCP ל-Nodaro כדי ליצור מדיה, לבנות ולהריץ תהליכים, לנהל דמויות ולביים סרטים מתוך שיחה.

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

**שרת ה-MCP של Nodaro** מאפשר לעוזר AI להשתמש ב-Nodaro בשמכם. אתם מחברים את Claude, ChatGPT, Cursor או לקוח אחר שמדבר בפרוטוקול MCP (Model Context Protocol) ומתחברים עם חשבון ה-Nodaro שלכם. העוזר יכול אז ליצור תמונות, וידאו, קול ומוזיקה, לבנות ולהריץ תהליכים, לנהל את הדמויות שלכם ולביים סרטים שלמים מתוך שיחה. כל מה שהוא יוצר נשמר בספרייה שלכם ב-Nodaro, וכל תהליך שהוא בונה נפתח בעורך.

## כתובת השרת
```text
https://mcp.nodaro.ai/mcp
```

כל הלקוחות משתמשים באותה כתובת. השרת מדבר MCP על גבי Streamable HTTP ומחבר אתכם באמצעות OAuth, ולכן אין מפתח API להעתיק.

שתי כתובות דומות לא עובדות:

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

## חיבור תוך כדקה
### העתקת הכתובת
העתיקו את `https://mcp.nodaro.ai/mcp`.

### הוספה ללקוח שלכם
פתחו את הגדרות המחברים או הגדרות ה-MCP של הלקוח שלכם והוסיפו שרת מרוחק עם הכתובת. ל-Claude, VS Code, Cursor ו-Goose יש גם קישור שפותח את תיבת הדו־שיח עם הפרטים כבר מלאים. בדף [חיבור לקוח](https://nodaro.ai/docs/mcp/connect) מופיעים השלבים המדויקים לכל לקוח.

### התחברות ואישור הגישה
הדפדפן שלכם פותח את דף ההתחברות של Nodaro. התחברו, עברו על ההרשאות במסך ההסכמה ולחצו על **אישור**.

### בקשה מהעוזר
בקשו מהעוזר, למשל: ״צור תמונה של אביר עם Nodaro״. כדי לבדוק רק את החיבור, בקשו ממנו לקרוא לכלי `ping`. הכלי מחזיר את מזהה המשתמש שלכם ב-Nodaro ואת שם הלקוח שלכם.

## מה עוזר AI יכול לעשות
השרת חושף כ-200 כלים. העוזר מגלה אותם בזמן החיבור, ולכן אתם מבקשים במילים פשוטות והוא בוחר את הכלים.

| מטרה | הכלים העיקריים | קריאה נוספת |
| --- | --- | --- |
| יצירה ועריכה של תמונות | `generate_image`, `modify_image`, `edit_image`, `image_overlay` | [כלי תמונה](https://nodaro.ai/docs/mcp/tools/image) |
| יצירת וידאו מטקסט או מתמונה | `generate_video`, `animate_image`, `extend_video`, `lip_sync` | [כלי וידאו](https://nodaro.ai/docs/mcp/tools/video) |
| חיתוך, כתוביות והרכבה של וידאו | `trim_video`, `combine_videos`, `add_captions`, `overlay_images` | [כלי עריכת וידאו](https://nodaro.ai/docs/mcp/tools/video-editing) |
| קול, אפקטי קול ומוזיקה | `generate_speech`, `generate_dialogue`, `text_to_audio`, `suno_generate` | [כלי אודיו](https://nodaro.ai/docs/mcp/tools/audio), [כלי מוזיקה](https://nodaro.ai/docs/mcp/tools/music) |
| בנייה, עריכה והרצה של תהליכים | `create_workflow`, `update_workflow_json`, `run_workflow` | [כלי פרויקטים ותהליכים](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) |
| הרצת האפליקציות שפרסמתם והרכיבים השמורים שלכם, וניסיון חוזר של הרצת אפליקציה שנכשלה | `run_app`, `retry_app_run`, `run_component` | [כלי אפליקציות ורכיבים שמורים](https://nodaro.ai/docs/mcp/tools/apps-and-components) |
| שמירה על עקביות של דמות, מקום או אביזר | `create_character`, `generate_location`, `generate_object`, `generate_creature` | [כלי דמויות](https://nodaro.ai/docs/mcp/tools/characters) |
| בימוי סרט | `start_film_director`, כלי הפקות ה-Studio, כלי ה-Recast | [במאי קולנוע](https://nodaro.ai/docs/mcp/film-director), [הפקות Studio](https://nodaro.ai/docs/mcp/studio-productions), [Recast](https://nodaro.ai/docs/mcp/recast) |
| יצירת סרטון גרפיקת תנועה עם קריינות | `create_explainer`, `create_launch_video` | [במאי וידאו](https://nodaro.ai/docs/mcp/video-director) |
| בנייה ורינדור של סצנת תלת־ממד | `generate_3d_scene`, `edit_3d_scene`, `render_3d_scene` | [סצנות תלת־ממד](https://nodaro.ai/docs/mcp/3d-scenes) |
| ביצוע מתכון בדוק של כמה שלבים | `get_recipe` | [מתכוני תוכן](https://nodaro.ai/docs/mcp/recipes) |

כמה כלים קיימים רק כדי ללמד את העוזר איך לעבוד עם Nodaro. `start_workflow_editor`, `get_node_skill`, `start_film_director`, `start_video_director` ו-`get_recipe` מחזירים הוראות במקום מדיה. הם חינם ולא משנים שום דבר בחשבון שלכם.

## התחברות והרשאות
השרת משתמש בזרימת authorization code של OAuth 2.0 עם PKCE. בפעם הראשונה שאתם מחברים את הלקוח, הלקוח שלכם נרשם אצל Nodaro ושולח אתכם למסך ההסכמה.

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

### הרשאות (scopes)
כל כלי צריך הרשאה אחת או יותר. כלי שלא אישרתם את ההרשאות שלו נשמט מרשימת הכלים לגמרי: הוא לא יופיע כדי להיכשל אחר כך.

| הרשאה | מה היא מאפשרת |
| --- | --- |
| `workflows:read` | קריאת הפרויקטים, התהליכים, הרכיבים השמורים והפקות ה-Studio שלכם |
| `workflows:write` | יצירה, שינוי, ייבוא ומחיקה של תהליכים בפרויקט mcp, ויצירה ועריכה של הפקות |
| `workflows:execute` | הרצת תהליכים, אפליקציות ורכיבים, ושימוש בכל כלי יצירה |
| `jobs:read` | קריאת המשימות וההרצות שלכם, המתנה למשימה ואבחון של כישלון |
| `assets:read` | עיון בגלריה, בהעלאות ובמועדפים שלכם, וקריאת הדמויות, המיקומים, האובייקטים והיצורים שלכם |
| `assets:write` | העלאת קבצים, יצירה ועדכון של דמויות ומיקומים, אישור תמונות וסימון מועדפים |
| `credits:read` | קריאת יתרת הקרדיטים והיסטוריית הרכישות שלכם |
| `apps:read` | רשימת האפליקציות שפורסמו וקריאת הקלטים שלהן |
| `presets:read` | רשימה וקריאה של ערכות שמורות |
| `pipelines:read`, `pipelines:execute`, `pipelines:approve` | קריאה, הרצה ואישור של פייפליינים של **סיפור ← וידאו** |
| `workspaces:read`, `workspaces:write` | רשימת סביבות העבודה שלכם ובחירת הסביבה שהסשן עובד בה |

כמה כלים לא צריכים הרשאה ותמיד גלויים, כמו `ping`, `list_models` וכלי המדריכים. [מדריך כלי ה-MCP](https://nodaro.ai/docs/mcp/tools) מפרט את ההרשאה של כל כלי.

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

## כמה זה עולה
- **החיבור לא עולה כלום.** אין תוכנית נפרדת ל-MCP.
- **כלי היצירה מוציאים קרדיטים** מחשבון ה-Nodaro שלכם, באותם מחירים כמו בעורך וב-API. [קרדיטים](https://nodaro.ai/docs/concepts/credits) מסביר איך המחירים עובדים, וכל דף מודל מציג את המחיר שלו.
- **כלי הגילוי והמדריכים חינם**, למשל `list_models`, `get_node_skill`, `list_shot_shapes` ו-`get_recipe`.
- **על יצירה שנכשלה מקבלים החזר.** קרדיטים ששוריינו למשימה שנכשלה חוזרים אוטומטית. החריג הוא כישלון בפוסט־עיבוד אחרי שהמודל כבר מסר את התוצאה שלו.
- **כמה כלים נותנים אומדן לפני שהם מוציאים.** הכלי `start_recast` בלי `confirm`, הכלי `plan_studio_export` וכלי ה-Studio עם `dry_run: true` מחזירים מחיר ולא מתחילים כלום.
- **ניסיונות חוזרים בטוחים עם אסימון ניסיון חוזר.** הכלים `run_workflow`, `run_app`, `run_component` וכמה כלי הפקה מקבלים `client_request_id`. שלחו את אותו ערך שוב אחרי פסק זמן, ו-Nodaro לא מתחיל את ההרצה ולא מחייב אותה פעמיים.

ב-Nodaro Cloud, `check_balance` מחזיר את היתרה שלכם ו-`credit_transactions` מציג את הרכישות וההוצאות שלכם.

## לאן התוצאות מגיעות
- **הספרייה שלכם.** כל תוצאה נשמרת בספרייה שלכם ב-Nodaro, בדיוק כמו הרצה מהעורך.
- **כרטיסי משימה.** בלקוחות שמציגים MCP Apps, כמו Claude בדפדפן, יצירה מציגה כרטיס עם התקדמות בזמן אמת ואחר כך את התוצאה. לקוחות אחרים בודקים את המשימה עם `get_job` או `wait_for_job`.
- **הפרויקט mcp.** תהליכים שהעוזר יוצר נשמרים בפרויקט בשם **mcp**, ש-Nodaro יוצר בשימוש הראשון. לוח הבקרה מציג אותם תחת **תהליכי MCP**. העוזר יכול לראות את השמות של כל הפרויקטים שלכם, אבל הוא עורך ומריץ רק את התהליכים שבפרויקט mcp.
- **רשימת ההרצות.** הרצה שעוזר התחיל נושאת תג **דרך MCP**, או את שם הלקוח כש-Nodaro מזהה אותו, למשל **דרך Claude**.
- **שיחות MCP.** כל שיחה עם עוזר הופכת גם לתהליך שאפשר לפתוח, לשנות ולהריץ שוב. הלשונית **שיחות MCP** בדף הבית מציגה אותן לפי חודש. ראו את הדף [שיחות MCP](https://nodaro.ai/docs/mcp/conversation-flows).
- **פעולות אחרונות דרך MCP.** מתחת לתהליכים בלשונית **תהליכי MCP** בדף הבית, הרשימה **פעולות אחרונות דרך MCP** מציגה את התמונות, הסרטונים וקטעי האודיו הבודדים שעוזר יצר מחוץ לכל תהליך. החדשים ביותר מופיעים ראשונים, וכל כרטיס מציין את הלקוח שיצר אותו, למשל **דרך Claude**. **הצגת עוד** טוענת פריטים ישנים יותר, ולחיצה על כרטיס פותחת את התוצאה.

אותה רשימה זמינה גם מקוד: הנתיב `GET /v1/jobs?source=mcp` ב-REST API, המתודה `client.jobs.list({ source: "mcp" })` ב-SDK, הכלי `list_jobs` עם `sources: ["mcp"]` דרך MCP והפקודה `nodaro jobs list --source mcp` ב-CLI.

## דף ה-MCP באתר nodaro.ai
[nodaro.ai/mcp](/mcp) הוא הדרך המהירה לחבר עוזר. יש בו כפתור **חיבור ל-Claude**, שדה שמעתיק את כתובת השרת, ולשונית עם שלושה שלבים קצרים לכל לקוח. התיעוד הזה מוסיף את השלבים המלאים לכל לקוח, את מדריך הכלים המלא ומדריכים לבמאים ולפייפליינים.

## Nodaro Cloud והתקנות באירוח עצמי
Nodaro Cloud מריץ את שרת ה-MCP ב-`mcp.nodaro.ai` לכל חשבון.

התקנות Community ו-Business באירוח עצמי כוללות את אותו שרת, כבוי כברירת מחדל. מנהל השרת מפעיל אותו ונותן לו כתובת משלו; ראו את הדף [MCP בהתקנה באירוח עצמי](https://nodaro.ai/docs/self-hosting/mcp). חברו את הלקוח שלכם לכתובת הזאת במקום ל-`mcp.nodaro.ai`.

כמה כלים קיימים רק ב-Nodaro Cloud, למשל כלי הפקות ה-Studio וה-Recast, `create_explainer`, `plan_edit` וכלי הקרדיטים. בהתקנות אחרות הכלים האלה חסרים או מחזירים `not_available`.

## השלבים הבאים
  - [חיבור לקוח](https://nodaro.ai/docs/mcp/connect): הגדרה שלב אחר שלב ל-Claude, ChatGPT, VS Code, Cursor, Cline, Continue, Goose וללקוח משלכם.
  - [יצירה עם העוזר שלכם](https://nodaro.ai/docs/mcp/create): דוגמאות אמיתיות ל-Claude, ChatGPT, Cursor ו-VS Code, עם כל כלי, מודל, זמן ומחיר.
  - [מדריך הכלים](https://nodaro.ai/docs/mcp/tools): כל כלי, הפרמטרים שלו, ההרשאה שלו והמחיר שלו.
  - [במאי קולנוע](https://nodaro.ai/docs/mcp/film-director): תארו סרט וצפו בעוזר בונה אותו על הקנבס שלכם.
  - [פתרון בעיות](https://nodaro.ai/docs/mcp/troubleshooting): תיקון שגיאות התחברות, כלים חסרים ומשימות שנכשלו.

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

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

הכתובת היא https://mcp.nodaro.ai/mcp, והיא זהה לכל לקוח. הלקוחות מחוברים על גבי Streamable HTTP ומזדהים עם OAuth, ולכן לעולם לא תצטרכו להדביק מפתח API.

### האם שימוש ב-Nodaro דרך עוזר AI עולה יותר?

לא. החיבור לא עולה כלום. כלים שיוצרים מדיה מוציאים קרדיטים מחשבון ה-Nodaro שלכם באותם מחירים כמו בעורך, וכלי הגילוי והמדריכים לא עולים כלום.

### אילו עוזרי AI אפשר לחבר ל-Nodaro?

Claude, ChatGPT ב-Developer mode (מצב מפתחים), VS Code, Cursor, Cline, Continue, Goose ולקוחות אחרים שתומכים בשרתי MCP מרוחקים על גבי Streamable HTTP עם התחברות OAuth.

### למה העוזר שלי לא רואה חלק מהכלים של Nodaro?

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

### האם אפשר להשתמש ב-MCP עם התקנת Nodaro באירוח עצמי?

כן, אם מנהל השרת הפעיל את שרת ה-MCP במופע הזה. העוזר שלכם מחובר אז לכתובת ה-MCP של המופע עצמו במקום ל-mcp.nodaro.ai.