תיעוד Nodaroלקוח משלכם
חברו כל לקוח MCP ל-Nodaro על גבי Streamable HTTP: גילוי שרת ה-OAuth, רישום הלקוח או יישום מפתחים, והתחברות עם PKCE.
אפשר לחבר ל-Nodaro לקוח משלכם, אם הוא מדבר MCP סטנדרטי על גבי Streamable HTTP ומזדהה עם OAuth. כוונו אותו ל-https://mcp.nodaro.ai/mcp, תנו לו לגלות את שרת ה-OAuth, רשמו אותו והעבירו את המשתמש דרך מסך ההסכמה. הדף הזה מפרט את נקודות הקצה, את כללי הרישום ואת תוקף האסימונים.
מה הלקוח שלכם צריך
- MCP על גבי Streamable HTTP בכתובת
https://mcp.nodaro.ai/mcp. - זרימת authorization code של OAuth 2.0 עם PKCE. השרת מקבל רק את
S256כשיטת ה-code challenge. - גילוי OAuth דרך המטא־דאטה של המשאב המוגן (RFC 9728) והמטא־דאטה של שרת ההרשאות (RFC 8414).
- רישום לקוח, דרך Dynamic Client Registration (RFC 7591) או כיישום מפתחים שרושמים פעם אחת.
נקודות קצה
| מה | איפה |
|---|---|
| נקודת הקצה של MCP | https://mcp.nodaro.ai/mcp |
| המטא־דאטה של המשאב המוגן | https://mcp.nodaro.ai/.well-known/oauth-protected-resource |
| המטא־דאטה של שרת ההרשאות | https://app.nodaro.ai/.well-known/oauth-authorization-server |
| Dynamic Client Registration | POST https://app.nodaro.ai/v1/oauth/register |
| החלפת קוד באסימון | POST https://app.nodaro.ai/v1/oauth/token |
| ביטול אסימונים | POST https://app.nodaro.ai/v1/oauth/revoke |
שני מסמכי המטא־דאטה זמינים בשני המארחים, app.nodaro.ai ו-mcp.nodaro.ai. כל אחד מהם זמין גם עם הסיומת /mcp, למשל /.well-known/oauth-protected-resource/mcp, כי חלק מהלקוחות בודקים קודם את הצורה הזאת. מסמך המטא־דאטה של שרת ההרשאות מפרסם את נקודות הקצה של ההרשאה, של האסימונים, של הרישום ושל הביטול, את סוג התגובה code, את ה-grant authorization_code, את PKCE עם S256, את שיטת האימות client_secret_post ואת ההרשאות הנתמכות.
זרימת החיבור
גילוי שרת ההרשאות
קבלו את המטא־דאטה של המשאב המוגן ממארח ה-MCP. המסמך משייך את המשאב https://mcp.nodaro.ai/mcp לשרת ההרשאות שלו, https://app.nodaro.ai. אחר כך קבלו את המטא־דאטה של שרת ההרשאות כדי לקבל את נקודות הקצה.
רישום הלקוח
שלחו את ה-client_name ואת כתובות ההפניה שלכם לנקודת הקצה של הרישום. Nodaro מחזיר client_id שמתחיל ב-ndr_dcr_ ו-client_secret. נקודת הקצה מקבלת עד 10 בקשות לדקה מכתובת IP אחת.
הפניית המשתמש למסך ההסכמה
פתחו בדפדפן את נקודת הקצה של ההרשאה עם ה-client_id שלכם, redirect_uri, response_type=code, רשימת ה-scope, ערך state אקראי ו-code_challenge של PKCE עם code_challenge_method=S256. המשתמש מתחבר, עובר על ההרשאות ולוחץ על אישור.
החלפת הקוד
Nodaro מפנה ל-redirect_uri שלכם עם code ועם ה-state שלכם. בדקו את ה-state, ואז החליפו את הקוד באסימון בנקודת הקצה של האסימונים, עם ה-code_verifier שלכם. קוד עובד פעם אחת בלבד, ותוקפו פג 10 דקות אחרי שהונפק.
קריאה לנקודת הקצה של MCP
שלחו את אסימון הגישה, שמתחיל ב-ndr_app_, בכותרת Authorization: Bearer <token> בכל בקשה ל-https://mcp.nodaro.ai/mcp. קבלו את רשימת הכלים עם tools/list.
אילו שמות לקוח יכולים להירשם
כברירת מחדל, Dynamic Client Registration מקבל רק שמות לקוח מוכרים: Claude, Claude Code, Cursor, Cline, Continue, Goose, ChatGPT, OpenAI, Lovable, Gemini, Gemini CLI, Codex, MCP Inspector ו-mcp-inspector. לקוח עם שם אחר מקבל 403 client_not_allowed.
אם ללקוח שלכם יש שם אחר, רשמו אותו במקום זאת פעם אחת כיישום מפתחים:
- פתחו את app.nodaro.ai/settings/developer-apps ולחצו על יצירת יישום.
- הזינו את השם, את כתובות ההפניה ואת ההרשאות שהלקוח רשאי לבקש.
- העתיקו את ה-
client_idואת ה-client_secret. הסוד מוצג פעם אחת בלבד. התוקף שלו לא פג, ואפשר להחליף אותו בסוד חדש בדף של היישום.
כל חשבון יכול לרשום ידנית עד 5 יישומי מפתחים. לקוחות שנרשמו בעצמם מופיעים באותה רשימה, אבל לא נספרים במגבלה הזאת.
במופע Nodaro משלכם, מנהל השרת שולט ברישום בעזרת MCP_DYNAMIC_REGISTRATION (allowlist, ברירת המחדל, open או off) ו-MCP_DCR_ALLOWLIST. במצב open, לכל צמד של שם לקוח וכתובת הפניה יכולים להיות לכל היותר 5 רישומים שלא נעשה בהם שימוש בתוך 24 שעות; בקשות רישום נוספות נדחות עם 429 too_many_open_registrations. במצב off, הרישום נדחה עם 403 dcr_disabled. ראו את הדף MCP בהתקנה באירוח עצמי.
אסימונים
- תוקף. אסימון גישה תקף ל-90 ימים. אין אסימוני רענון: כשקריאה מחזירה
401, העבירו את המשתמש שוב דרך מסך ההסכמה. - ביטול. הלקוח שלכם יכול לבטל אסימון בנקודת הקצה של הביטול, שתמיד מחזירה
200. גם המשתמש יכול לבטל את הגישה של הלקוח שלכם תחת הגדרות › אפליקציות מחוברות, בכתובת app.nodaro.ai/settings/connected-apps. הביטול פוסל מיד את כל האסימונים שהונפקו ללקוח עבור אותו משתמש, והקריאה הבאה שלכם מחזירה401. - מסך ההסכמה. לקוח שנרשם באופן דינמי בחר את השם שלו בעצמו, ולכן מסך ההסכמה מזהיר את המשתמש ש-Nodaro לא אימת את השם.
אותו שרת OAuth משרת גם את ה-REST API. הדף OAuth למפתחים מתאר אותו במלואו.
טיפול בתוצאות של כלים
- משימות. כלי יצירה מתחילים משימה ומחזירים מיד את המזהה שלה. בדקו את הסטטוס עם
get_jobכל 5–10 שניות, או קראו ל-wait_for_job, עד שהמשימה במצבcompletedאוfailed. ראו את הדף כלי משימות. - תוכן מובנה. כלים רבים מחזירים את הנתונים שלהם ב-
structuredContentלצד תשובת הטקסט, למשל את מעטפת המשימה שלget_job. בקוד, השתמשו בנתונים המובנים. - הכרטיסים אופציונליים. מארחים שמציגים MCP Apps מקבלים כרטיסים אינטראקטיביים, כמו התקדמות משימה וחלונות העלאה. לקוח בלי MCP Apps מקבל את אותן תוצאות כטקסט וכנתונים מובנים.
- ה-API
tasks. לקוח שתומך ב-APItasksשל MCP מקבל דרכו את התקדמות המשימה. - כלים חסרים. כלי שהמשתמש לא אישר את ההרשאה שלו לא נכלל ב-
tools/list. לפני שמחפשים כלי חסר, בדקו אילו הרשאות אושרו.
טעויות נפוצות
- שימוש ב-
https://app.nodaro.ai/mcp. הכתובת הזאת היא דף אינטרנט. בקשתPOSTאליה מחזירה405עם קוד השגיאהwrong_mcp_host, שמציין את הכתובת הנכונה. - שימוש ב-
https://api.nodaro.ai/mcp. הדומיין הזה לא קיים. - הוספת לוכסן בסוף. השתמשו בדיוק ב-
https://mcp.nodaro.ai/mcp.
מקורות
שאלות נפוצות
באיזו תעבורה משתמש שרת ה-MCP של Nodaro?
שרת ה-MCP של Nodaro משתמש ב-Streamable HTTP, בכתובת https://mcp.nodaro.ai/mcp. ההתחברות נעשית עם OAuth 2.0 ו-PKCE, ולקוח יכול לרשום את עצמו בעזרת Dynamic Client Registration.
למה הרישום נכשל עם client_not_allowed?
רישום דינמי מקבל רק שמות לקוח מוכרים, והשם של הלקוח שלכם לא ברשימה. במקום זאת, רשמו יישום מפתחים בהגדרות ה-Nodaro שלכם, והשתמשו במזהה הלקוח ובסוד שלו.
כמה זמן תקף אסימון גישה משרת ה-MCP של Nodaro?
אסימון גישה משרת ה-MCP של Nodaro תקף ל-90 ימים. אין אסימוני רענון, ולכן אחרי 90 ימים המשתמש מתחבר שוב. הלקוח שלכם יכול לבטל אסימון לפני כן, והמשתמש יכול לבטל את הגישה של הלקוח בדף הגדרות › אפליקציות מחוברות.
האם אפשר לבדוק את שרת ה-MCP של Nodaro עם MCP Inspector?
כן. MCP Inspector הוא אחד משמות הלקוח שיכולים להירשם באופן דינמי, ולכן אפשר לחבר אותו, והוא יכול להזדהות ולהציג את רשימת הכלים.
דפים קשורים
חיבור לקוח
אפליקציות OAuth
מדריך כלי ה-MCP
MCP בהתקנה באירוח עצמי
פתרון בעיות
עודכן לאחרונה