חיבור לקוח AI דרך MCP
מוסיפים את Xuda כשרת MCP מרוחק ל-Claude, ל-Cursor או לכל לקוח אחר שמכיר MCP.
הדף הזה עוסק בצד הלקוח: איך מביאים את Claude, את Cursor או כל דבר אחר שמדבר MCP לדבר עם חשבון Xuda שלכם. לפרוטוקול עצמו, שמות כלים, מחזור חיים של סשן ומבנה שגיאות, ראו MCP.
מה צריך
דבר אחד: מפתח API. יוצרים אחד מאזור המפתחים של החשבון (גישה מלאה מגיעה לכל מה שבעל המפתח יכול, גישה מותאמת מגיעה רק לקבוצה מותרת של שיטות), ראו אימות. אין אישור MCP נפרד, אותו מפתח עובד דרך REST רגיל ב-/cpi/<method> ודרך MCP.
כל מפתח API של חשבון, וכל מפתח שמונפק אוטומטית לתיבת Full Stack VPS, מצביעים על אותה כתובת: https://xuda.ai/mcp. מפתח של Full Stack VPS חושף בנוסף את כלי התוספים המותקנים בתיבה לצד שיטות המערכת, ראו Full Stack VPS.
מחברים לקוח
Cursor קורא את הקטע שלו מ-.cursor/mcp.json (פרויקט) או מהגדרות ה-MCP הגלובליות שלו. Claude Desktop ו-claude.ai מוסיפים שרת מרוחק מ-הגדרות, תחת חיבורים: שם, כתובת ה-URL, ואותה כותרת Authorization. כל לקוח MCP אחר צריך רק את אותן שתי עובדות: נקודת קצה HTTP מסוג streamable ב-https://xuda.ai/mcp, והמפתח בכל בקשה כ-Authorization: Bearer YOUR_API_KEY.
בעמוד מפתחים, מפתחות API של כל חשבון יש כרטיס חיבור מתחת לרשימת המפתחות. בורר הפורמט שלו מחליף בלוק אחד בין .env, Next.js, MCP, cURL, Node.js ו-PHP, וכל אחד כבר מלא בנקודת הקצה ובמפתח הראשון ברשימה, שהכותרת של הבלוק נוקבת בשמו. פורמט .env נושא את XUDA_MCP_URL לצד בסיס ה-REST והמפתח, ופורמט MCP הוא פקודת Claude Code שלמעלה. המפתח מוצג מוסתר עד שחושפים אותו; העתקה תמיד לוקחת את הערך האמיתי.
מה הסוכן מקבל בחיבור
הבקשה הראשונה בחיבור חדש היא קריאת MCP מסוג initialize. התשובה של Xuda נושאת שדה instructions שנבנה ממדריך ה-LLM של Studio, אותו מודל מסמך של תוכנית, מדריך מאפייני xu-* וכללי תהליך עבודה שמכוסים בדף ההוא, ממוזגים מהרישומים החיים של הפלטפורמה עצמה כך שהוא לעולם לא יתאר כלל שהמאמת שנפרס לא אוכף בפועל. רוב לקוחות ה-MCP מעבירים את instructions ישר להקשר של המודל, ולכן הסוכן כבר יודע איך תוכנית Studio מורכבת לפני הקריאה הראשונה שלו לכלי, בלי תדרוך נפרד.
שני כלים כדאי לקרוא להם ישירות ולא להסתמך על מה שהגיע בזמן החיבור: get_studio_guide קורא מחדש כל נושא לפי דרישה (components, tables, programs, javascript, attributes, anatomy, gotchas), ו-get_prog_examples מחזיר תוכניות דוגמה עובדות ונבחרות כדי לבנות על פי הדפוס שלהן.
נקודת קצה ייעודית לתוכנית API אחת
השיטות שלמעלה הן הקטלוג של כל החשבון מאחורי מפתח אחד. כשרוצים שמערכת חיצונית תגיע בדיוק לנקודת קצה אחת של פרויקט אחד, פורסים אותה: פריסה > פריסות > שרת מציגה שרת MCP לצד Cron, Api, Node ו-Emitter. השלב הגדרות הפעלה שלו בוחר אחת מתוכניות ה-api של הפרויקט עצמו כיעד, ואז השלבים הרגילים של מרכז הנתונים, רמת הביצועים והשם מעלים אותה כנקודת קצה משלה. ראו הפריסה הראשונה שלכם לחלקים המשותפים של האשף הזה, ו-API למה שתוכנית api היא.
mcp רשום היום בין סוגי הפריסה בטא של הפלטפורמה, לצד router, android ו-emitter.