Skip to Content
Referenceשילוב MCP

שילוב MCP

OpenFactory תומך ב-Model Context Protocol  כך שעוזרים בינה מלאכותית יכולים לעזור לך ליצור מבנים, לבדוק מתכונים, לנהל מחשבי VM ולסקור את תוצאות הבדיקה.

השתמש ב-MCP כאשר אתה רוצה לעבוד עם OpenFactory מ-Claude, Cursor, Claude Code, OpenAI Codex, או לקוח אחר תואם MCP מבלי לעבור הלוך ושוב בין כלים.

דרישות

  • לקוח MCP התומך בשרתי MCP מרוחקים
  • לגישה מגובת חשבון, היכנס ל-OpenFactory בדפדפן זה
  • לגישת אורח, השתמש באסימון האורח שנוצר המוצג להלן

מפתחות API של חשבון מוצגים פעם אחת בעת יצירתם וניתן לבטלם מהמסוף. אסימוני אורח הם מזהי דפדפן עבור גישה מדודה; הם לא סודות חשבון.

נקודות קצה

תחבורהכתובת אתרהשתמש
HTTP ניתן להזרמהhttps://console.openfactory.tech/mcp-stream/mcpנקודת הקצה של OpenFactory MCP

HTTP ניתן להזרמה הוא התחבורה הנתמכת היחידה. נקודות הקצה הישנות של HTTP+SSE (/mcp/sse, /mcp/messages) הוצאו משימוש וכעת חוזרות 410 Gone; הפנה כל לקוח שעדיין משתמש בהם לכתובת ה-HTTP הניתן להזרמה למעלה, עם אותה כותרת Authorization. Claude Code, Claude Desktop, Cursor, Codex ו-OpenCode כולם תומכים ב-HTTP ניתן להזרמה.

העתק-הדבק תצורה

Preparing your MCP config...

הפעל מחדש את Claude Desktop, Cursor, OpenAI Codex, או כל לקוח MCP ארוך טווח אחר לאחר שינוי הגדרות ה-MCP שלו. OpenAI Codex קורא שרתי MCP מ- ~/.codex/config.toml ומתחבר ישירות ל-HTTP ניתן להזרים: אין צורך בגשר mcp-remote. מחברים מותאמים אישית של Claude.ai עשויים לבקש את כתובת האתר והכותרת של השרת כשדות נפרדים.

יכולות זמינות

OpenFactory חושפת כלים מול לקוחות עבור:

קטגוריהדוגמאות
בונהרשימת בנייה, צור בנייה מתכונים, בדוק סטטוס בנייה, נסה שוב בנייה שנכשלה
מתכוניםעיין בתבניות, אימות מתכונים, התאם אישית תבניות
תמונותקבל קישורים להורדה עבור חפצים שהושלמו
VMsרשום מכשירי VM, צור VMs לניסיון, הפעל או עצירה של VMs, פתח קישורי מסוף
מבחניםהפעל אימות, רשום ריצות בדיקה, בדוק תוצאות בדיקה, ניהול חבילות בדיקה לשימוש חוזר
בדיקת ממשק משתמש של אפליקציההסע ב-VM בודק כדי לבדוק את any app URL: תרחישי GUI הניתנים לשימוש חוזר, מתקשים מעצמם. אין צורך בפריסה
פריסת אפליקציהפרוס ריפו של Git באפליקציית אינטרנט חיה עם כתובת אתר תצוגה מקדימה ציבורית (https://<slug>.apps.openfactory.tech)

זמינות הכלים עשויה להשתנות לפי הרשאות התוכנית והארגון.

סוויטות בדיקה לשימוש חוזר

ניתן ליצור חבילות בדיקה לפני שנבנה וריאנט או ISO. תגדיר אחד או יותר מקרי בדיקה, קביעות מותאמות אישית, בדיקות מוגדרות מראש ויעד ISO בשם חריצים כגון primary, client או server. כאשר הבניינים מוכנים, כרכו כל אחד מהם חריץ לבנייה הושלמה והפעל את הסוויטה.

כליהשתמש
create_test_suiteצור חבילה לשימוש חוזר ללא צורך בגרסה בנויה
list_test_suitesרשימת חבילות הזמינות למשתמש MCP הנוכחי
get_test_suiteהצג את הגדרת החבילה והיסטוריית הריצה האחרונה
update_test_suite_targetsכריכת חריצי יעד עם שם ISO ל-builds שהושלמו
run_test_suiteהפעל חבילה נגד חריצי יעד ISO קשורים
list_test_suite_runsריצות רשימה שנוצרו מחבילה
get_test_suite_statusהצג את מוכנות הכתיבה ואת סטטוס ההרצה האחרון

בדיקת ממשק המשתמש של האפליקציה: כל כתובת אתר, ללא פריסה

בדוק את user interface of any web app על ידי הפניית VM בודק מנוהל לעבר a כתובת אתר. אתה לא פורס את האפליקציה שלך עם OpenFactory כדי לבדוק אותה. ה-VM הבוחן פותח שרת פיתוח מקומי, פריסת תצוגה מקדימה/פריסה של Vercel, AWS, Netlify, או כל מארח, או כל כתובת אתר ציבורית שניתן להגיע אליה מה-VM. האפליקציה שלך נשארת איפה זה כבר פועל. תרחישים כתובים בשפה פשוטה והם self-hardening: הריצה הראשונה לומד היכן נמצא כל רכיב ממשק משתמש, ומאוחר יותר מריץ שידור חוזר מהזיכרון הזה (דילוג המעבר הוויזואלי האיטי). זה הופך את השידורים החוזרים למהירים וגמישים לשינויים קטנים בממשק המשתמש. תמיכה בתרחישים environment variables (${VAR}) ו-2FA (${totp:VAR}, RFC 6238) עבור כניסה; סודות מועברים בזמן הריצה ולעולם לא מאוחסנים.

כליהשתמש
ensure_tester_vmקבל או צור בודק שולחן העבודה המתמיד שלך VM
create_app_scenarioשמור תרחיש GUI לשימוש חוזר עבור כתובת אתר של אפליקציה
run_app_scenarioהפעל אותו (העביר את סודות זמן הריצה כאן) והקלט צילומי מסך + פסק דין
list_app_scenarios / get_app_scenarioעיין בתרחישים ובמטמון המוקשה שלהם
start_app_test / record_app_test_step / finish_app_testסע והקלט ריצה אד-הוק בעצמך
annotate_screenshotצייר תיבות סימון מסומנות בצילום מסך

ראה בדיקת ממשק המשתמש של האפליקציה לקבלת זרימת העבודה המלאה, השלב סכימה, ודוגמאות 2FA.

פריסת אפליקציה: Git repo לכתובת URL ציבורית

פרוס אפליקציית אינטרנט ישירות ממאגר Git וקבל public preview URL (https://<slug>.apps.openfactory.tech) שתוכל לפתוח, לשתף או להצביע על בדיקה תרחיש ב. OpenFactory משבט את המאגר, מתקין תלות, מפעיל את האפליקציה, ובודק את זה בשבילך. אין מה להתחבר: אין העברת יציאות, מנהרות, או DNS.

זה משתלב עם בדיקת ממשק המשתמש של האפליקציה: פרוס את האפליקציה שלך ואז הרץ תרחיש נגדה תצוגה מקדימה של כתובת האתר, או דלג על הפריסה ובדוק אפליקציה שכבר מארחת (Vercel, AWS, …).

כליהשתמש
create_appרשום ריפו של Git כאפליקציה (שם, מקור, שבלול)
deploy_appפרוס את האפליקציה והחזר את כתובת האתר של התצוגה המקדימה הציבורית שלה
list_apps / get_appעיין באפליקציות שלך, בכתובות האתרים שלהן ופריסה היסטוריית
iterate_appשלח שינוי בשפה טבעית לאפליקציה; סוכן מיישם אותו ופורס מחדש
get_app_build_statusסקר את סטטוס הפריסה של אפליקציה וכרטיסי החלפה בטיסה

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

הנחיות לדוגמה

Show my most recent OpenFactory builds and summarize any failures.
Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.
Validate this recipe before I start a build.
Start a VM from my latest completed build and give me the console link.
Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.
Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.

הערות אבטחה

  • השתמש במפתחות API רק עם לקוחות שאתה סומך עליהם.
  • שלל מפתחות ישנים מהקונסולה כאשר אתה מסובב מכונות או עוזב פרויקט.
  • העדיפו הרשאות כלי הנדרשות לאישור עבור פעולות שיוצרות בנייה, הפעלת מחשבי VM או שינוי תשתית.
  • אל תדביק מפתחות API של OpenFactory בהודעות, כרטיסים, מאגרים ציבוריים או מסמכים משותפים.

פתרון בעיות

כלים אינם מופיעים

הפעל מחדש את לקוח ה-MCP שלך ואשר שכתובת האתר של השרת היא בדיוק:

https://console.openfactory.tech/mcp-stream/mcp

אם הלקוח שלך מוגדר עם כתובת האתר /mcp/sse שיצאה משימוש, הוא יקבל א 410 Gone: שנה את כתובת האתר לזו שלמעלה; שום דבר אחר לא צריך להשתנות.

האימות נכשל

רענן דף זה והעתק שוב את התצורה שנוצרה. משתמשים מחוברים צריכים להשתמש בכותרת Authorization שנוצרה. משתמשים אורחים צריכים להשתמש בכותרת X-Guest-Id שנוצרה מתצורת העתק-הדבק שלמעלה.

פעולות בנייה או VM נכשלו

בדוק את תוכנית OpenFactory שלך, הרשאות הארגון וסטטוס הבנייה. חלק מהפעולות דורשות בנייה שהושלמה, זכאות VM מתמשכת או הרשאות Enterprise.

שגיאות תחבורה

עדכן את לקוח ה-MCP שלך אם הוא אינו תומך ב-HTTP ניתן להזרמה. אם אינך יכול לעדכן אותו, עבור לנקודת הקצה של תאימות HTTP+SSE.